查看 MIG 和代管執行個體的相關資訊

使用本頁的方法，查看代管執行個體群組 (MIG) 的相關資訊，以及各個 MIG 內虛擬機器 (VM) 執行個體的相關資訊。

事前準備

  • 請詳閱限制，然後建立群組。
  • 如果尚未設定驗證，請先完成設定。驗證程序會確認您的身分，以便授予 Cloud de Confiance by S3NS 服務和 API 的存取權。如要從本機開發環境執行程式碼或範例，您可以選取下列其中一個選項，向 Compute Engine 進行驗證：

    請根據您打算如何使用本頁範例，選取對應的分頁標籤：

    控制台

    使用 Cloud de Confiance 控制台存取 Cloud de Confiance by S3NS 服務和 API 時，不需要設定驗證機制。

    gcloud

    1. 安裝 Google Cloud CLI，然後 使用聯合身分登入 gcloud CLI。 登入後，執行下列指令來初始化 Google Cloud CLI： 

      gcloud init
  • 設定預設區域和可用區。

    • REST

    如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

      安裝 Google Cloud CLI，然後 使用聯合身分登入 gcloud CLI。

    詳情請參閱 Cloud de Confiance 驗證說明文件中的「使用 REST 進行驗證」一節。

查看 MIG 相關資訊

您可以擷取群組本身的資訊，例如檢查附加至群組的政策，以及確認群組是否穩定或正在變更。如要瞭解 MIG 中的 VM 執行個體，請參閱「查看代管執行個體的相關資訊」。

列出 MIG

如要取得 MIG 清單，請使用控制台、gcloud CLI 或 REST。

控制台

  1. 前往 Cloud de Confiance 控制台的「Instance groups」(執行個體群組) 頁面。

    前往「Instance groups」(執行個體群組) 頁面。

    如果您已有執行個體群組，頁面會列出這些群組，包括 MIG 和非代管執行個體群組。

    「Group type」(群組類型) 欄會指定群組是代管、有狀態或非代管。有狀態群組類型也是代管執行個體群組。

gcloud

列出專案中的所有 MIG：

gcloud compute instance-groups managed list

REST

如果是可用區 MIG，請呼叫 instanceGroupManagers.list 方法：

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers

如果是區域 MIG，請呼叫 regionInstanceGroupManagers.list 方法。

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers

查看 MIG 的屬性

如要查看特定 MIG 的資訊，包括其政策 (例如群組的自動修復和更新政策)，請使用控制台、gcloud CLI 或 REST。

如要查看群組的 id 值，請使用 gcloud CLI 或 Compute Engine API。

控制台

  1. 前往 Cloud de Confiance 控制台的「Instance groups」(執行個體群組) 頁面。

    前往「Instance groups」(執行個體群組) 頁面。

    如果您已擁有執行個體群組，頁面會列出這些群組。該頁面也會列出非代管執行個體群組。

  2. 在清單的「Name」(名稱) 欄下方，按一下要檢查的 MIG 名稱。系統隨即開啟一個頁面，頁面中包含 MIG 的屬性及群組包含之執行個體的清單。

  3. 按一下「詳細資料」，查看群組設定。

gcloud

如要取得特定群組的資訊：

gcloud compute instance-groups managed describe instance-group \
    [--zone zone | --region region]

這個指令會傳回群組的詳細資料，包括附加的政策。

使用 --format 旗標限制輸出內容。舉例來說，下列指令只會傳回群組的自動配置器設定 (如果有的話)。

gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"

REST

如果是可用區 MIG，請呼叫 instanceGroupManagers.get 方法。如果是區域 MIG，請呼叫 regionInstanceGroupManagers.get 方法。

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

回應會包含群組的詳細資料，包括附加的政策，但不含群組的自動調度資源政策。雖然自動調度資源是 MIG 的功能，但屬於獨立的 REST 資源。

自動調度資源政策

如果自動配置器已附加至群組，自動配置器資源會列在群組的 status.autoscaler 欄位中。

如要取得該自動配置器的資訊，請針對可用區 MIG 呼叫 autoscalers.get 方法，或針對區域 MIG 呼叫 regionAutoscalers.get 方法。自動配置器資源的網址包含其名稱，預設為自動配置器附加的群組名稱。舉例來說，您可以對區域 MIG 的自動配置器提出下列要求：

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name

檢查 MIG 是否穩定

如果沒有任何執行個體正在進行或排定變更，且 MIG 本身未經修改，則 MIG 處於穩定狀態。

在開始執行與應用程式相關的工作之前，請先檢查 MIG 的穩定性，因為這類工作需要所有執行個體都處於健康狀態並提供服務。舉例來說，您可能需要確認 MIG 穩定，再開始排定工作、傳送流量或指派金鑰範圍給 VM。

檢查群組的 status.isStable 欄位值，確認代管執行個體群組中的所有執行個體都正常運作。

gcloud

使用 describe 指令：

gcloud compute instance-groups managed describe instance-group-name \
    [--zone zone | --region region]

gcloud CLI 會傳回 MIG 的詳細資訊，包括 status.isStable 欄位。

如要暫停指令碼，直到 MIG 穩定為止，請使用 wait-until 指令搭配 --stable 旗標。例如：

gcloud compute instance-groups managed wait-until instance-group-name \
    --stable \
    [--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable

MIG 的 status.isStable 設為 true 後，指令就會傳回。

REST

如果是區域 MIG，請向 instanceGroupManagers.get 方法發出 GET 要求：

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get

如果是區域代管執行個體群組，請將 zones/zone 替換為 regions/region：

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get

這些要求會傳回 MIG 的詳細資訊，包括 status.isStable 欄位。

status.isStable 設為 false，表示變更已生效、待處理，或 MIG 本身正在修改。

當 status.isStable 為 true 時，則代表：

  • MIG 中的執行個體未進行任何類型的變更，且所有執行個體的 currentAction 均為 NONE。
  • MIG 中的執行個體沒有待處理的變更。
  • MIG 本身不會遭到修改。

請注意，MIG 的穩定性取決於多項因素，因為 MIG 可以透過多種方式修改。例如：

  • 由您發出推出新執行個體範本的要求。
  • 您提出要求，在 MIG 中建立、刪除、調整大小或更新執行個體。
  • 自動配置器會要求調整 MIG 大小。
  • 自動修復工具資源正在替換 MIG 中一或多個健康狀態不良的執行個體。
  • 在區域性 MIG 中，部分執行個體正在重新分配。

所有動作完成後，該 MIG 的 status.isStable 會再次設為 true。

如果為個別 VM 執行個體，請參閱檢查代管執行個體的狀態。

檢查 MIG 的修復設定

如要查看 MIG 的修復設定，請選取下列其中一個選項：

控制台

  1. 前往 Cloud de Confiance 控制台的「Instance groups」(執行個體群組) 頁面。

    前往「Instance groups」(執行個體群組) 頁面

  2. 按一下要查看的 MIG 名稱。系統隨即開啟一個頁面，當中包含 MIG 屬性和群組中的 VM 執行個體清單。
  3. 點按「Details」(詳細資料) 分頁標籤。

  4. 在「VM instance lifecycle」(VM 執行個體生命週期) 區段中，檢查下列欄位的值：

    • Default action on failure：如果值為 No action，則系統不會自動修復失敗的 VM。

    • 健康狀態檢查失敗時：

      • 如果值為「No action」(不採取任何動作)，則表示自動修復功能已關閉。
      • 如果值為「Default action」(預設動作)，且「Default action on failure」(失敗時的預設動作) 欄位的值為「No action」(不採取任何動作)，則自動修復功能也會關閉。

    • 在 VM 執行個體修復期間變更可用區：如果選取這個選項，且 MIG 無法在原始可用區修復 VM，則 MIG 會在其他所選可用區修復該 VM。

gcloud

請使用 describe 方法，如下所示：

gcloud compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)" \
    --zone=zone

更改下列內容：

  • instance-group：MIG 的名稱。
  • zone：如果是可用區 MIG，請指定可用區。如果是區域 MIG，請使用 --region=region 旗標。

在輸出內容中，查看下列值：

  • defaultActionOnFailure：如果值為 DO_NOTHING，則系統不會自動修復失敗的 VM。
  • onFailedHealthCheck：如果值為下列任一項，則自動修復功能會關閉。
    • DEFAULT_ACTION，前提是 defaultActionOnFailure 欄位的值為 DO_NOTHING
    • DO_NOTHING
  • allowChangingZone：如果值為 YES，且 MIG 無法在原始可用區修復 VM，則 MIG 會在其他 MIG 選取的可用區中修復該 VM。

如果關閉 MIG 中故障和健康狀態不良 VM 的修復功能，輸出內容範例如下：

  instanceLifecyclePolicy:
    defaultActionOnFailure: DO_NOTHING
    forceUpdateOnRepair: NO
    onFailedHealthCheck: DEFAULT_ACTION
    onRepair:
      allowChangingZone: YES

REST

如果是可用區 MIG，請使用 instanceGroupManagers.get 方法；如果是區域 MIG，請使用 regionInstanceGroupManagers.get 方法。

如要查看可用區 MIG 中 VM 故障時的 MIG 動作，請發出下列呼叫：

GET https://compute.googleapis.com/compute/v1/projects/project_ID/zones/zone/instanceGroupManagers/instance_group

在回應主體中，檢查下列欄位的值：

  • defaultActionOnFailure：如果值為 DO_NOTHING，則系統不會自動修復失敗的 VM。
  • onFailedHealthCheck：如果值為下列任一項，則自動修復功能會關閉。
    • DEFAULT_ACTION，前提是 defaultActionOnFailure 欄位的值為 DO_NOTHING
    • DO_NOTHING
  • allowChangingZone：如果值為 YES，且 MIG 無法在原始可用區修復 VM，則 MIG 會在其他 MIG 選取的可用區中修復該 VM。

如果關閉 MIG 中故障和健康狀態不良 VM 的修復功能，輸出內容範例如下：

...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "DO_NOTHING",
  "onFailedHealthCheck": "DEFAULT_ACTION",
  "onRepair": {
    "allowChangingZone": "YES"
  }
}
...

如果修復功能已關閉，而您想重新開啟，請參閱「開啟修復或自動修復功能」。

查看過往的自動修復作業

如果您已設定自動修復功能，可以查看過去的自動修復事件。

監控滾動式更新

如果您已啟動滾動式更新，並想知道更新何時完成，請參閱「監控更新」。

查看有狀態設定

如果您已設定有狀態 MIG，並想查看設定，請參閱「查看有狀態設定」。

查看執行個體分布情形

如要瞭解執行個體在各可用區和機型之間的分布情形，您可以查看特定 MIG 的執行個體分布情形，或多個 MIG 的匯總資料。如需操作說明，請參閱「監控 MIG 中的執行個體分布情形」。

查看 TPU 配量的狀態

建立含有 TPU VM 的 MIG 或增加 MIG 大小時，MIG 會建立處於 PENDING 狀態的 TPU VM。當容量可用且符合工作負載政策設定時，VM 會先轉換為 PROVISIONING 和 STAGING 狀態，然後才達到 RUNNING 狀態。這項轉換作業可能需要一些時間，具體取決於群組中的執行個體數量。

如要監控建立 slice 的進度，您可以在 MIG 詳細資料中使用下列欄位，查看 TPU VM 的狀態和拓撲。

  • currentInstanceStatuses 欄位會顯示各個執行個體生命週期狀態中的執行個體數量。如需生命週期狀態清單，請參閱「VM 執行個體生命週期」。

    如要查看特定執行個體的狀態，請參閱「列出 MIG 的代管執行個體」。

  • appliedAcceleratorTopologies 欄位會顯示 Slice 形成狀態。如需這個欄位的有效值清單，請參閱本文的「加速器拓撲狀態」一節。

如要查看 currentInstanceStatuses 和 appliedAcceleratorTopologies 欄位，請使用下列其中一種方式：

控制台

  1. 前往 Cloud de Confiance 控制台的「Instance groups」(執行個體群組) 頁面。

    前往「Instance groups」(執行個體群組) 頁面

  2. 選取 MIG 名稱。按一下名稱會開啟頁面，其中包含執行個體群組的屬性及群組內執行個體的清單。

  3. 選取「詳細資料」分頁標籤，查看群組設定。

gcloud

如要查看 TPU slice 的狀態，請使用 gcloud compute instance-groups managed describe 指令。在輸出內容中，尋找 currentInstanceStatuses 和 acceleratorTopologyState 欄位。

  • 如為可用區 MIG，請執行下列指令：

    gcloud compute instance-groups managed describe MIG_NAME \
    --zone=ZONE

  • 如為區域性 MIG，請執行下列指令：

    gcloud compute instance-groups managed describe MIG_NAME \
    --region=REGION

更改下列內容：

  • MIG_NAME：MIG 的名稱。
  • ZONE：MIG 所在的可用區。
  • REGION：MIG 所在的區域。

REST

如要查看 TPU slice 的狀態，請使用下列其中一種方法傳送 GET 要求：

  • 如果是可用區 MIG，請使用 instanceGroupManagers.get 方法，如下所示：

    GET https://compute.googleapis.com/compute/v1/projects/<var>PROJECT_ID</var>/zones/<var>ZONE</var>/instanceGroupManagers/<var>MIG_NAME</var>

  • 如為區域 MIG，請使用 regionInstanceGroupManagers.get 方法。

    GET https://compute.googleapis.com/compute/v1/projects/<var>PROJECT_ID</var>/regions/<var>REGION</var>/instanceGroupManagers/<var>MIG_NAME</var>

更改下列內容：

  • PROJECT_ID：專案 ID。
  • ZONE：MIG 所在的可用區。
  • REGION：MIG 所在的區域。
  • MIG_NAME：MIG 的名稱。

輸出內容範例

輸出結果會與下列內容相似：

  {
    ...
    "name": "example-mig",
    ...
    "currentActions": {
      "none": 0,
      "creating": 2,
      "creatingWithoutRetries": 0,
      "verifying": 0,
      "recreating": 0,
      "deleting": 0,
      "abandoning": 0,
      "restarting": 0,
      "refreshing": 0,
      "suspending": 0,
      "resuming": 0,
      "stopping": 0,
      "starting": 0
    },
    ...
      "bulkInstanceOperation": {
        "inProgress": true,
        "lastProgressCheck": {
          "error": {
            "errors": [
              {
                "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
                "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
              }
            ]
          },
          "timestamp": "2026-03-18T18:35:32.720925Z"
        }
      },
      "appliedAcceleratorTopologies": [
        {
          "state": "ACTIVATING"
        }
      ],
      "currentInstanceStatuses": {
        "pending": 2
      },
    "targetSize": 2,
    "targetSizePolicy": {
      "mode": "BULK"
    },
    ...
  }

如果 bulkInstanceOperation.lastProgressCheck.error 欄位回報 ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS 錯誤，表示可用區中沒有足夠的 TPU 資源可建立切片，MIG 正在等待資源可用。

加速器拓撲狀態

acceleratorTopologyState 欄位會指出 TPU 切片的目前狀態。可能具有下列值：

狀態 說明
INCOMPLETE 切片尚未形成。MIG 目標大小為 0。
ACTIVATING 正在建立切片。MIG 正在佈建執行個體，並啟用晶片間互連 (ICI) 功能。MIG 目標大小等於切片大小。
ACTIVE 切片已完全運作。MIG 具備所需數量的 RUNNING 狀態執行個體。
REACTIVATING 主機或晶片間互連 (ICI) 發生問題，導致切片失敗。Compute Engine 會嘗試重新啟用加速器拓撲。MIG 目標大小等於切片大小，且所有執行個體都處於 REPAIRING 狀態。如要進一步瞭解故障復原，請參閱「Slice 可用性和故障復原」。
DEACTIVATING Compute Engine 正在取消佈建執行個體，因此配量會變形。MIG 目標大小設為 0，且至少有一個執行個體處於 STOPPING、STOPPED 或 TERMINATED 狀態。
FAILED

配量失敗，原因可能是下列其中一項條件 (視使用的佈建模式或預留模式而定)。

  • 所有容量模式預留項目：
    • 主機故障。在這種情況下，受影響的執行個體會進入 REPAIRING 狀態。
    • ICI 失敗。在這種情況下，執行個體會維持在 RUNNING 狀態。
  • 隨選、彈性啟動、Spot 和預留項目 (不含所有容量模式預留項目)：
    • 手動刪除或停止執行個體，包括從作業系統內執行。
    • Spot VM 先占。

如果配量轉換為 FAILED 狀態，您可以採取下列任一做法來復原：

  • 刪除並重新建立 MIG。
  • 將 MIG 大小調整為 0，然後增加至所需大小。

查看 MIG 內代管 VM 執行個體的詳細資料

本節說明如何查看 MIG 中代管執行個體的各種詳細資料。

列出 MIG 的代管執行個體

如要查看群組中的代管執行個體清單 (包括狀態和範本)，請使用控制台、gcloud CLI 或 REST。

控制台

  1. 前往 Cloud de Confiance 控制台的「Instance groups」(執行個體群組) 頁面。

    前往「Instance groups」(執行個體群組) 頁面。

    如果您已擁有執行個體群組，頁面會列出這些群組。該頁面也會列出非代管執行個體群組。

  2. 在清單的「Name」(名稱) 欄下方，按一下要檢查的 MIG 名稱。系統隨即開啟一個頁面，頁面中包含 MIG 的屬性及群組包含之執行個體的清單。

gcloud

使用 gcloud CLI list-instances 子指令。

gcloud compute instance-groups managed list-instances instance-group \
    [--zone zone | --region region]

這個指令會傳回執行個體清單及其詳細資料，包括目前的狀態、執行個體範本和上次發生的錯誤。

輸出內容範例如下：

NAME: example-mig-cmx0
ZONE: us-central1-a
STATUS: RUNNING
HEALTH_STATE:
ACTION: NONE
INSTANCE_TEMPLATE: example-instance-template
VERSION_NAME:
LAST_ERROR:

NAME: example-mig-qdwq
ZONE: us-central1-b
STATUS: PENDING
HEALTH_STATE:
ACTION: CREATING
INSTANCE_TEMPLATE: example-instance-template
VERSION_NAME:
LAST_ERROR: Error ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS: Waiting for resources. Currently there are not enough resources available to fulfill the request.
...

如果執行個體處於 PENDING 狀態，並顯示 ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS 錯誤，表示正在等待資源分配。

REST

如果是可用區 MIG，請建構對 instanceGroupManagers.listManagedInstances 方法的 GET 要求，並加入 MIG 名稱：

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group

如果是區域性 (多可用區) MIG，請使用 regionInstanceGroupManagers.listManagedInstances 方法。

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

系統的回應會包括執行個體清單及其詳細資料，包括目前的狀態和執行個體範本。

以下是回應範例：

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-cmx0",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "2605978238927153426",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "name": "example-mig-cmx0"
    },
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-qdwq",
      "instanceStatus": "PENDING",
      "currentAction": "CREATING",
      "lastAttempt": {
        "errors": {
          "errors": [
            {
              "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
              "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
            }
          ]
        }
      }
      "id": "334721596325800210",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },

      "name": "example-mig-qdwq"
    }
  ]
}

如果執行個體處於 PENDING 狀態，並出現 ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS 錯誤，表示正在等待資源分配。

查看代管執行個體的狀態

在 MIG 中建立、刪除或修改執行個體時，群組「排定」動作後，作業會傳回 DONE 狀態。DONE 狀態並不代表執行個體已完全建立、刪除或更新。如要確認執行個體的實際狀態，您必須驗證其狀態或查看群組狀態。

如要查看 MIG 中執行個體的詳細資料，包括狀態和群組目前執行的任何動作，請使用 Google Cloud CLI 或 REST。

gcloud

所有代管執行個體

如要查看群組中所有執行個體的狀態和目前動作，請使用 list-instances 指令。

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

這個指令會傳回群組中的執行個體清單，包括狀態、目前動作和其他詳細資料：

NAME: vm-instances-9pk4
ZONE: us-central1-f
STATUS:
HEALTH_STATE:
ACTION: CREATING
INSTANCE_TEMPLATE: my-new-template
VERSION_NAME:
LAST_ERROR:

NAME: vm-instances-h2r1
ZONE: us-central1-f
STATUS: STOPPING
HEALTH_STATE:
ACTION: DELETING
INSTANCE_TEMPLATE: my-old-template
VERSION_NAME:
LAST_ERROR:

除非您已設定健康狀態檢查，否則「HEALTH_STATE」欄會顯示空白。

特定代管執行個體

如要查看群組中特定執行個體的狀態和目前動作，請使用 describe-instance 指令。

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--zone=ZONE | --region=REGION]

指令會傳回執行個體的詳細資料，包括執行個體狀態、目前動作，以及有狀態 MIG 的保留狀態：

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

REST

對區域或可用區 MIG 資源呼叫 listManagedInstances 方法。舉例來說，如要查看可用區 MIG 資源中的執行個體詳細資料，可以提出下列要求：

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

呼叫會傳回 MIG 的執行個體清單，包括每個執行個體的 instanceStatus 和 currentAction。

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
      "instanceStatus": "RUNNING",
      "currentAction": "REFRESHING",
      "id": "5317605642920955957",
      "version": {
        instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template"
      },
      "name": "vm-instances-prvp"
    },
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
      "instanceStatus": "RUNNING",
      "currentAction": "REFRESHING",
      "id": "2800161036826218547",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template"
      },
      "name": "vm-instances-w2t5"
    }
  ]
}

如果您設定健康狀態檢查，回應也會包含 instanceHealth 欄位。

如要查看有效的 instanceStatus 欄位值清單，請參閱「VM 執行個體生命週期」。

如果執行個體正在進行某種變更，MIG 會將執行個體的 currentAction 欄位設為下列其中一項動作，協助您追蹤變更進度。否則，currentAction 欄位會設為 NONE。

可能的 currentAction 值：

  • ABANDONING。系統正在從 MIG 移除執行個體。
  • CREATING：執行個體目前正在建立。
  • CREATING_WITHOUT_RETRIES。系統正在建立執行個體，不會重試。如果第一次嘗試未建立執行個體，MIG 就不會再次嘗試替換執行個體。
  • DELETING：執行個體目前正在刪除。
  • RECREATING。正在替換執行個體。
  • REFRESHING：執行個體正從其目前目標集區中移除，並正讀入至現有的目標集區清單中 (此清單可能會與現有目標集區相同或不同)。
  • RESTARTING：系統正在使用 stop 和 start 方法重新啟動該執行個體。
  • RESUMING：執行個體在暫停後正在恢復。
  • STARTING。執行個體在停止後正在啟動。
  • STOPPING。正在停止執行個體。
  • SUSPENDING。正在暫停執行個體。
  • VERIFYING：執行個體已建立，目前正受到驗證。
  • NONE：目前並未對執行個體執行任何動作。

如要檢查整個群組是否穩定或正在經歷變更，請參閱檢查群組狀態一文。

檢查健康狀態

如果您已為 MIG 設定自動修復功能，可以查看各個 VM 的健康狀態。請參閱檢查健康狀態一文。

列出執行個體錯誤

如果代管執行個體發生錯誤，您可以查看這些錯誤，診斷並緩解原因。

使用 Cloud de Confiance 控制台、gcloud CLI 或 REST 列出錯誤。

控制台

  1. 前往 Cloud de Confiance 控制台的「Instance groups」(執行個體群組) 頁面。

    前往「Instance groups」(執行個體群組)

  2. 在清單的「Name」(名稱) 欄下方，按一下要檢查的 MIG 名稱。系統隨即開啟一個頁面，頁面中包含 MIG 的屬性及群組包含之執行個體的清單。

  3. 按一下「Errors」(錯誤)。

gcloud

使用 instance-groups managed list-errors 指令列出群組中最近發生的錯誤

gcloud compute instance-groups managed list-errors instance-group-name \
    [--zone zone | --region region]

例如：

gcloud compute instance-groups managed list-errors example-group \
    --region us-west1
 
INSTANCE_URL                                                                                        ACTION    ERROR_CODE      ERROR_MESSAGE                                                                                     TIMESTAMP                      INSTANCE_TEMPLATE                                                                                                            VERSION_NAME

https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.156-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.081-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
...

REST

針對可用區或區域 MIG，建構 listErrors 方法的 listErrors 要求。GET

例如：

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100

要求會收到類似以下的回應：

{
 "items": [
  {
   "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded.  Limit: 50.0 in zone us-central1-c."
   },
   "timestamp": "2019-01-03T18:47:28.457-08:00",
   "instanceDetails" : {
    "instance": "zones/us-central1-c/instances/example-mig-m1sz",
    "action": "CREATING",
    "version": {
     "name": "example-version-name",
     "instanceTemplate": "global/instanceTemplates/example-template",
    }
   }
  }
 ],
 ...
 "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA=="
}

listErrors API 支援清單分頁。如要取得下一頁結果，請在後續要求中使用某個回應的 nextPageToken 欄位。例如：GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100&nextPageToken=next-page-token，將 next-page-token 替換為從先前回應取得的權杖。

可能的錯誤包括但不限於下列示例：

  • 無法建立新執行個體，原因如下：
    • 無法使用先占容量。
    • 配額不足，例如特定區域的 CPU。
    • 與群組相關聯的網路已達 VM 執行個體數量上限。
    • 執行個體範本 properties.disks[].initializeParams.sourceImage 欄位中指定的磁碟映像檔已刪除，或權限已變更。
    • 與專案相關聯的帳單帳戶信用卡拒絕付款。
  • 無法刪除現有執行個體，原因如下：
    • 群組使用的服務帳戶沒有 compute.instances.delete 權限。
    • 要求的並行刪除作業過多，超出頻率限制。
  • 目標集區已刪除，因此無法將執行個體新增至目標集區。

檢查這類錯誤後，您可以加以緩解。例如：

  • 將工作負載移至有先占容量的其他可用區。
  • 申請提高特定區域的配額。
  • 將 compute.instances.delete 權限新增至群組使用的服務帳戶。

如果 MIG 觸發的動作失敗 (例如自動配置器嘗試增加群組大小時發生錯誤)，群組可能會立即重試該動作。如果最後一次立即重試失敗，MIG 會記錄錯誤，您可以列出執行個體錯誤來查看。經過一段輪詢時間後，群組會再次重試失敗的操作。如果錯誤持續發生，可能會記錄多次。

Compute Engine 會保留過去 8 天內最近的 500 個錯誤，即使基礎執行個體已不存在或無法建立也一樣。

檢查 VM 執行個體是否屬於 MIG

如要檢查特定 VM 是否為群組成員，可以使用控制台或 REST。

控制台

  1. 前往 Cloud de Confiance 控制台的「VM instances」(VM 執行個體) 頁面。

    前往 VM 執行個體

  2. 按一下要檢查的執行個體，存取其 VM 執行個體詳細資料。
  3. 如果 VM 執行個體是 MIG 的成員，該 MIG 的名稱會顯示在「In use by」(使用者) 標題下方。如果 VM 執行個體不屬於任何群組，執行個體詳細資料頁面就不會顯示「In use by」(使用者) 標題。

REST

請參閱查看 VM 執行個體參照網址一文。

或者，如要判斷 VM 是否為或曾為 MIG 成員，請在執行個體的中繼資料中尋找下列兩個中繼資料鍵：

  • instance-template 表示建立 VM 時使用的範本。
  • created-by 表示建立 VM 的 MIG。

即使您捨棄執行個體，除非手動移除，否則 VM 仍會保留這些中繼資料項目。

舉例來說，如果有名為 random-instance-biy 的 VM，而您想知道該 VM 是否由 MIG 建立，可以描述執行個體並尋找中繼資料索引鍵。例如：

gcloud compute instances describe random-instance-biy \
    --zone us-central1-f

gcloud CLI 會傳回類似以下的回應：

canIpForward: false
cpuPlatform: Intel Ivy Bridge
creationTimestamp: '2016-08-24T14:11:38.012-07:00'
...
metadata:
  items:
  - key: instance-template
    value: projects/123456789012/global/instanceTemplates/example-it
  - key: created-by
    value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata

查看代管執行個體的保留狀態

如果您設定了有狀態的 MIG，並想查看每個代管執行個體的保留狀態，請參閱「查看有狀態設定和保留狀態」。

後續步驟