콘텐츠로 이동
CrewAI 문서

OpenTelemetry 내보내기

CrewAI AMP는 배포에서 OpenTelemetry 트레이스와 로그를 자체 수집기로 직접 내보낼 수 있습니다. 이를 통해 기존 관측 가능성 스택을 사용하여 에이전트 성능을 모니터링하고, LLM 호출을 추적하고, 문제를 디버깅할 수 있습니다.

텔레메트리 데이터는 OpenTelemetry GenAI 시맨틱 규칙과 추가적인 CrewAI 전용 속성을 따릅니다.

사전 요구 사항

섹션 제목: “사전 요구 사항”

CrewAI AMP 계정

조직에 활성 CrewAI AMP 계정이 있어야 합니다.

OpenTelemetry 수집기

OpenTelemetry 호환 수집기 엔드포인트가 필요합니다 (예: 자체 OTel Collector, Datadog, Grafana 또는 OTLP 호환 백엔드).

수집기 설정

섹션 제목: “수집기 설정”
  1. CrewAI AMP에서 Settings > OpenTelemetry Collectors로 이동합니다.
  2. Add Collector를 클릭합니다.
  3. 통합을 선택합니다:
    • OpenTelemetry Traces 및 OpenTelemetry Logs — OTLP 호환 수집기 또는 백엔드로 내보냅니다.
    • Datadog — 별도의 수집기나 Datadog Agent 없이 트레이스를 Datadog의 OTLP 인테이크로 직접 전송합니다.
  4. 연결을 구성합니다. 필드는 선택한 통합에 따라 달라집니다:
OpenTelemetry Traces / Logs

OpenTelemetry Traces와 OpenTelemetry Logs는 동일한 필드를 공유하는 별개의 통합입니다 — 내보내려는 신호에 맞는 것을 선택하세요.

  • Endpoint — 수집기의 OTLP 엔드포인트 (예: https://otel-collector.example.com:4317).
  • Service Name — 관측 가능성 플랫폼에서 이 서비스를 식별하기 위한 이름.
  • Custom Headers (선택 사항) — 인증 또는 라우팅 헤더를 키-값 쌍으로 추가합니다.
  • Certificate (선택 사항) — 수집기에서 TLS 인증서가 필요한 경우 제공합니다.
OpenTelemetry 수집기 구성
Datadog

Datadog 설정은 전용 Datadog 통합 가이드를 참조하세요 — Datadog Agent 경로(권장, 로그 볼륨에 더 저렴)와 Datadog의 OTLP 수집을 모두 다루며, 수집기 구성 단계를 완전히 설명합니다.

  1. (선택 사항) Test Connection을 클릭하여 제공한 자격 증명으로 CrewAI가 엔드포인트에 연결할 수 있는지 확인합니다.
  2. Save를 클릭합니다.