View a markdown version of this page

ベアラートークンを使用して Amazon CloudWatch で Claude Code メトリクスをセットアップする - Amazon CloudWatch
前提条件メトリクスエクスポーターの設定ID と組織属性の追加検証および表示

ベアラートークンを使用して Amazon CloudWatch で Claude Code メトリクスをセットアップする

このパスでは、Claude Code は、OpenTelemetry (OTel) メトリクスを Amazon CloudWatch ネイティブ OTLP メトリクスエンドポイントに直接送信し、ベアラートークン (CloudWatch メトリクス API キー) を使用して認証します。OpenTelemetry コレクターは必要ありません。開発者個人や小規模なチームが Claude Code メトリクスを Coding Agent Insights ダッシュボードに取り込む場合は、この方法が最速です。

重要

ベアラートークンは長期的な認証情報です。AWS 外のデベロッパーラップトップなど、短期的な AWS 認証情報が適していない場合にのみお勧めしております。セキュリティのトレードオフとキーローテーションのガイダンスについては、「メトリクスのベアラートークン認証の設定」を参照してください。コーポレート SSO を通じて ID のフェデレーションを行う組織は、代わりに Claude アプリケーションゲートウェイでエンタープライズロールアウトを使用する必要があります。「Claude アプリゲートウェイによる Claude Code のセットアップ」を参照してください。

前提条件

  • 開発者のマシンにインストールされている Claude Code。

  • Claude Code が推論のためにモデルを呼び出すための実用的な方法。このテレメトリセットアップは推論とは無関係であるため、Anthropic アカウント (デフォルトの Claude Code プロバイダー) または Amazon Bedrock を使用できます。推論に Amazon Bedrock を使用するには、Claude Code ドキュメントの「Amazon Bedrock の Claude Code」を参照してください。

  • CloudWatch メトリクスのアクセス許可がある IAM ユーザーから CloudWatch メトリクス API キー (ベアラートークン) が生成されている。IAM ユーザーを作成してキーを生成する手順については、「メトリクスのベアラートークン認証の設定」を参照してください。

メトリクスエクスポーターの設定

Claude Code は、環境変数を使用して OpenTelemetry を設定します。Claude Code を起動するシェル (またはシェルプロファイル) で次の変数を設定し、メトリクスを有効にして OTLP/HTTP プロトコルを選択し、メトリクスエクスポーターを CloudWatch メトリクスエンドポイントにポイントして、Authorization ヘッダーにベアラートークンを含めます。完全な /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"
注記

ベアラートークンをシークレットとして扱います。安全でない方法で共有またはバックアップされているソースコントロールとシェルプロファイルにはコミットしないでください。メトリクスのベアラートークン認証の設定 の説明に従って、キーのローテーションを定期的に行ってください。

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 の「Claude Code with Amazon Bedrock のガイダンス」を参照してください。