Cloud Assist の調査を作成する

注: Gemini Cloud Assist のこのプレビュー版の使用には、 Google Cloud 契約（Google Cloud サービス固有の利用規約の pre-GA サービス利用規約、および Gemini for Google Cloud Trusted Tester プログラムの利用規約を含む）が適用されます。

このページでは、Gemini Cloud Assist の調査を作成して確認する方法について説明します。

始める前に

1. プロジェクトで次の API が有効になっていることを確認します。

   • cloudaicompanion.googleapis.com
   • cloudasset.googleapis.com
   • cloudresourcemanager.googleapis.com
   • geminicloudassist.googleapis.com
   • （推奨）logging.googleapis.com
   • （推奨）monitoring.googelapis.com

   API を有効にする方法については、サービスの有効化と無効化をご覧ください。

2. 調査を作成するために必要な権限を取得するには、プロジェクトに対する調査作者（roles/geminicloudassist.investigationCreator）IAM ロールを付与するよう管理者に依頼してください。

   この事前定義ロールには、プロジェクトで調査を作成するために必要な権限が含まれています。調査を作成すると、その調査に対する調査オーナー（roles/geminicloudassist.investigationOwner）IAM ロールが付与され、調査の結果を確認できるようになります。

3. 調査対象のプロダクトに対するアクセス権が必要です。

   調査を実行すると、Gemini Cloud Assist は認証情報を使用して API と情報にアクセスします。つまり、調査のアクセス権はユーザーが持つアクセス権に制限されます。

4. アプリケーションの調査を行う場合は、アプリケーションがアプリ対応フォルダ内に存在する必要があります。

調査を作成する

コンソール

重要: 調査機能は、複数のGoogle Cloud サービスとワークフローに統合されています。調査の作成手順は、このドキュメントで説明されている手順と若干異なる場合があります。たとえば、開始時間や問題の説明フィールドなどの情報を自動入力できるサービスもあります。

1. 新しい調査を作成するには、エントリ ポイントに関連付けられている [調査] ボタンをクリックします。通常、調査を作成する場合は [Cloud Assist の調査] ページを使用します。

   [Cloud Assist の調査] に移動

2. （省略可）調査の名前を入力します。

   選択した名前は、調査の履歴でこの調査を識別するために使用されます。この手順を省略すると、調査の名前が自動的に生成されます。

3. 発生している問題について記述します。

   受け取ったエラー メッセージを正確にコピーして貼り付けるか、発生している問題を自然言語で記述します。両方を行うこともできます。

4. 調査する問題が始まった開始時間を選択します。

   注: 正確な開始時刻を使用すると、無関係に見えるイベント間で時間ベースの関連付けを行うことができ、開始時刻に近いイベントの重要度が高まります。開始時刻が不明な場合は、開始時刻を変えて複数の調査を同時に実行できます。

5. （省略可）調査する問題が終了した終了時間を選択します。

6. アプリケーションの調査がエントリ ポイントでサポートされている場合は、[アプリケーション] フィールドを使用して、調査するアプリケーションを選択します。

   • アプリケーションの調査をサポートしていないエントリ ポイントの場合、現在のプロジェクトが [ターゲット プロジェクト] として表示され、変更できません。

7. （省略可）[+ リソースを追加] をクリックして、発生している問題の影響を受けるリソースを選択します。

   リソースを追加するには、リソース選択ツールを使用するか、手動で入力します。リソースを手動で入力する場合は、リソースの参照ドキュメントを参照して、正しい形式を使用していることを確認する必要があります。

   次のいずれかが含まれている場合、調査を続行することはできません。

   • 調査の範囲外のプロジェクトまたはアプリケーションにあるリソース。
   • サポートされていないリソース。
   • 認識されないリソース。

8. [作成] をクリックして、調査を開始します。

調査が完了するまでに数分かかることがあります。調査のステータスを確認するには、[通知] ボタン（）をクリックします。

API

1. 次の情報が含まれる JSON ファイルを作成します。

   {
   "title": "INVESTIGATION_NAME",
   "observations": {
     "user.project": {
       "id": "user.project",
       "observationType": "OBSERVATION_TYPE_STRUCTURED_INPUT",
       "observerType": "OBSERVER_TYPE_USER",
       "text": "PROJECT_NAME"
     },
     "user.input.text": {
       "id": "user.input.text",
       "observationType": "OBSERVATION_TYPE_TEXT_DESCRIPTION",
       "observerType": "OBSERVER_TYPE_USER",
       "timeIntervals": [
         {
           "startTime": "ISSUE_START_TIME"
         }
       ],
       "text": "ISSUE_DESCRIPTION",
       "relevantResources": [
         "AFFECTED_RESOURCE"
       ],
     },
   }
   

   次のように置き換えます。

   • INVESTIGATION_NAME: 調査の名前を入力します。例: Missing Cloud Storage bucket。

   • PROJECT_NAME: 調査を作成するプロジェクトの名前を入力します。例: my-project

   • ISSUE_START_TIME: 調査する問題が始まった日時を入力します。例: 2025-07-08T17:23:00Z

   • ISSUE_DESCRIPTION: 発生している問題の説明を入力します。受け取ったエラー メッセージを正確にコピーして貼り付けるか、発生している問題を自然言語で記述します。両方を行うこともできます。

   • AFFECTED_RESOURCE: 発生している問題に関連するリソースの名前を入力します。例: //storage.googleapis.com/my-bucketリソースに正しい形式を使用するには、リソースのリファレンス ドキュメントを参照してください。

   調査リソースの完全な表現については、リソース仕様をご覧ください。

2. アクセス トークンを取得します。

   TOKEN=$(gcloud auth print-access-token)

3. investigations.create メソッドを使用して調査を作成します。

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json' \
     "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"
   

   次のように置き換えます。

   • JSON_FILE_NAME: 前に作成した JSON ファイルのパスを入力します。例: Desktop/my-investigation.json

   • PROJECT_NAME: user.project 観測に含めたプロジェクト名と同じ名前を入力します。

4. レスポンスで、revision パラメータの値をコピーします。

5. investigations.revisions.run メソッドを使用して調査を実行します。

   curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"
   

   REVISION_RESOURCE は、revision パラメータからコピーした値に置き換えます。

調査が完了するまでに数分かかることがあります。調査のステータスを確認するには、investigations.revisions.run レスポンスで返された name パラメータの値をコピーし、operations.get リクエストの name パラメータでその値を使用します。

注: 調査を作成するユーザーまたはサービス アカウントには、作成プロセスの一環として、その特定の調査に対する調査オーナー（roles/geminicloudassist.investigationOwner）IAM ロールが付与されます。

調査を確認する

Google Cloud コンソールで調査を行う場合、調査が完了すると、調査を開始したエントリ ポイントまたはプロジェクトの調査の履歴から調査の詳細を確認できます。

調査には次のセクションがあります。

1. 問題

   このセクションには、問題の説明、タイムスタンプ、関連リソースのリストなど、調査結果の生成に使用された入力情報が含まれます。調査に関連付けられる可能性があるリソースリストには、次の 3 種類があります。

   • ユーザー提供のリソース: ユーザーが提供したリソース、または最初のエラーから取得したリソース。
   • 検出されたリソース: 調査の実行中に Gemini が調査した追加のリソース。
   • 関連リソース: Gemini が根本原因の仮説に関連すると判断したリソース。ユーザー提供のリソースが常に含まれます。

2. 観測結果

   このセクションには、調査によって生成された観測結果が含まれます。観測結果は、手順のランブック、ログ、停止メッセージ、アラートのレビューに基づいています。これらの観察結果から、Gemini は調査中の問題の根本原因に関する仮説を生成します。

3. 仮説

   このセクションには、調査で収集されたデータと観察結果に基づく仮説が 1 つ以上含まれます。仮説には、問題の可能性がある対象の概要と推奨の修正が含まれます。後者には、問題の修正に役立つアクションや、仮説を検証または反証するための追加のトラブルシューティング手順が含まれます。

[編集] ボタンを使用すると、調査の入力を修正できます。これにより、更新された情報を使用して調査を再実行できます。調査に複数の実行が関連付けられている場合は、[リビジョン] プルダウン セレクタを使用して、以前の調査の実行結果を確認できます。

サポート パッケージをご利用の場合は、調査の詳細ページにある [サポートをリクエスト] ボタンをクリックして、サポートケースを提出できます。その際、ケースの詳細を自動的に入力し、調査結果をサポート エンジニアと共有できます。

次のステップ

• 調査の詳細を確認する。
• 既存の調査の確認と管理。