Gemini Code Assist の使用状況をモニタリングする

このドキュメントでは、組織での Gemini Code Assist の使用状況をモニタリングする方法について説明します。

Gemini Code Assist は、指標を自動的に収集して Cloud Monitoring に保存します。Cloud Monitoring のデータ可視化ツールと分析ツールを使用すると、組織内で Gemini Code Assist を使用している 1 日のアクティブ ユーザー数など、重要な質問に答えることができます。このダッシュボードは、Gemini Code Assist を有効にして使用すると自動的に利用可能になり、最も重要な指標の一部が含まれているため、集計された使用状況データをすばやく確認できます。

制限事項

Gemini Code Assist の指標データの記録は、IDE 内での Gemini Code Assist に対するユーザー インタラクションに限定されます。

始める前に

Google Cloud コンソールを使用して指標データを表示するために必要な権限を取得するには、プロジェクトに対するモニタリング閲覧者 （roles/monitoring.viewer）の IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

また、使用状況の指標を収集してデータをダッシュボードに送信するには、プロジェクトに対する Gemini Cloud Assist ユーザー（roles/geminicloudassist.user）ロールが必要です。

利用可能な指標

次の表に、Gemini Code Assist で使用可能な指標を示します。すべての指標は、cloudaicompanion.googleapis.com/Instance リソースタイプで報告されます。

一般的なアクティブ ユーザーに関する指標

これらの指標は、さまざまな期間に Gemini Code Assist サービスからのレスポンスが表示されたユーザーの数を追跡します。

指標 名前
code_assist/hourly_active_user_count 1 時間あたりのアクティブ ユーザー数
code_assist/daily_active_users 1 日のアクティブ ユーザー
code_assist/weekly_active_user_count 週間アクティブ ユーザー数
code_assist/twenty_eight_day_active_users 28 日間のアクティブ ユーザー数

コード候補とインタラクションの指標

これらの指標は、IDE または Gemini CLI でユーザーに表示され、ユーザーが承認した Gemini Code Assist コードの回答数をカウントします。

指標 名前
code_assist/code_suggestions_count コード候補の数
code_assist/code_suggestions_accepted_count 受け入れられたコード候補の数
code_assist/code_lines_accepted_count 受け入れられたコード行数
code_assist/chat_conversation_count チャットの会話
code_assist/chat_responses_count チャットの回答数
code_assist/chat_responses_accepted_count チャットの回答が受け入れられた回数

プラットフォームと使用状況の指標

これらの指標は、API 呼び出しや使用されたトークンなど、プラットフォーム レベルでの使用状況を追跡します。

指標 名前
code_assist/used_tokens_count 使用済みトークン数
code_assist/api_calls_count API 呼び出し回数

トークンと割り当ての指標

これらの指標は、組織のモデル トークンの使用量と超過使用量を追跡します。

指標 名前
usage/token_count トークンの合計数（入力、出力、キャッシュ）

プロジェクトの Gemini Code Assist 指標を表示する

Gemini Code Assist の集計指標を表示する手順は次のとおりです。

  1. Gemini Code Assist の概要ページに移動します。

    Gemini Code Assist の概要に移動

  2. 左側のナビゲーション メニューで [指標] をクリックします。

次のステップ