Laminar는 AI 에이전트를 위해 특별히 설계된 오픈 소스 관측 가능성(observability) 플랫폼입니다.

• 추적(Tracing). 문서
  • OpenTelemetry 네이티브의 강력한 추적 SDK를 제공합니다. Vercel AI SDK, 브라우저 사용(Browser Use), Stagehand, LangChain, OpenAI, Anthropic, Gemini 등에서 단 한 줄의 코드로 자동 추적이 가능합니다.
• 평가(Evals). 문서
  • 로컬 또는 CI/CD 파이프라인에서 평가를 실행하기 위한 비제한적이고 확장 가능한 SDK 및 CLI를 제공합니다.
  • 평가를 시각화하고 결과를 비교할 수 있는 UI를 갖추고 있습니다.
• AI 모니터링(AI monitoring). 문서
  • 자연어 설명으로 이벤트를 정의하여 에이전트의 문제점, 논리적 오류 및 사용자 지정 동작을 추적할 수 있습니다.
• 모든 데이터에 대한 SQL 접근. 문서
  • 내장된 SQL 편집기를 사용하여 트레이스(traces), 메트릭(metrics), 이벤트를 쿼리할 수 있으며, 쿼리를 통해 대규모 데이터셋을 생성할 수 있습니다. API를 통해 이용 가능합니다.
• 대시보드(Dashboards). 문서
  • 사용자 지정 SQL 쿼리 지원과 함께 트레이스, 메트릭, 이벤트를 위한 강력한 대시보드 빌더를 제공합니다.
• 데이터 주석 및 데이터셋(Data annotation & Datasets). 문서
  • 빠른 데이터 주석 작업 및 평가용 데이터셋 생성을 위한 사용자 지정 데이터 렌더링 UI를 제공합니다.

주요 기능:

• 극도로 높은 성능.
• Rust 🦀로 작성됨.
• 실시간으로 트레이스를 볼 수 있는 맞춤형 엔진.
• 스팬(span) 데이터에 대한 초고속 전체 텍스트 검색.
• 추적 데이터를 위한 gRPC 익스포터.

전체 문서는 docs.laminar.sh에서 확인하세요.
가장 빠르고 쉽게 시작하는 방법은 관리형 플랫폼을 이용하는 것입니다 -> laminar.sh

Laminar 자체 호스팅(Self-Hosting Laminar)

Laminar는 로컬에 자체 호스팅하기 매우 쉽습니다. 빠른 시작을 위해 저장소를 클론하고 docker compose로 서비스를 시작하세요:

git clone https://github.com/lmnr-ai/lmnr
dcd lmnr
docker compose up -d

이렇게 하면 가볍지만 기능이 풍부한 스택 버전이 구동됩니다. 이는 빠른 시작이나 경량 사용에 적합합니다. 브라우저에서 http://localhost:5667로 접속할 수 있습니다.

또한, SDK를 구성할 때 baseUrl과 올바른 포트를 설정해야 합니다. 자체 호스팅 가이드를 참조하세요.

프로덕션 환경의 경우, 관리형 플랫폼을 사용하거나 docker compose -f docker-compose-full.yml up -d를 사용하는 것을 권장합니다.

자체 호스팅 모드에서 Signals / AI 모니터링을 활성화하려면 .env 파일에 GOOGLE_GENERATIVE_AI_API_KEY 환경 변수를 설정해야 합니다. 이 키는 앱 서버와 프론트엔드 모두에 필요합니다.

# repo 루트의 .env 파일에
GOOGLE_GENERATIVE_AI_API_KEY=your_key_here

Laminar를 로컬에서 실행하고 빌드하거나 docker compose 파일에 대해 더 많이 배우려면, Contributing 가이드라인을 따르세요.