Claude 에이전트가 어디서 막혔는지, 쓰던 모니터링 도구로 봐요 — OpenTelemetry 추적 공개 베타

Anthropic이 Claude API · Managed Agents · Claude SDK의 요청과 도구 사용 기록을 OpenTelemetry(관측 데이터를 주고받는 공통 규격) 추적으로 내보내는 기능을 공개 베타로 열었어요. 코드를 안 고치고 Console에서 받을 곳만 정하면 돼요.

핵심 3줄

Claude Platform이 Messages API 요청, Managed Agents 세션, Claude SDK 호출을 OpenTelemetry 추적(trace)으로 보내요. 모델 요청 하나, 도구 사용 하나가 각각 한 단계(span)로 찍혀요.
Console에서 '받을 곳(destination)'을 추가하면 코드 수정 없이 API 쪽 기록이 나가요(조직 관리자 권한 필요). 기본은 시간·상태·토큰 수만 보내는 '메타데이터만' 모드이고, 원하면 프롬프트와 답까지 보내요.
문서에 짝 플랫폼 12곳(Langfuse · LangSmith · Datadog · Grafana Cloud · Sentry 등)이 올라 있고, OTLP를 받는 곳이면 어디든 돼요. 내용 모드에서는 한 단계에 기본 0.75MB까지 담아요.

🧪 CONTENTSLAB 평지금 써 보세요★★★★★실전 활용도 3/5

개발자

Claude로 만든 에이전트가 가끔 느리거나 엉뚱한 도구를 부를 때, 어느 모델 요청·어느 도구 호출에서 시간이 걸렸는지 단계별로 볼 수 있어요. 이미 Datadog이나 Sentry를 쓰고 있으면 거기에 그대로 붙어요.

1인 사업자·기획자

API 비용이 어디서 새는지 궁금할 때 기능별·사용자별 토큰 수를 묶어 볼 수 있어요. 다만 문서는 빠짐없는 사용량 기록이 아니라고 적고 있어서, 정산은 Usage API로 하는 편이 맞아요.

AI 크리에이터·마케터

직접 코드를 짜지 않는다면 당장 쓸 곳은 적어요. 외주 개발자에게 'Claude 추적을 메타데이터 모드로 켜 달라'고 요청하는 정도로 알아 두면 돼요.

$ 바로 해 보기

1) 오픈소스 관측 도구 Langfuse(무료 셀프 호스팅 또는 클라우드)에 계정 만들기
2) Claude Console → 설정 → OpenTelemetry → Add destination, Provider에서 Langfuse 고르기
3) Content mode는 처음엔 Metadata only로
4) More actions → Test로 anthropic.test 단계가 도착하는지 확인
5) 플레이그라운드에서 요청 하나 보내고 service.name = claude-platform 으로 걸러 보기

CONTENTSLAB 생각 · 이렇게 써 볼 수 있을 것 같아요

직접 만든 Claude 자동화 도구가 가끔 멈추거나 토큰을 많이 쓸 때, 메타데이터 모드로 먼저 켜 두고 어느 단계에서 느려지는지 확인하는 데 써 보면 좋을 것 같아요.

Anthropic 개발자 계정(ClaudeDevs)이 10월 15일 02:25(한국 시각) 공식 X에 Claude Platform의 OpenTelemetry 추적을 공개 베타로 열었다고 올렸어요. OpenTelemetry는 여러 회사의 모니터링 도구가 함께 쓰는 공통 규격이에요. 추적(trace)은 요청 하나가 시스템을 지나간 전체 기록이고, 그 안의 한 단계(모델 요청 한 번, 도구 사용 한 번)를 span이라고 불러요.

X 게시물 보기 · https://x.com/claudedevs/status/2110421732029063352

무엇이 찍히나요

API 쪽(Console에서 설정): Messages API 요청, Managed Agents 세션의 턴, 요청 안의 모델 실행 하나하나, 웹 검색 같은 서버 도구 사용
SDK 쪽(코드에서 설정): 내 앱에서 도는 도구(tool runner), 파일 올리기 같은 다른 API 요청
둘 다 켜면 내 앱의 기록 아래에 Claude 쪽 기록이 한 줄로 이어져 보여요. MCP 커넥터로 붙인 내 MCP 서버에도 추적 정보를 넘겨 줘요.

켜는 법과 조건

Console의 OpenTelemetry 설정에서 받을 곳을 추가해요. 조직 관리자(admin) 권한이 있어야 하고, 받는 주소는 HTTPS 443 포트의 OTLP/HTTP여야 해요.
모드는 둘이에요. 기본 메타데이터만(ID·시간·상태·토큰 수)과 전체 내용(프롬프트와 답 포함)이에요. 전체 내용은 한 단계에 기본 0.75MB까지 담고, 문서는 이 크기가 영어 20만 토큰 분량이라고 적었어요.
조직당 받을 곳은 최대 10개예요. 전달은 '최선 노력' 방식이라 기록 일부가 빠질 수 있다고 문서에 적혀 있어요.
Claude API와 AWS의 Claude Platform에서 베타로 쓸 수 있어요.

문서에 올라온 짝 플랫폼은 Arize AI, Braintrust, Databricks, Datadog, Grafana Cloud, Honeycomb, Langfuse, LangSmith, New Relic, PostHog, Sentry, Splunk 12곳이에요. 목록에 없어도 OTLP를 받는 곳이면 쓸 수 있어요.

원문 화면 · Claude Platform 문서 · OpenTelemetry for the Claude API (Beta)

출처 (원문)