Claude Code OpenTelemetry メトリクスを Amazon CloudWatch 用にセットアップする
Claude Code は、トークンの使用状況、セッション、コード編集、ツール呼び出し、コストに関する OpenTelemetry (OTel) メトリクスを出力します。これらのメトリクスを Amazon CloudWatch に送信すると、Coding Agent Insights ダッシュボードの [Claude Code] タブに入力されます。ダッシュボードのページの詳細については、「Coding Agent Insights」を参照してください。
Claude Code は、環境変数を通じて、その OTel エクスポーターを設定します。開発者が Claude Code を実行する方法に応じて、2 つのセットアップパスを使用できます。
セットアップパスの選択
-
ベアラートークン — Claude Code は OTLP メトリクスを CloudWatch ネイティブ OTLP エンドポイントに直接送信し、
Authorization: Bearerヘッダーで認証します。ID 属性と組織属性は、OTEL_RESOURCE_ATTRIBUTES環境変数を通じて提供されます。このパスにはコレクターが不要であるため、開発者個人や小規模なチームにとって最も手軽な方法です。「ベアラートークン」を参照してください。 -
Claude アプリケーションゲートウェイを使用したエンタープライズロールアウト — 開発者のアクセス、ID フェデレーション、テレメトリ収集を一元管理する必要がある組織向け。開発者の Claude Code クライアントとモデルプロバイダーの間に位置するセルフホスト型ゲートウェイをデプロイします。開発者は、API キーやクラウド認証情報を保持する代わりに、コーポレート IdP でサインインします。ゲートウェイは、アップストリーム認証情報を保持し、IdP グループごとにモデルアクセスとマネージド設定を適用し、オブザーバビリティスタックに使用状況テレメトリを中継します。Amazon Bedrock、AWS の Claude プラットフォーム、Google Cloud、Microsoft Foundry をアップストリームとしてサポートします。「Claude アプリゲートウェイによる Claude Code のセットアップ」を参照してください。
注記
ベアラートークンパスは、Claude Code が CloudWatch に「テレメトリ」 を送信する方法のみを設定します。Claude Code が「推論」のためにモデルを呼び出す方法とは無関係であるため、任意のモデルプロバイダーで使用できます。Claude アプリケーションゲートウェイを使用したエンタープライズロールアウトは、テレメトリ設定と一元的な推論アクセスを組み合わせ、Amazon Bedrock、AWS の Claude プラットフォーム、Google Cloud、Microsoft Foundry などの複数のバックエンドをサポートします。
デプロイテンプレートやセットアップスクリプトなど、継続的に更新される完全なガイダンスについては、GitHub の「Claude Code with Amazon Bedrock のガイダンス
トピック
