Anthropic, Claude Platform에 OpenTelemetry 트레이스 내보내기 기능 추가

Anthropic은 2026년 10월 14일 Claude Platform에 OpenTelemetry 트레이스 내보내기 기능을 추가했다고 발표했습니다. 이제 개발자는 Claude Managed Agents, Messages API, Claude SDK에서 생성된 트레이스를 표준을 지원하는 모든 옵저버빌리티 도구로 보낼 수 있으며, 이 기능은 공개 베타로 제공됩니다.

Anthropic의 발표에 따르면, Claude Console에서 대상을 추가하면 모든 에이전트 턴, 모델 호출, 도구 사용 기록이 지연 시간, 토큰 수, ID를 포함한 표준 OpenTelemetry 트레이스로 사용자의 옵저버빌리티 도구에 전송됩니다. Managed Agents와 Messages API를 사용하려면 Console에서 대상을 설정해야 하지만, Claude SDK는 트레이스를 자동으로 내보냅니다. 이미 Claude Code 또는 Cowork 트레이스를 옵저버빌리티 도구로 보내고 있는 개발자는 Claude Platform에서 구축한 에이전트도 같은 곳에서 확인할 수 있습니다.

Anthropic에 따르면 Claude 트레이스는 OpenTelemetry GenAI 시맨틱 규약을 따르므로 Claude와 다른 공급업체의 데이터를 동일한 도구와 대시보드에서 함께 사용할 수 있습니다. 또한 표준 OTLP 엔드포인트를 지원하는 모든 OpenTelemetry 도구에서도 트레이스를 사용할 수 있습니다.

두 가지 설정 경로와 하나의 트레이스 모델

Claude Platform 문서는 트레이스를 시스템을 거치는 단일 요청의 전체 기록으로, 스팬을 모델 요청이나 도구 사용처럼 트레이스의 한 단계로 정의합니다. 문서에는 두 가지 설정 경로가 소개되어 있습니다. SDK 트레이싱은 SDK를 설치하고 트레이서 공급자를 등록해 코드에서 설정하며, 별도의 권한이 필요하지 않습니다. API 트레이싱은 Claude Console에서 대상을 추가해 설정하며, 관리자 권한이 필요합니다.

두 설정 경로에서 수집되는 항목은 서로 다릅니다. API 트레이싱은 요청 내 각 모델 실행, Managed Agents의 각 턴, API가 실행하는 서버 도구를 기록합니다. SDK 트레이싱은 도구 실행기가 실행하는 클라이언트 도구, 자체 호스팅 샌드박스의 도구, 파일 업로드와 같은 기타 API 요청도 추가로 기록합니다. 두 경로를 모두 설정하면 한 요청의 SDK 스팬과 API 스팬이 하나의 트레이스에 포함됩니다. 단, AWS의 Claude Platform으로 보내는 요청은 API 스팬이 별도의 트레이스에 표시됩니다.

Managed Agents에서는 세션마다 Sessions API 요청별 스팬이 생성되고, 에이전트 턴마다 턴 스팬이 생성됩니다. 각 턴에는 모델 요청별 스팬, API가 실행하는 도구별 스팬, 결과 평가별 스팬이 포함됩니다. 문서에서는 Claude Code, Agent SDK, Cowork 사용자가 해당 제품의 모니터링 및 옵저버빌리티 관련 별도 문서를 참조하도록 안내합니다.

콘텐츠 모드, 제한 및 규정 준수 동작

각 대상과 SDK 클라이언트에는 스팬에 모델 프롬프트와 응답을 포함할지 제어하는 콘텐츠 모드가 있습니다. 기본 설정인 메타데이터만 모드는 식별자, 시간 정보, 상태, 토큰 수와 사용자가 선택한 텍스트를 기록합니다. 사용자가 선택한 텍스트에는 에이전트와 도구의 이름 및 설명, MCP 서버 이름 등이 포함될 수 있습니다. 전체 콘텐츠 모드에서는 모델 프롬프트와 응답도 추가됩니다.

전체 콘텐츠 모드에서는 기본적으로 각 스팬에 최대 0.75 MB의 콘텐츠가 저장됩니다. 문서에 따르면 이는 영어 텍스트 기준 200k 토큰 컨텍스트 창에 해당하며, 여러 옵저버빌리티 플랫폼과 프록시의 요청 한도인 1 MB보다 적은 양입니다. 1M 토큰 컨텍스트 창 전체에는 약 4 MB가 필요합니다. 콘텐츠가 한도를 초과하면 SDK 또는 API가 콘텐츠를 줄이고 anthropic.content.truncated 속성을 true로 설정합니다. 요청 스팬에서는 시스템 프롬프트와 가장 오래된 메시지부터 제외하며, 이미지와 문서는 유형만 표시됩니다.

Anthropic과 HIPAA, FERPA 또는 K-12 데이터 처리 제한을 적용받는 조직은 설정된 콘텐츠 모드와 관계없이 대상에서 메타데이터만 내보냅니다. 다만 SDK 스팬에는 이 제한이 적용되지 않습니다. 데이터 보존 기간이 0으로 설정된 경우에도 API가 내보낸 콘텐츠를 대상에 전달할 때까지 메모리에만 보관하므로 전체 콘텐츠 모드를 사용할 수 있습니다. Claude Managed Agents는 데이터 보존 기간 0 설정을 이용할 수 없으며, OpenTelemetry를 사용해도 데이터 보존 조건은 달라지지 않습니다.

토큰 사용량을 계산할 때는 요청마다 한 가지 출처의 스팬만 합산해 각 토큰을 한 번씩만 집계하라고 문서는 안내합니다. SDK 스팬과 API 스팬이 모두 있는 요청에서는 API 스팬을 사용해야 합니다. 또한 전송을 재시도하면 스팬이 두 번 이상 도착할 수 있다고 설명합니다.

주요 연동 플랫폼과 초기 고객의 평가

발표에서는 지원되는 옵저버빌리티 플랫폼을 사용 사례별로 소개합니다. 소프트웨어 스택의 다른 구성 요소와 함께 에이전트를 디버깅하는 용도로는 Grafana Cloud, Honeycomb, Sentry, Splunk를 꼽았습니다. 이들 플랫폼에서는 에이전트 트레이스가 로그와 메트릭 옆에 표시되므로, 개발자는 지연되거나 실패한 단계가 어느 서비스에서 비롯됐는지 확인할 수 있습니다. 프로덕션 데이터를 활용해 에이전트를 개선하는 용도로는 Arize AI, Braintrust, Datadog, Langfuse, LangChain의 LangSmith, New Relic, PostHog를 소개했으며, 실제 트레이스를 평가 데이터로 전환하고 품질 문제를 찾아내는 등의 활용 사례를 들었습니다. 조직 전체의 사용량을 추적하는 용도로는 Databricks Unity Gateway를 소개했습니다. 이곳에서는 플랫폼 및 보안 팀이 팀별 토큰 사용량을 확인하고 비정상적인 활동을 표시할 수 있습니다.

초기 고객 몇 곳은 발표에서 자사 도입 사례를 소개했습니다. Foxglove의 공동 창업자 겸 CTO인 Roman Shtylman은 자사가 로봇 팀의 로봇 디버깅을 돕는 에이전트를 구축한다고 말했습니다. 또한 Claude Platform의 기본 OpenTelemetry 내보내기 기능을 이용하면 PostHog에서 에이전트 상호작용을 제품 사용 데이터와 함께 분석할 수 있어, 실제 환경에서 에이전트 성능을 평가하고 로봇 팀의 개선 우선순위를 정할 수 있다고 밝혔습니다.

Ramp의 선임 소프트웨어 엔지니어 David Traina는 Langfuse 트레이스에 점수를 매기고, 반복되는 실패를 찾아내며, 해결책을 제안하는 에이전트형 시스템 Reflect를 개발했다고 말했다. Traina는 “일부 에이전트에서는 이미 토큰 사용량을 10~20% 줄이고 세션 속도를 30% 높였습니다”라며, Claude API의 기본 OpenTelemetry 내보내기를 사용하면 추가 단계 없이 계측 데이터를 개선 과정에 바로 전달할 수 있다고 덧붙였다.

Sterling Labs의 CTO Hyon Lee는 실시간 시장을 분석하는 회사 에이전트에 별도의 계측을 추가하지 않아도 기본 내보내기를 통해 모든 트레이스가 Langfuse로 전송된다고 말했다. 회계 소프트웨어 회사 FloQast의 인프라 책임자 Ankush Sharma는 회사 에이전트가 Grafana Cloud의 원격 측정 데이터를 활용해 Claude Platform에서 실행된다고 설명했다. 덕분에 각 모델 호출은 해당 호출이 수행된 조정 또는 분개 워크플로와 동일한 트레이스에 기록되므로, 회사는 하나의 타임라인을 통해 에이전트가 무엇을 했는지에 관한 감사인의 질문에 답할 수 있다.