View a markdown version of this page

Amazon CloudWatch Coding Agent Insights を使用して AI コーディングエージェントをモニタリングする - Amazon CloudWatch

Amazon CloudWatch Coding Agent Insights を使用して AI コーディングエージェントをモニタリングする

OpenAI Codex、Claude Code、GitHub Copilot などの AI コーディングエージェントは、トークンの消費、ターンごとのレイテンシー、ツール呼び出し、API リクエスト、承認など、開発者がそれらをどのように使用するかについての OpenTelemetry (OTel) テレメトリを出力します。このテレメトリを Amazon CloudWatch に送信すると、導入状況をモニタリングし、使用状況とコストをチームや部門に帰属させ、開発者フリート全体のパフォーマンスや信頼性の問題を特定することができます。

CloudWatch では Coding Agent Insights を提供しています。これはすぐに使える一連のダッシュボードのセットで、コンソールの GenAI Observability 内の Coding Agent Insights にあります。これらのダッシュボードを使用すると、組織、部門、チーム、コストセンター、ユーザーなどの組織属性ごとに使用状況を細かく分析できるため、フリート全体で導入状況とコストを比較できます。基盤となるデータを CSV としてエクスポートして、さらに詳しく分析することもできます。これらのダッシュボードについては作成もインポートも不要です。エージェントが想定された形式でメトリクスを送信すると、すぐに自動で表示され、データが入力されます。唯一の作業は、OTel メトリクスを CloudWatch に発行するように各エージェントを設定することです。

重要

Coding Agent Insights ダッシュボードは、特定のメトリクスと属性の形式に依存します。各エージェントのネイティブ OTel メトリクスには、ダッシュボードのコアディメンション (modeltoken_type など) が含まれています。ID 属性と組織属性 (user.emailteam.iddepartmentcost_centerorganization など) は OTel リソース属性として送信する必要があります。このセクションのセットアップガイドでは、テレメトリがこの形式で出力されるように各エージェントを設定します。メトリクス名を変更したり、ID 属性をリソースから移動したりすると、ダッシュボードに入力されないことがあります。

前提条件

コーディングエージェントが、CloudWatch ネイティブ OTLP メトリクスエンドポイントにメトリクスを送信する。エージェントを設定する前に、エンドポイントについて理解しておく必要があります。詳細については、「OTLP エンドポイント」および「開始方法」を参照してください。

セットアップガイド

コーディングエージェントのガイドを選択します。各ガイドでは 1 つ以上のセットアップパスについて説明されているため、開発者によるエージェントの実行方法に合わせてアプローチを選択できます。

トピック

    ダッシュボードの表示

    エージェントがメトリクスの送信を開始したら、コンソールでダッシュボードを表示します。

    Coding Agent Insights ダッシュボードを表示するには
    1. CloudWatch コンソールの https://console.aws.amazon.com/cloudwatch/ を開いてください。

    2. ナビゲーションペインで、[GenAI Observability] を選択し、次に [Coding Agent Insights] を選択します。

    3. コーディングエージェントのタブを選択します。メトリクスは通常、エージェントがデータを送信してから数分以内に表示されます。

    注記

    メトリクスは PromQL でクエリできるため、独自のダッシュボードやアラームを構築することもできます。詳細については、「PromQL クエリ」を参照してください。