메인 콘텐츠로 건너뛰기
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.
  4. 연결을 구성합니다:
    • Endpoint — 수집기의 OTLP 엔드포인트 (예: https://otel-collector.example.com:4317).
    • Service Name — 관측 가능성 플랫폼에서 이 서비스를 식별하기 위한 이름.
    • Custom Headers (선택 사항) — 인증 또는 라우팅 헤더를 키-값 쌍으로 추가합니다.
    • Certificate (선택 사항) — 수집기에서 TLS 인증서가 필요한 경우 제공합니다.
  5. Save를 클릭합니다.
OpenTelemetry 수집기 구성
여러 수집기를 추가할 수 있습니다 — 예를 들어, 트레이스용 하나와 로그용 하나를 추가하거나, 다른 목적을 위해 다른 백엔드로 전송할 수 있습니다.