lmnr

Laminar은 AI 에이전트를 위해 특별히 구축된 오픈소스 관측성 플랫폼입니다. Y Combinator S24 출신의 Laminar AI가 개발했으며, 관리형 클라우드 서비스 또는 자체 호스팅 방식으로 사용할 수 있습니다. README에 설명된 핵심 기능은 다음과 같습니다: - 추적: OpenTelemetry 네이티브 추적 SDK로, Vercel AI SDK, Browser Use, Stagehand, LangChain, OpenAI, Anthropic, Gemini와 같은 프레임워크와 제공자를 한 줄의 코드로 자동 계측할 수 있습니다. TypeScript(npm @lmnr-ai/lmnr) 및 Python(PyPI lmnr)용 클라이언트 라이브러리가 있습니다. - 신호: 사용자가 에이전트 동작을 평문 영어로 설명하면(예: 에이전트가 루프에 빠짐), Laminar이 에이전트 실행을 평가하고 해당 동작이 발생할 때 Slack 알림을 보냅니다. - 평가: 로컬 또는 CI/CD 파이프라인에서 평가를 실행하기 위한 확장 가능한 SDK 및 CLI, 그리고 결과를 시각화하고 비교할 수 있는 UI를 제공합니다. - MCP 및 CLI 접근: 코딩 에이전트가 SQL로 추적, 스팬, 메트릭, 이벤트를 쿼리하고, 추적 데이터를 기반으로 문제를 조사하거나 디버깅할 수 있습니다. - 대시보드: 사용자 지정 SQL 쿼리를 지원하는 추적, 메트릭, 이벤트용 대시보드 빌더입니다. - 데이터 주석 및 데이터셋: 평가에 사용되는 주석 및 데이터셋 생성을 위한 사용자 지정 데이터 렌더링 UI입니다. 성능 및 아키텍처 참고 사항: 플랫폼은 Rust로 작성되었으며, 수집 및 저장 시 20배 추적 압축을 제공하고, 실시간으로 추적을 볼 수 있는 사용자 지정 실시간 엔진, 스팬 데이터에 대한 전체 텍스트 검색, 추적 데이터용 gRPC 내보내기를 포함합니다. 자체 호스팅: 가장 빠른 로컬 설정은 저장소를 클론하고 `docker compose up -d`를 실행하는 것이며, http://localhost:5667에서 접근 가능한 가볍지만 완전한 기능을 갖춘 스택이 시작됩니다. 프로덕션용 compose 파일(docker-compose-full.yml)도 제공됩니다. README에는 ClickHouse 컨테이너 재생성 및 비활성화된 시스템 로그 테이블을 잘라내어 디스크 공간을 확보하는 방법을 포함한 기존 설치 업그레이드 방법이 문서화되어 있습니다. 구성: 선택적 LLM 제공자 설정은 Gemini, OpenAI(또는 LiteLLM, OpenRouter, vLLM과 같은 OpenAI 호환 게이트웨이), AWS Bedrock, Azure AI Foundry를 지원하며, 선택적 모델 크기 재정의 및 정적 헤더를 포함합니다. 공유 데이터베이스 배포를 위해 POSTGRES_SCHEMA를 통해 사용자 지정 Postgres 스키마를 구성할 수 있습니다. 자체 호스팅 배포는 익명 사용량 원격 측정을 수집하며, LAMINAR_TELEMETRY_DISABLED=true로 비활성화할 수 있습니다. TypeScript(Laminar.initialize 및 observe 래퍼)와 Python(Laminar.initialize 및 @observe 데코레이터) 모두에 대한 빠른 시작 예제가 제공되어 LLM 호출 및 함수 입력/출력을 추적합니다.