Gemini Cloud Assist の調査を作成する

Google Cloud

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

始める前に

  1. Gemini Cloud Assist が設定されていることを確認します。

  2. （省略可）推奨される API が有効になっていることを確認します。

    • logging.googleapis.com
    • monitoring.googelapis.com
    • cloudresourcemanager.googleapis.com

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

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

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

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

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

  5. アプリケーションの調査を行う場合は、アプリケーション が アプリケーション管理用に構成されたフォルダ内に存在する必要があります。 Gemini Cloud Assist は、ホスト プロジェクトまたは単一プロジェクト境界に作成されたアプリケーションをサポートしていません。

調査を作成する

コンソール

  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 パラメータでその値を使用します。

調査を確認する

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

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

  1. 調査のまとめ

    このセクションには、問題の概要、Gemini が調査に使用した戦略、調査の主な結果が記載されています。

  2. 仮説

    このセクションには、調査で収集されたデータと観察結果に基づく仮説カードが 1 つ以上含まれています。各仮説の詳細を確認するには、関連するカードの [表示] ボタンをクリックします。

    • 仮説の詳細には、問題の可能性がある対象を説明する [内容] セクションと、問題の修正に役立つアクションや、仮説を検証または反証するための追加のトラブルシューティング手順を説明する [次のステップ] セクションが含まれています。

      • 仮説で特定された問題に対して修復がサポートされている場合は、修復手順に [プランを生成] ボタンが表示されます。[プランを生成] をクリックすると、gcloud コマンドや Kubernetes マニフェストなどの具体的なアクションを含む、段階的な修復プランが作成されます。プランを確認したら、[実行] をクリックして、プランに記載されているアクションを実行できます。

  3. 知見

    このセクションには、調査によって生成された観察結果と、 調査に関与する Google Cloud リソースが一覧表示されます。観測結果は、手順のランブック、ログ、停止メッセージ、アラートのレビューに基づいています。

    知見セクションには、Gemini が仮説の生成に使用した情報が表示されます。これは、調査を絞り込むのに役立ちます。

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

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

次のステップ