앤트로픽, 클로드 에이전트 추적 기능 공개…OpenTelemetry로 도구 호출 관측

앤트로픽이 클로드 플랫폼의 에이전트 실행 과정을 외부 관측 도구에서 추적할 수 있도록 OpenTelemetry 내보내기 기능을 공개했다. 14일 공식 발표에 따르면 Messages API와 Claude Managed Agents, 클로드 SDK가 대상이며 현재 공개 베타 단계다.

OpenTelemetry는 특정 업체에 종속되지 않는 관측 표준이다. 하나의 요청이 거친 전체 기록을 트레이스(trace), 그 안의 개별 작업을 스팬(span)으로 나눠 표현한다. 클로드의 모델 호출과 도구 사용 기록도 이 형식으로 보내 애플리케이션의 로그·지표와 함께 살펴볼 수 있다.

API 쪽 추적은 클로드 콘솔에 전송 대상을 등록하면 작동한다. 관리자가 HTTPS 기반 OTLP/HTTP 수신 주소와 인증정보를 설정하는 방식으로, API가 실행한 모델 요청과 서버 도구 호출, Managed Agents의 작업 단계를 기록한다. 공식 문서는 이 경로의 추적을 위해 애플리케이션 코드를 바꿀 필요가 없다고 설명한다.

SDK 쪽은 애플리케이션에 OpenTelemetry 트레이서 제공자를 등록하는 설정이 필요하다. 설정을 마치면 SDK 요청과 도구 실행 도우미가 수행한 클라이언트 도구의 기록을 애플리케이션의 기존 트레이스 안에 연결할 수 있다. API와 SDK를 함께 설정하면 서버와 클라이언트 양쪽의 실행 단계를 확인할 수 있다.

기록에는 지연 시간과 토큰 수, 식별자 등이 담긴다. OpenTelemetry의 생성형 AI 의미 규약을 따르며 Grafana Cloud, Datadog, Langfuse, Sentry 등과 연결할 수 있다. 이 밖에도 표준 OTLP 엔드포인트를 받는 관측 도구를 사용할 수 있어, AI 에이전트와 기존 서비스의 느리거나 실패한 구간을 같은 환경에서 분석하는 데 초점을 맞췄다.

기본 콘텐츠 모드는 메타데이터만 전송한다. 전체 콘텐츠 모드를 선택하면 모델의 프롬프트와 응답도 포함되며, 전송된 데이터에는 수신 서비스의 접근 통제와 보관 정책이 적용된다. 운영팀은 관측 범위뿐 아니라 어떤 대화 내용까지 외부 도구에 보낼지도 설정할 수 있다.

정식 출시 전이라는 제약도 있다. 앤트로픽은 베타 기간 SDK 옵션과 스팬 구조가 바뀌어 코드나 대시보드에 영향을 줄 수 있다고 명시했다. 도입 시 SDK 버전을 고정하면 변경 사항을 적용할 시점을 선택할 수 있다는 설명이다.

출처: Anthropic 공식 발표, Agent observability on the Claude Platform https://claude.com/resources/articles/agent-observability-on-the-claude-platform
Anthropic 공식 문서, OpenTelemetry for the Claude API https://platform.claude.com/docs/en/manage-claude/opentelemetry
Anthropic 공식 문서, Use OpenTelemetry with the Claude API https://platform.claude.com/docs/en/manage-claude/opentelemetry/api
Anthropic 공식 문서, Use OpenTelemetry with the Claude SDK https://platform.claude.com/docs/en/manage-claude/opentelemetry/sdk