View a markdown version of this page

Bearer 토큰을 사용하여 Amazon CloudWatch에서 Claude Code 지표 설정 - Amazon CloudWatch
사전 조건지표 익스포터 구성ID 및 조직 속성 추가확인 및 보기

Bearer 토큰을 사용하여 Amazon CloudWatch에서 Claude Code 지표 설정

이 경로에서 Claude Code는 Amazon CloudWatch 네이티브 OTLP 지표 엔드포인트로 직접 OpenTelemetry(OTel) 지표를 전송하고 Bearer 토큰(CloudWatch Metrics API 키)으로 인증합니다. OpenTelemetry 수집기는 불필요합니다. 이는 개별 개발자 또는 소규모 팀이 Claude Code 지표를 Coding Agent Insights 대시보드로 가져오는 가장 빠른 방법입니다.

중요

Bearer 토큰은 장기 자격 증명입니다. AWS 외부에 있는 개발자 노트북과 같이 단기 AWS 자격 증명을 사용할 수 없는 경우에만 Bearer 토큰 사용을 권장합니다. 보안 장단점 및 키 교체 지침은 Metrics에 대한 전달자 토큰 인증 설정 섹션을 참조하세요. 기업 SSO를 통해 ID를 페더레이션하는 조직은 대신 Claude 앱 게이트웨이를 활용한 엔터프라이즈 롤아웃을 사용해야 합니다. Claude 앱 게이트웨이를 사용하여 Claude Code 설정을(를) 참조하세요.

사전 조건

  • 개발자 시스템에 Claude Code가 설치되어 있어야 합니다.

  • Claude Code가 추론을 위해 모델을 직접적으로 호출할 수 있는 작동 방식이 필요합니다. 이 원격 분석 설정은 추론과 독립적이므로 Anthropic 계정(기본 Claude Code 제공업체) 또는 Amazon Bedrock을 사용할 수 있습니다. 추론에 Amazon Bedrock을 사용하려면 Claude Code 설명서의 Claude Code on Amazon Bedrock을 참조하세요.

  • CloudWatch Metrics 권한이 있는 IAM 사용자로부터 생성된 CloudWatch Metrics API 키(Bearer 토큰)가 필요합니다. IAM 사용자를 생성하고 키를 생성하는 절차는 Metrics에 대한 전달자 토큰 인증 설정을 참조하세요.

지표 익스포터 구성

Claude Code는 환경 변수를 통해 OpenTelemetry를 구성합니다. Claude Code를 시작하는 쉘 또는 쉘 프로필에서 다음 변수를 설정하여 지표를 활성화하고, OTLP/HTTP 프로토콜을 선택하고, Authorization 헤더에 Bearer 토큰을 포함하여 지표 익스포터가 CloudWatch Metrics 엔드포인트를 가리키도록 구성합니다. 전체 /v1/metrics 경로를 포함합니다.

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://monitoring.region.amazonaws.com/v1/metrics"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer YOUR_API_KEY"
참고

Bearer 토큰을 시크릿으로 취급하세요. 안전하지 않게 공유되거나 백업되는 소스 제어 또는 쉘 프로필에 커밋하지 마세요. Metrics에 대한 전달자 토큰 인증 설정에 설명된 대로 주기적으로 키를 교체하세요.

ID 및 조직 속성 추가

Coding Agent Insights 대시보드는 개발자, 팀, 부서 및 기타 조직 차원별로 사용량을 그룹화합니다. OTEL_RESOURCE_ATTRIBUTES 환경 변수를 통해 이를 OTel 리소스 속성으로 제공합니다. 개발자의 ID와 조직의 구조에서 값을 설정합니다.

export OTEL_RESOURCE_ATTRIBUTES="\
user.id=alias,\
user.email=developer@example.com,\
user.name=Jane Doe,\
department=engineering,\
team.id=platform,\
cost_center=cc-1234,\
organization=example-corp,\
location=us-seattle,\
role=software-engineer,\
manager=manager@example.com"
참고

이를 데이터포인트별 속성이 아닌 리소스 속성으로 설정하면 대시보드에서 예상하는 형식과 일치하므로 @resource.team.id, @resource.department 및 이와 유사한 레이블별로 그룹화할 수 있습니다. Claude Code는 model, type 등의 지표 수준 차원을 지표에 자동으로 스탬핑합니다.

확인 및 보기

Claude Code를 실행하여 지표를 생성하고 데이터가 CloudWatch에 도달했는지 확인합니다.

지표를 확인하려면

  1. 일부 작업을 수행하는 Claude Code 세션을 실행합니다.

  2. CloudWatch 콘솔에서 GenAI Observability, Coding Agent Insights, Claude Code 탭을 차례로 선택합니다. 지표는 대개 몇 분 안에 표시됩니다.

  3. 필요에 따라 PromQL을 사용하여 지표를 직접 쿼리합니다. 자세한 내용은 PromQL 쿼리 섹션을 참조하세요.

지속적으로 업데이트되는 전체 지침은 GitHub의 Guidance for Claude Code with Amazon Bedrock을 참조하세요.