Claude API OpenTelemetry 내보내기(베타): Messages API·Managed Agents 호출을 내 관측 도구에서
무엇인가요
Messages API 요청, 도구 사용, Managed Agents 세션을 OpenTelemetry(관측 데이터를 주고받는 업계 표준) 스팬으로 내보내는 기능이에요. Claude Console에서 목적지를 추가하면 API 쪽 스팬이, Python·TypeScript·Go·Java 등 7개 언어 SDK에서 트레이서를 등록하면 SDK 쪽 스팬이 나와요. 기본값은 토큰 수·지연 시간 같은 메타데이터만 보내고 'Full content'를 켜면 프롬프트와 응답까지 담겨요.
왜 중요한가요
Datadog·Grafana·Langfuse·Sentry 등 OTLP를 받는 도구라면 어디서든 Claude 호출이 우리 서비스 트레이스 안에 이어 붙어서 느린 요청이나 실패한 도구 호출을 한 화면에서 추적할 수 있어요. 실제 트래픽 트레이스로 평가 데이터를 만들 수도 있어요. 다만 전송은 최선 노력 방식이라 스팬이 빠질 수 있어서 비용 집계는 Usage API로 해야 해요.
완성도
Beta 베타베타예요. Console 목적지 설정은 관리자 권한이 필요하고 HIPAA 등 데이터 제한이 있는 조직은 설정과 관계없이 메타데이터만 나가요.
앞으로 이렇게 지켜보세요
- 정식 출시: Claude Platform 릴리스 노트에서 베타 표시가 빠지는지 봐요.
- 적용 범위: Bedrock·Vertex AI 같은 다른 클라우드에서도 API 트레이싱이 되는지 OpenTelemetry 문서의 지원 표를 확인해요.
- 연동: Datadog·Langfuse 같은 파트너가 Claude 전용 대시보드를 내는지 각 사의 변경 내역에서 지켜봐요.