このドキュメントでは、組織内の AI デベロッパー ツール（Google Antigravity や Antigravity CLI など）の使用状況指標とテレメトリーを表示する方法について説明します。これらの指標には、ユーザーの導入状況、トークンの使用量、API 呼び出し、ツールの実行状況が表示されます。
始める前に
AI デベロッパー ツールの指標を表示する前に、次の前提条件を満たしていることを確認してください。
AI デベロッパー ツールを有効にする: AI デベロッパー ツールの指標を表示するには、組織がプロジェクトの AI デベロッパー ツールを有効にする必要があります。AI デベロッパー ツールを有効にするをご覧ください。
請求書発行 Cloud 請求先アカウント: プロジェクトで Cloud Billing が有効になっており、請求書発行アカウントが必要です。Cloud 請求先アカウントのタイプをご覧ください。
対応エディション: Gemini Enterprise Standard、Plus、Standard Emerging Market、従量課金制のいずれかのエディションのサブスクリプションが必要です。
必要なロール:Google Cloud コンソールの [デベロッパー ツール指標] ページにアクセスするには、Gemini Enterprise 管理者（
roles/discoveryengine.agentspaceAdmin）ロールが必要です。
指標ダッシュボードにアクセスする
Google Cloud コンソールで AI デベロッパー ツールの指標を表示する手順は次のとおりです。
Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。
AI デベロッパー ツールを有効にした Google Cloud プロジェクトを選択します。
ナビゲーション メニューで、[デベロッパー ツール指標] をクリックします。
ダッシュボードの右上にある期間コントロールを使用して、レポートの期間を調整します。
管理 説明 期間セレクタ メニュー デフォルトでは、ダッシュボードには [過去 1 日間] のデータが表示され、自動ライブ更新が有効になっています。メニューをクリックして、次のいずれかの操作を行います。 -
[相対時間] フィルタ フィールドにカスタム期間を直接入力します（例:
15m、1h、1d、1w）。 - [今日]、[昨日]、[過去 15 分間]、[過去 30 分間]、[過去 1 時間]、[過去 3 時間]、[過去 6 時間]、[過去 12 時間]、[過去 1 日間]、[過去 2 日間]、[過去 7 日間]、[過去 14 日間] のいずれかの相対期間のプリセットを選択します。
- [開始時間と終了時間] をクリックして、レポート期間のカスタムの開始日時と終了日時を指定します。
- [Around a time] をクリックして、日付と時刻を指定し、そのタイムスタンプを中心とした指標を表示します。
- [タイムゾーン] をクリックして、グラフの別の表示タイムゾーン（PDT（UTC-7）など）を選択します。
左右の矢印 メニューで選択した期間だけ、レポートの期間を過去（ ）または未来（）に移動します。たとえば、[過去 1 日間] が選択されている場合、をクリックすると、グラフが 1 日分戻ります。期間を縮小 [] をクリックして、特定の期間を縮小します。すべてのグラフが更新され、ズームアウトされた期間のデータが表示されます。ビューを拡大してリセットするには、期間セレクタ メニューから期間を選択します。 自動更新 相対期間を表示しているときに、ダッシュボード データの自動ライブ更新のオンとオフを切り替えます。絶対期間（カスタムの開始時間と終了時間、過去の期間など）が選択されている場合、自動更新は無効になります。これは、絶対期間では自動更新がサポートされていないためです。 -
[相対時間] フィルタ フィールドにカスタム期間を直接入力します（例:
グラフデータを探索する
[デベロッパー ツール指標] ダッシュボードの各グラフには、時系列の検査、指標とログの関連付け、基盤となるデータの分析に役立つインタラクティブなコントロールが用意されています。
| 管理 | 説明 |
|---|---|
| 情報 | グラフのタイトルの横にある [情報] をクリックして、グラフの指標クエリに適用されているフィルタ、グループ化、集計プロパティの詳細を表示します。 |
| アラート ポリシーを作成する | 指標の折れ線グラフで、グラフのツールバーの [アラート ポリシーを作成] をクリックして、Cloud Monitoring でグラフの時系列クエリが事前入力されたアラート ワークフローを開きます。次に、指標のしきい値条件と通知チャネルを構成できます。 |
| データを探索 | グラフのツールバーで、[データを探索] をクリックして、Metrics Explorer で指標クエリを開きます。Metrics Explorer では、さまざまなディメンションにわたって基盤となる時系列クエリを検査、フィルタ、グループ化、変更したり、カスタマイズしたビューをカスタム ダッシュボードに保存したりできます。 |
| 全画面表示で確認する | グラフ ツールバーで [その他のグラフ オプション] をクリックし、[全画面で表示] を選択してグラフを全画面表示にすると、時系列データと凡例データを詳しく調べることができます。 |
| 関連するログを検査する |
指標データを、ほぼ同じ時間帯に書き込まれたログエントリと関連付けて、アクティビティとエラーのトラブルシューティングを行うことができます。
|
利用可能な指標
次の表に、ダッシュボードで使用できるすべての指標を示します。
| セクション | 指標名 | 説明 |
|---|---|---|
| アクティブ ユーザー（導入） | アクティブ ユーザーとは、レポート期間中に少なくとも 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 呼び出しの 1 日あたりの数を示す折れ線グラフ。error_type ラベル（割り当て上限、認証エラー、クライアント エラーなど）別のエラーの内訳も含まれます。 |
|
| Daily Tool Calls | AI デベロッパー ツールによって開始されたツール呼び出しの 1 日あたりの数を示す折れ線グラフ。 | |
| Daily Tool Calls Accepted（1 日あたりのツール呼び出しの受け入れ数） | ユーザーが受け入れて実行した、エージェントが提案したツール呼び出しの候補の 1 日あたりの数を示す折れ線グラフ。 | |
制限事項
AI デベロッパー ツールの指標には次の制限が適用されます。
- [Daily Tool Calls] 指標と [Daily Tool Calls Accepted] 指標にデータが表示されない。
次のステップ
- 利用可能なツールと機能の詳細については、AI デベロッパー ツールの概要をご覧ください。
- デベロッパー ツールの設定方法をご確認ください。詳細については、AI デベロッパー ツールの設定を構成するをご覧ください。
- カスタムロールを使用してアクセスを管理する方法を学習する。詳細については、AI デベロッパー ツールのカスタムロールを作成するをご覧ください。