kakakakakku blog

Weekly Tech Blog: Keep Learning!

Claude Code の利用状況を CloudWatch Coding Agent Insights で可視化する

はじめに

2026年7月20日に Amazon CloudWatch の新機能「Coding Agent Insights」が発表された.Claude Code・Codex・GitHub Copilot の OpenTelemetry (OTel) メトリクスを Amazon CloudWatch に送って,ダッシュボードでイイ感じに可視化できる❗️

aws.amazon.com

コーディングエージェントの利用状況を過剰なマイクロマネジメントや開発生産性評価に使うのは微妙だと思うけど,AI 活用を推進する組織全体の状況を可視化する目的であればニーズはありそう.ダッシュボードで細かくフィルタできるため,たとえば「モデル別の利用状況」や「部署別の利用状況」なども可視化できる.

今回は個人レベルの検証だけど,普段使っている Claude Code で試してみた \( 'ω')/

Amazon CloudWatch メトリクス API キーを作る

セットアップには「Bearer トークン」と「Claude Apps Gateway(エンタープライズ)」の2種類がある.今回は個人用途なので Amazon CloudWatch メトリクス API キー(Bearer トークン)を使う.

docs.aws.amazon.com

Amazon CloudWatch の画面から 設定 → グローバル → API キー → 作成 と進む.有効期限は「1日・5日・30日・90日・365日・失効しない・カスタム」から選べて,API キーを発行すると「API キーシークレット」を取得できるようになる.ちなみに裏側では CloudWatchAPIKey-xxxx という名前の IAM ユーザーが作られている.

環境変数を設定する

次に OpenTelemetry (OTel) の環境変数を設定する.今回は ~/.claude/cloudwatch-otel.env を作って ~/.zshrc からロードするようにしたけど他の場所でも OK👌OTEL_EXPORTER_OTLP_METRICS_ENDPOINT と OTEL_EXPORTER_OTLP_METRICS_HEADERS にはドキュメントを参考に Amazon CloudWatch メトリクスエンドポイントと取得した API キーシークレットを設定する.

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.ap-northeast-1.amazonaws.com/v1/metrics"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer XXX"
export OTEL_RESOURCE_ATTRIBUTES="user.id=kakakakakku,user.email=xxxxx@example.com,user.name=kakakakakku,department=ai"

また OTEL_RESOURCE_ATTRIBUTES には以下を設定できる.今回はサンプルとして user.id・user.email・user.name・department を設定した(ai 部署はサンプル).Coding Agent Insights のフィルタで使えるため利用状況を分析するための値を整理しておくのが良さそう❗️ちなみにモデル名は Claude Code 側で自動的に設定してくれるので気にしなくて OK👌

  • user.id
  • user.email
  • user.name
  • department
  • team.id
  • cost_center
  • organization
  • location
  • role
  • manager

動作確認

環境変数をロードした状態で Claude Code を立ち上げると自動的に Amazon CloudWatch Coding Agent Insights にメトリクスが送信された❗️Coding Agent Insights を見ると以下のメトリクスを確認できた.

  • Executive Summary
    • Total Tokens
    • Total Cost (USD)
    • Active Users
    • Sessions
    • Cache Hit Rate
    • Active Hours
  • Usage & Cost
    • Token Usage Over Time
    • Token Usage by Department
    • Cost by Department (USD)
    • Token Usage by Type
  • Developer Productivity
    • Lines of Code
    • Commits by Department
    • Active Hours by Department
    • Pull Requests by Department
  • Code Editing
    • Code Generation by Language
    • Code Edit Decisions
    • Code Edits by Tool

Amazon CloudWatch アラームを設定する

さらに Amazon CloudWatch Coding Agent Insights で取得したメトリクスを使って Amazon CloudWatch アラームを設定することもできる.その場合は PromQL を使う必要がある.今回は Claude Code のトークン利用状況が閾値を超えたら発火する条件にした.すぐに確認できるように閾値は超低め🔥

sum(increase({"claude_code.token.usage"}[5m])) > 1000

動作確認をすると Amazon SNS 経由でメールが届いた✉️ しかし AWS Chatbot 経由の Slack 通知は届かなかった...(なぜだろう!?)

まとめ

Amazon CloudWatch の新機能「Coding Agent Insights」をさっそく試してみた❗️Claude Code などのコーディングエージェントのメトリクスを可視化するという取り組みは既にあるけど,Coding Agent Insights を使えば Prometheus + Grafana のような環境を構築・運用する必要もなく,すぐに始められるのがイイ😀

コーディングエージェントのメトリクスを収集するということに抵抗がある人もいるはずだから組織で導入する場合は「背景」や「狙い」を明確にするのが重要かなとも思った.

関連ドキュメント

docs.aws.amazon.com

関連ポスト