Gemini Cloud Assist の調査を作成する

このページでは、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. [作成] をクリックして、調査を開始します。

調査の [詳細] ページが開き、結果が利用可能になるとページに表示されます。調査が完了するまでに数分かかることがあります。調査の詳細ページを離れた場合は、[通知] ボタン（）をクリックして、調査のステータスを確認できます。

調査を確認する

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

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

  1. 調査のまとめ

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

  2. 仮説

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

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

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

  3. 検出結果

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

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

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

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

次のステップ