Claude Platform의 에이전트 관측성

이제 Claude Managed Agents, Messages API, Claude SDK에서 OpenTelemetry(OTel) 트레이스를 원하는 OTel 도구로 보내 에이전트가 거치는 모든 단계를 추적할 수 있습니다. 이미 Claude Code나 Cowork의 트레이스를 관측성 도구로 수집하고 있다면, Claude Platform에서 만든 에이전트도 같은 곳에서 확인할 수 있습니다.

OpenTelemetry로 에이전트 추적하기

에이전트에 더 많은 권한을 맡기려면 먼저 모델 호출, 도구 사용, MCP 서버 호출을 추적해야 합니다. 트레이스를 검토하면서 에이전트가 안정적으로 동작한다고 확인되면 그때 권한 범위를 넓혀 보세요.

Claude Console에서 대상(destination)을 추가하면, 에이전트의 모든 턴과 모델 호출, 도구 사용이 지연 시간, 토큰, ID 정보와 함께 표준 OpenTelemetry 트레이스로 관측성 도구에 전달됩니다.

기존 관측성 도구와 그대로 연동

Claude 트레이스는 OpenTelemetry GenAI 시맨틱 컨벤션을 따르므로, Claude는 물론 다른 제공업체의 데이터도 같은 도구와 대시보드에서 함께 볼 수 있습니다.

• 기존 스택과 나란히 에이전트 디버깅. Grafana Cloud, Honeycomb, Sentry, Splunk에서는 에이전트 트레이스가 로그, 메트릭과 함께 표시되므로 느려지거나 실패한 단계가 어느 서비스에서 발생했는지 바로 파악할 수 있습니다.
• 프로덕션 데이터로 에이전트 개선. Arize AI, Braintrust, Datadog, Langfuse, LangSmith by LangChain, New Relic, PostHog를 사용하면 실제 트레이스를 평가(eval)로 전환하고, 품질 문제를 포착하며, 변경 사항이 실제로 도움이 됐는지 측정할 수 있습니다.
• 조직 전체의 사용량 추적. 트레이스를 Databricks Unity Gateway로 보내면 플랫폼 팀과 보안 팀이 팀별 토큰 사용량을 확인하고 이상 징후를 찾아낼 수 있습니다.

이 밖에도 표준 OTLP 엔드포인트를 지원하는 OpenTelemetry 도구라면 어디서든 Claude 트레이스를 사용할 수 있습니다.

시작하기

Claude Platform의 OpenTelemetry 트레이스는 퍼블릭 베타로 제공됩니다. Managed Agents와 Messages API는 Claude Console에서 대상을 추가해야 하며, Claude SDK는 트레이스를 자동으로 내보냅니다.

자세한 시작 방법은 문서를 참고하세요.