Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

建立 Gemini Cloud Assist 調查

本頁說明如何建立及查看 Gemini Cloud Assist 調查。

事前準備

確認您已設定 Gemini Cloud Assist。
(選用) 確認您已啟用建議的 API：
- logging.googleapis.com
- monitoring.googelapis.com
- cloudresourcemanager.googleapis.com
如需啟用 API 的操作說明，請參閱「啟用及停用服務」。
如要取得建立調查所需的權限，請要求系統管理員授予您專案的「調查建立者」(roles/geminicloudassist.investigationCreator) IAM 角色。

這個預先定義的角色具備在專案中建立調查所需的權限。建立調查時，系統會授予您該調查的「調查擁有者」(roles/geminicloudassist.investigationOwner) IAM 角色，讓您查看調查結果。
可存取調查中的產品。

執行調查時，Gemini Cloud Assist 會使用您的憑證存取 API 和資訊。也就是說，調查的存取權僅限於您擁有的存取權。
如要調查應用程式，應用程式必須位於已設定應用程式管理功能的資料夾中。Gemini Cloud Assist 不支援在主機專案或單一專案界線中建立的應用程式。

建立調查

控制台

如要建立新的調查，請按一下與進入點相關聯的「調查」按鈕。建立調查的常見進入點是「Cloud Assist Investigations」(Cloud Assist 調查) 頁面。

前往 Cloud Assist Investigations
展開「設定調查」下拉式選單。
(選用) 輸入調查的調查名稱。

您選擇的名稱會用於識別調查記錄中的這項調查。如果略過這個步驟，系統會自動產生調查名稱。
使用「選取時間範圍」下拉式選單，選取要調查的時間範圍。

準確的開始時間有助於建立看似不相關事件之間的時間關聯，並提高接近開始時間的事件權重。如果不確定時間範圍，可以同時執行多項調查，並設定不同的時間範圍。
說明你遇到的問題。

您可以複製並貼上收到的確切錯誤訊息、使用自然語言說明遇到的問題，或同時提供這兩項資訊。
如果您的進入點支援應用程式調查，請使用「應用程式」欄位選擇要調查的應用程式。
(選用) 按一下「+ 新增資源」，選取受您所遇問題影響的資源。

您可以透過資源挑選器新增資源，也可以手動輸入資源。手動輸入資源時，請參閱資源的參考文件，確保格式正確無誤。

如果包含下列任何內容，您就無法繼續調查：
- 位於調查範圍外的專案或應用程式中的資源。
- 不支援的資源。
- 無法辨識的資源。
按一下「建立」即可開始調查。

系統會開啟調查的「詳細資料」頁面，並在頁面中顯示結果 (如有)。調查最多可能需要幾分鐘才能完成。如果離開調查詳細資料頁面，可以按一下「通知」按鈕 ()，查看調查狀態。

API

建立包含下列資訊的 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。如要確保資源格式正確，請參閱資源的參考說明文件。
如要完整呈現調查資源，請參閱資源規格。
取得存取權杖：
```
TOKEN=$(gcloud auth print-access-token)
```
使用 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觀察結果中加入的專案名稱。
在回應中，複製 revision 參數中的值。

使用 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 控制台中進行調查時，您可以從啟動調查的進入點，或從專案的調查記錄中，查看調查詳細資料。

調查包含下列各節：

調查總結

本節將提供問題的概要摘要、Gemini 的調查策略，以及調查的主要發現。
假設

這個部分包含一或多張假設資訊卡，這些假設是根據調查收集的資料和觀察結果而產生。如要查看各項假設的詳細資料，請按一下相關資訊卡中的「查看」按鈕。
- 假設的詳細資料包含「可能的問題」部分，以及「後續步驟」部分，說明可協助修正問題的動作，或提供其他疑難排解步驟，以確認或駁斥假設。
  - 如果假設中發現的問題支援補救措施，補救步驟中就會顯示「產生計畫」按鈕。按一下「產生計畫」，系統就會建立補救計畫，其中包含具體行動，例如gcloud指令或 Kubernetes 資訊清單。查看企劃書後，您可以按一下「執行」，執行企劃書中說明的動作。
調查結果

本節包含調查產生的觀察結果，並列出調查涉及的 Google Cloud 資源。觀察結果是根據程序執行手冊、記錄、服務中斷訊息和警告的審查結果而定。

「發現」部分會顯示 Gemini 用來生成假設的資訊，有助於修正調查結果。

您可以點選「編輯」按鈕修訂調查輸入內容，然後使用更新後的資訊重新執行調查。如果調查與多個執行作業相關聯，您可以使用「修訂版本」下拉式選取器，查看先前執行調查的結果。

如果您已訂閱支援方案，可以點選調查詳細資料頁面中的「要求支援」按鈕，提交支援案件。這樣一來，您就能自動填入案件詳細資料，並與支援工程師分享調查結果。

後續步驟

進一步瞭解調查。
查看及管理現有調查。