AI デベロッパー ツールの指標を表示する

このドキュメントでは、組織内の AI デベロッパー ツール（Google Antigravity や Antigravity CLI など）の使用状況の指標とテレメトリーを表示する方法について説明します。これらの指標には、ユーザーの導入状況、トークンの消費量、API 呼び出し、ツールの実行状況が表示されます。

始める前に

AI デベロッパー ツールの指標を表示する前に、次の前提条件を満たしていることを確認してください。

  • AI デベロッパー ツールを有効にする: AI デベロッパー ツールの指標を表示するには、組織でプロジェクトの AI デベロッパー ツールを有効にする必要があります。AI デベロッパー ツールを有効にするをご覧ください。

  • Cloud 請求先アカウント: プロジェクトで Cloud Billing を有効にする必要があります。Cloud 請求先アカウントの種類をご覧ください。

  • 対応エディション: ユーザーは、Gemini Enterprise Standard、Plus、Standard 新興市場、または従量課金制エディションのサブスクリプションが必要です。

  • 必要なロール:Google Cloud コンソールの [デベロッパー ツールの指標] ページにアクセスするには、Gemini Enterprise 管理者（roles/discoveryengine.agentspaceAdmin）ロールが必要です。

指標ダッシュボードにアクセスする

Google Cloud コンソールで AI デベロッパー ツールの指標を表示する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise に移動

  2. AI デベロッパー ツールを有効にした Google Cloud プロジェクトを選択します。

  3. ナビゲーション メニューで、[デベロッパー ツールの指標] をクリックします。

  4. ダッシュボードの右上にある期間コントロールを使用して、レポートの期間を調整します。

    管理 説明
    期間セレクタ メニュー デフォルトでは、ダッシュボードには過去 1 日のデータが表示され、自動ライブ更新が有効になっています。メニューをクリックして、次のいずれかの操作を行います。
    • [相対時間] フィルタ フィールドにカスタム期間を直接入力します（例: 15m、1h、1d、1w）。
    • プリセットの相対的な期間（[今日]、[昨日]、[過去 15 分]、[過去 30 分]、[過去 1 時間]、[過去 3 時間]、[過去 6 時間]、[過去 12 時間]、[過去 1 日]、[過去 2 日]、[過去 7 日]、[過去 14 日]）を選択します。
    • [開始時間と終了時間] をクリックして、レポート期間の開始日時と終了日時をカスタムで指定します。
    • [特定の時刻の前後] をクリックして日時を指定し、そのタイムスタンプを中心とした指標を表示します。
    • [タイムゾーン] をクリックして、グラフに別の表示タイムゾーン（PDT（UTC-7）など）を選択します。
    左矢印と右矢印 レポートの期間を、メニューで選択した期間だけ過去（）または将来（）にシフトします。たとえば、[過去 1 日] が選択されている場合、 をクリックすると、グラフが 1 日前にシフトします。
    期間を縮小する をクリックすると、特定の期間が縮小表示されます。すべてのグラフが更新され、ズームアウトされた期間のデータが表示されます。ズームインしてビューをリセットするには、期間セレクタ メニューから期間を選択します。
    自動更新 相対的な期間を表示するときに、ダッシュボード データの自動ライブ更新をオンまたはオフに切り替えます。絶対的な期間（カスタムの開始時刻と終了時刻、過去のウィンドウなど）が選択されている場合、絶対的な期間では自動更新がサポートされていないため、自動更新は無効になります。

グラフデータを探索する

[デベロッパー ツールの指標] ダッシュボードの各グラフには、時系列の検査、指標とログの関連付け、基盤となるデータの分析に役立つインタラクティブなコントロールが用意されています。

管理 説明
情報 グラフのタイトルの横にある [情報] をクリックすると、グラフの指標クエリに適用されているフィルタ、グループ化、集計プロパティの詳細が表示されます。
アラート ポリシーを作成する 指標の折れ線グラフで、グラフのツールバーの [アラート ポリシーを作成] をクリックして、グラフの時系列クエリが事前入力された Cloud Monitoring のアラート ワークフローを開きます。その後、指標のしきい値条件と通知チャンネルを構成できます。
データを探索する グラフのツールバーで [データを探索] をクリックして、Metrics Explorer で指標クエリを開きます。Metrics Explorer では、さまざまなディメンションにわたって、基盤となる時系列クエリを検査、フィルタ、グループ化、変更したり、カスタマイズしたビューをカスタム ダッシュボードに保存したりできます。
全画面表示 グラフ ツールバーで [その他のグラフ オプション] をクリックし、[全画面で表示] を選択して、グラフを画面いっぱいに表示し、時系列データと凡例データを詳しく調べます。
関連するログを検査する 指標データを同じ期間に書き込まれたログエントリと関連付けて、アクティビティとエラーのトラブルシューティングを行うことができます。
  • ダッシュボード ビュー: グラフ ツールバーで [その他のグラフ オプション] をクリックし、[関連するログを検査] を選択して、グラフと関連するログエントリを並べて表示する分割ビューパネルを開きます。
  • データポイントのツールチップ: グラフの時系列で、特定のデータポイントにポインタを合わせ、ツールチップから [関連するログを検査] を選択します。このモードでは、スプリットビュー パネルで、選択したタイムスタンプの 5 分前と 5 分後のウィンドウにログエントリがフィルタされます。

利用可能な指標

次の表に、ダッシュボードで使用できるすべての指標を示します。

セクション 指標名 説明
アクティブ ユーザー（導入） アクティブ ユーザーとは、レポート期間中に少なくとも 1 つの AI デベロッパー ツール アクション（API リクエスト、プロンプト、ツールの実行など）を開始したユニーク ユーザーです。
1 時間ごとのアクティブ ユーザー数（平均） 選択した期間における 1 時間あたりのユニーク アクティブ ユーザー数の平均が表示されます。
1 日のアクティブ ユーザー数（平均） 選択した期間における 1 日あたりのユニーク アクティブ ユーザー数の平均値が表示されます。
1 週間のアクティブ ユーザー数（平均） 選択した期間における 1 週間あたりのユニーク アクティブ ユーザー数の平均値を表示します。
1 か月のアクティブ ユーザー数（平均） 選択した期間における 1 か月あたりのユニーク アクティブ ユーザー数（28 日間のアクティブ ユーザー数）の平均値が表示されます。
1 時間あたりのアクティブ ユーザー数 選択した期間における 1 時間あたりのユニーク アクティブ ユーザー数を示すトレンド折れ線グラフ。
1 日のアクティブ ユーザー数 選択した期間における 1 日あたりのユニーク アクティブ ユーザー数を示すトレンド折れ線グラフ。
1 週間のアクティブ ユーザー数 選択した期間の週ごとのユニーク アクティブ ユーザー数を示すトレンド折れ線グラフ。
1 か月のアクティブ ユーザー数 選択した期間における月別のアクティブ ユーザー数（28 日間のアクティブ ユーザー数）を示すトレンド折れ線グラフ。
ツールと API 呼び出し 合計トークン数 選択した期間に AI デベロッパー ツールによって消費された入力トークンと出力トークンの合計数。
1 日のトークン使用量 1 日あたりのトークン消費量の推移を示す折れ線グラフ。
1 日あたりの API 呼び出し数 AI デベロッパー ツールによる API 呼び出しの日別の数を示す折れ線グラフ。error_type ラベル別のエラーの内訳（割り当て上限、認証エラー、クライアント エラーなど）も表示されます。
1 日あたりのツール呼び出し数 AI デベロッパー ツールによって開始されたツール呼び出しの 1 日あたりの数を示す折れ線グラフ。
1 日あたりのツール呼び出しの承認数 ユーザーが承認して実行した、エージェントが提案したツール呼び出しの提案の日次数を示す折れ線グラフ。

次のステップ