Amazon CloudWatch에 대한 Claude Code OpenTelemetry 지표 설정
Claude Code는 토큰 사용, 세션, 코드 편집, 도구 직접 호출 및 비용에 대한 OpenTelemetry(OTel) 지표를 내보냅니다. Amazon CloudWatch로 이러한 지표를 전송하면 Coding Agent Insights 대시보드의 Claude Code 탭에 해당 지표가 표시됩니다. 대시보드에 대한 자세한 내용은 Coding Agent Insights 섹션을 참조하세요.
Claude Code는 환경 변수를 통해 OTel 익스포터를 구성합니다. 개발자가 Claude Code를 실행하는 방법에 따라 두 가지 설정 경로를 사용할 수 있습니다.
설정 경로 선택
-
Bearer 토큰 - Claude Code는 CloudWatch 네이티브 OTLP 엔드포인트로 직접 OTLP 지표를 전송하여
Authorization: Bearer헤더로 인증합니다. ID 및 조직 속성은OTEL_RESOURCE_ATTRIBUTES환경 변수를 통해 제공됩니다. 이 경로에는 수집기가 필요하지 않으며 개별 개발자 또는 소규모 팀이 시작할 수 있는 가장 빠른 방법입니다. Bearer 토큰을(를) 참조하세요. -
Claude 앱 게이트웨이를 사용한 엔터프라이즈 롤아웃 - 개발자 액세스, ID 페더레이션 및 원격 분석 수집을 중앙에서 제어해야 하는 조직의 경우. 개발자의 Claude Code 클라이언트와 모델 제공업체 사이에 위치하는 자체 호스팅 게이트웨이를 배포합니다. 개발자는 API 키 또는 클라우드 자격 증명을 보유하는 대신 회사 IdP로 로그인합니다. 게이트웨이는 업스트림 자격 증명을 보유하고, IdP 그룹별 모델 액세스 및 관리형 설정을 적용하고, 사용량 원격 분석을 관찰성 스택에 릴레이합니다. Amazon Bedrock, Claude Platform on AWS, Google Cloud 및 Microsoft Foundry를 업스트림으로 지원합니다. Claude 앱 게이트웨이를 사용하여 Claude Code 설정을(를) 참조하세요.
참고
Bearer 토큰 경로는 Claude Code가 CloudWatch에 원격 분석을 전송하는 방법만 구성합니다. Claude Code가 추론을 위해 모델을 직접적으로 호출하는 방법과는 독립적이므로 모든 모델 제공업체와 함께 사용할 수 있습니다. Claude 앱 게이트웨이를 사용한 엔터프라이즈 롤아웃은 원격 분석 구성과 중앙 집중식 추론 액세스를 결합하고 Amazon Bedrock, Claude Platform on AWS, Google Cloud 및 Microsoft Foundry를 비롯한 여러 백엔드를 지원합니다.
배포 템플릿 및 설정 스크립트를 포함하여 지속적으로 업데이트되는 전체 지침은 GitHub의 Guidance for Claude Code with Amazon Bedrock
