핵심 요약
- 앤트로픽 Claude 플랫폼이 공개 베타로 OpenTelemetry 추적을 제공해요. Messages API, Claude Managed Agents, Claude SDK 호출을 기존 관측 스택으로 내보낼 수 있어요.
- 각 호출은 지연 시간과 오류, 토큰 흐름을 담은 스팬으로 기록돼요. 특히 에이전트 실행 과정이 하나의 트레이스로 완전히 드러나는 점이 특징이에요.
- 설정은 Claude 통합에서 추적을 켜고 OpenTelemetry 익스포터를 기존 관측 도구를 가리키도록 구성하는 방식이에요.
- 전용 페이지는 아직 없으니 공식 사이트 anthropic.com에서 최신 문서와 지원 범위를 확인하는 게 좋아요.
한눈에 보기
| 유형 | 개발자용 관측 기능(공개 베타) |
|---|---|
| 지원 기기 | Claude 플랫폼과 연동되는 서버 환경 |
| 요금 | 공개 베타, 요금은 공식 사이트 확인 필요 |
| 지원 언어 | Claude SDK 지원 언어 기준, 공식 사이트 확인 |
| 핵심 포인트 | Messages API·Managed Agents·SDK 스팬 내보내기 |
| 난이도 | 중급(관측 스택 구성 경험 필요) |
| 카테고리 | 개발·웹 도구 |
| 제작자 | ClaudeDevs |
| 공식 사이트 | anthropic.com ↗ |
| 화제도 | 🔥 화제도 97만 |
| 최종 업데이트 |
클로드 오픈텔레메트리 추적이 뭔가요
클로드 오픈텔레메트리 추적은 앤트로픽의 Claude 개발팀(ClaudeDevs)이 2026년 10월 14일 공개 베타로 발표한 관측 기능이에요. Claude 플랫폼에서 Messages API, Claude Managed Agents, Claude SDK를 통해 발생하는 호출을 OpenTelemetry 형식의 트레이스로 내보낼 수 있어요. OpenTelemetry는 여러 언어와 서비스에서 트레이스와 메트릭, 로그를 수집하는 공개 표준이라서 이미 쓰고 있는 관측 스택에 그대로 연결할 수 있다는 점이 핵심이에요. 프로덕션 AI 워크로드를 운영하는 팀이라면 모델 호출이 어디에서 느려지고 실패하는지 파악하기 어려운데, 이 기능이 바로 그 문제를 겨냥해요.
기존에는 Claude 호출의 지연 시간이나 오류를 확인하려면 자체 로깅을 붙이거나 별도 프록시를 두는 경우가 많았어요. 이제는 통합에서 추적을 켜고 익스포터만 설정하면 각 요청이 스팬으로 기록돼 기존 대시보드에서 다른 서비스와 나란히 볼 수 있어요. 특히 에이전트 실행이 하나의 트레이스로 완전히 드러나는 점이 눈에 띄는 변화예요. 다만 아직 공개 베타이고 전용 소개 페이지가 없어서 세부 지원 범위는 공식 사이트 anthropic.com에서 확인해야 해요.
- 공개 표준 기반
OpenTelemetry는 특정 벤더에 묶이지 않은 표준이라 기존 관측 도구를 그대로 활용할 수 있어요.
- 세 가지 호출 경로
Messages API, Claude Managed Agents, Claude SDK 호출이 모두 추적 대상이에요.
- 공개 베타
정식 출시 전 단계라 기능과 지원 범위가 바뀔 수 있으니 공식 문서를 확인하세요.
스팬으로 드러나는 지연 시간과 토큰 흐름
추적을 켜면 각 요청이 시작과 끝 시각, 상태, 부모-자식 관계를 가진 스팬으로 기록돼요. Messages API 호출 하나, 관리형 에이전트 실행 하나, SDK 요청 하나가 각각 스팬이 되고 이들이 모여 하나의 트레이스를 이뤄요. 덕분에 전체 요청 흐름을 워터폴 형태로 펼쳐 보면서 어느 단계에서 시간이 오래 걸리는지 바로 찾을 수 있어요. 지연 시간만 보던 기존 모니터링보다 훨씬 구체적인 그림을 얻는 셈이에요.
스팬에는 오류 정보와 토큰 흐름도 함께 담겨요. 어떤 호출이 실패했는지, 재시도가 얼마나 일어났는지, 입력과 출력 토큰이 어느 정도 소비됐는지를 같은 트레이스 안에서 연결해 볼 수 있어요. 특히 여러 단계를 오가는 에이전트 실행에서는 중간 단계가 모두 드러나서 디버깅 시간을 크게 줄일 수 있어요. 비용과 성능을 함께 관리하려는 팀에 특히 유용한 구조예요.
- 트레이스 워터폴
부모-자식 관계로 이어진 스팬을 펼쳐 보면 병목 구간이 한눈에 보여요.
- 오류와 재시도 추적
실패한 호출과 재시도 흐름을 같은 트레이스에서 확인할 수 있어요.
- 토큰 흐름 파악
입력·출력 토큰 소비를 지연 시간과 함께 비교해 비용 최적화에 활용해요.
- 에이전트 가시성
관리형 에이전트 실행이 통째로 드러나는 점이 가장 큰 특징이에요.
스테이징에서 익스포터 연결하고 프로덕션으로 확장하기
시작은 Claude 통합에서 추적을 켜는 것부터예요. 그다음 OpenTelemetry 익스포터를 기존 관측 스택을 가리키도록 설정하면 Claude 플랫폼이 스팬을 그쪽으로 보내기 시작해요. 익스포터 설정은 이미 쓰는 관측 도구의 문서를 따르는 게 안전해요. 어떤 엔드포인트와 인증 방식을 요구하는지는 도구마다 다르기 때문이에요.
바로 프로덕션에 켜기보다 스테이징 프로젝트에서 먼저 검증하는 걸 권해요. Messages API 호출을 몇 번 보내고 스팬이 실제로 도착하는지, 필드가 기대한 대로 채워지는지 확인하는 식이에요. 스팬이 보이지 않으면 익스포터 설정이나 네트워크 경로, 샘플링 비율을 점검해야 해요. 검증이 끝난 뒤 트래픽이 적은 시간대에 프로덕션으로 넓히면 사고를 줄일 수 있어요.
- 추적 활성화
Claude 통합 설정에서 추적을 켜는 것이 첫 단계예요.
- 익스포터 구성
기존 관측 스택의 엔드포인트와 인증 정보를 익스포터에 넣어요.
- 스테이징 검증
소량의 호출로 스팬 도착 여부와 필드 구성을 먼저 확인해요.
- 단계적 확장
검증 후 트래픽이 적은 시간에 프로덕션으로 범위를 넓혀요.
기존 로깅·APM과 비교하면 어디에 강한가요
자체 로깅은 원하는 정보를 마음대로 남길 수 있지만 서비스 간 호출 관계를 시각화하려면 손이 많이 가요. 상용 APM은 강력하지만 AI 호출의 토큰 흐름처럼 특수한 정보를 다루려면 별도 연동이 필요할 때가 많아요. Claude의 OpenTelemetry 추적은 표준 형식을 따르기 때문에 이미 쓰는 관측 스택 위에 AI 호출 정보를 얹는 방식이에요. 새로운 도구를 통째로 도입하지 않아도 된다는 게 큰 장점이에요.
한계도 분명해요. 공개 베타라서 지원 범위와 동작이 바뀔 수 있고 전용 소개 페이지가 아직 없어 세부 사양은 공식 사이트에서 확인해야 해요. 또 익스포터와 관측 스택을 직접 구성해야 하므로 관측 환경 구축 경험이 어느 정도 필요해요. 그래서 이 기능은 프로덕션에서 Claude를 쓰면서 장애 대응과 비용 관리에 시간을 쓰는 팀에 가장 잘 맞아요.
- 표준 형식의 이점
OpenTelemetry를 지원하는 도구라면 대시보드와 알림을 그대로 재사용할 수 있어요.
- AI 특화 정보
토큰 흐름과 에이전트 단계가 스팬에 담겨 일반 APM보다 맥락이 풍부해요.
- 도입 전 확인
공개 베타라 지원 범위와 요금, 제한은 공식 사이트 anthropic.com에서 확인하세요.
단계별 가이드
공식 문서에서 지원 범위 확인하기
전용 페이지가 아직 없으므로 공식 사이트 anthropic.com에서 OpenTelemetry 추적 문서와 지원 대상을 먼저 확인해요. 공개 베타라 내용이 자주 바뀔 수 있어요.
Claude 통합에서 추적 켜기
사용 중인 Claude 통합 설정에서 추적을 활성화해요. 어떤 옵션 이름을 쓰는지는 SDK 버전에 따라 다를 수 있으니 문서를 확인하세요.
OpenTelemetry 익스포터 연결하기
기존 관측 스택의 엔드포인트와 인증 정보를 익스포터에 설정해요. 스팬을 어디로 보낼지 지정하는 단계예요.
스테이징에서 스팬 도착 확인하기
Messages API 호출을 몇 번 보내고 스팬이 실제로 도착하는지, 지연 시간과 토큰 필드가 채워지는지 확인해요.
프로덕션으로 단계적 확장하기
검증이 끝나면 트래픽이 적은 시간대에 프로덕션으로 넓히고 대시보드와 알림을 함께 점검해요.
자주 묻는 질문
요금이 따로 있나요?
공개 베타로 제공되는 기능이며 별도 요금 정책은 공식 사이트에서 확인해야 해요. 추적 데이터를 보관하는 관측 스택 쪽 비용은 사용하는 도구에 따라 달라질 수 있어요.
어떤 기기에서 쓸 수 있나요?
휴대폰 앱이 아니라 Claude 플랫폼을 호출하는 서버 환경에서 쓰는 개발자 기능이에요. Messages API나 SDK를 연동한 백엔드에서 설정하고 결과는 관측 도구 대시보드에서 확인해요.
어떻게 작동하나요?
통합에서 추적을 켜고 익스포터를 연결하면 각 호출이 스팬으로 기록돼요. 이 스팬들이 모여 트레이스가 되고 지연 시간과 오류, 토큰 흐름을 기존 관측 스택에서 볼 수 있어요.
Managed Agents에서도 볼 수 있나요?
네, Claude Managed Agents 실행도 추적 대상에 포함돼요. 여러 단계를 오가는 에이전트 실행이 하나의 트레이스로 드러나서 중간 단계 디버깅에 특히 유용해요.
공식 링크는 어디인가요?
이 기능 전용 페이지는 아직 없고 공식 사이트 anthropic.com의 Claude 플랫폼 문서에서 확인할 수 있어요. 공개 베타라 지원 범위와 설정 방법이 바뀔 수 있으니 최신 문서를 보세요.
