監控 VM 擴充功能

本文說明如何使用 Cloud Monitoring，監控 Compute Engine 執行個體上由 VM 擴充功能管理工具管理的 VM 擴充功能。監控擴充功能健康狀態和資源消耗量，有助於追蹤 CPU 和記憶體用量，並偵測整個 VM 機群的安裝或執行階段失敗。

本文將說明如何完成下列工作：

事前準備

  • 如果尚未設定驗證，請先完成設定。驗證程序會確認您的身分，以便您存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，您可以選取下列其中一個選項，向 Compute Engine 進行驗證：

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

    控制台

    使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，您不需要設定驗證機制。

    gcloud

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

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

    • REST

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

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

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

事前準備

監控擴充功能前，請先完成下列必要條件：

必要 IAM 權限

如要取得監控指標、建構資訊主頁及設定警告政策所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

如要取得監控指標、建構資訊主頁及設定警告政策所需的權限，請要求管理員授予您下列 IAM 角色：

  • 如要查看指標和資訊主頁：專案的Monitoring 檢視者 (roles/monitoring.viewer)
  • 如要建立及管理資訊主頁和警告政策：專案的 Monitoring 編輯者 (roles/monitoring.editor)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備監控指標、建立資訊主頁和設定警告政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

您必須具備下列權限，才能監控指標、建立資訊主頁及設定警告政策：

  • 如要查看資訊主頁，請在專案中執行下列操作： monitoring.dashboards.get
  • 如要建立資訊主頁： monitoring.dashboards.create 專案
  • 如要設定快訊： monitoring.alertPolicies.create 專案

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

VM 擴充功能的可用指標

您可以在 Monitoring 中使用下列指標監控 VM 擴充功能：

指標名稱 指標類型 說明
VM 擴充功能強制執行狀態 compute.googleapis.com/vm_extensions/extension/enforcement_status Compute Engine VM 擴充功能的強制執行狀態。標籤包括 extension_name 和 status。

如需擴充功能名稱清單，請參閱「支援的擴充功能」。

status 的可能值如下：

  • ENFORCEMENT_STATE_UNSPECIFIED
  • INSTALLING
  • INSTALL_FAILED
  • INSTALLED
  • ROLLING_BACK
  • ROLLBACK_FAILED
  • ROLLED_BACK
  • INCOMPATIBLE
  • REMOVING
  • SERVICE_DISABLED
  • APPLYING_CONFIG
VM 擴充功能健康狀態 compute.googleapis.com/vm_extensions/extension/health_status VM 擴充功能的健康狀態。標籤包括 extension_name 和 status。

如需擴充功能名稱清單，請參閱「支援的擴充功能」。

status 的可能值如下：

  • HEALTH_STATUS_UNSPECIFIED
  • STARTING
  • RUNNING
  • STOPPING
  • STOPPED
  • CRASHED
VM 擴充功能 CPU 最高用量 compute.googleapis.com/vm_extensions/extension/cpu/max_usage VM 擴充功能使用的 CPU 作業時間上限，以百分比表示。
VM 擴充功能記憶體用量上限 (位元組) compute.googleapis.com/vm_extensions/extension/memory/used_bytes VM 擴充功能使用的記憶體上限，以位元組為單位。

建立自訂監控資訊主頁

您可以建立 Monitoring 資訊主頁，並加入與用途最相關的 VM 擴充功能圖表。如要將圖表新增至資訊主頁，請完成下列步驟：

  1. 在 Google Cloud 控制台中，選取「Monitoring」：

    前往「Monioring」

  2. 在導覽窗格中，選取「Dashboards」(資訊主頁)。
  3. 按一下「Create dashboard」(建立資訊主頁)。
  4. 點選「新增小工具」。
  5. 在「新增小工具」視窗中，選取「資料」下方的「指標」。
  6. 如要選取指標，請展開「Select a metric」(選取指標) 選單，然後完成下列步驟：
    1. 在「Active resources」(使用中的資源) 部分，選取「VM Instance」(VM 執行個體)。
    2. 在「指標類別」部分，選取「Vm_extensions」。
    3. 在「Metric」(指標) 部分，選取指標，例如「VM Extension Health Status」(VM 擴充功能健康狀態)。如需可用指標清單，請參閱「VM 擴充功能的可用指標」。
    4. 按一下「套用」。

您可以在資訊主頁中新增任意數量的圖表。詳情請參閱「建立及管理自訂資訊主頁」。

設定警告政策

Monitoring 可讓您建立快訊，並在指標超過指定門檻時接收通知。舉例來說，當擴充功能的健康狀態變更為 CRASHED 時，您就會收到通知。

如要建立警告政策，請完成下列步驟：

  1. 在 Google Cloud 控制台中，選取「Monitoring」。

    前往「Monioring」

  2. 在導覽窗格中，選取「警告」。
  3. 點選「建立政策」。
  4. 在「Create alerting policy」(建立警告政策) 頁面中，完成下列步驟來設定警告觸發條件：
    1. 如要選取指標，請展開「Select a metric」(選取指標) 選單，然後完成下列步驟：
      1. 在「Active resources」(使用中的資源) 部分，選取「VM Instance」(VM 執行個體)。
      2. 在「指標類別」部分，選取「Vm_extensions」。
      3. 在「Metric」(指標) 部分，選取指標，例如「VM Extension Enforcement Status」(VM 擴充功能強制執行狀態)。如需可用指標清單，請參閱「VM 擴充功能的可用指標」。
      4. 按一下「套用」。
    2. 設定觸發條件，例如 status 標籤是否等於 INSTALL_FAILED。
  5. 按照提示新增通知管道，並為政策命名。
  6. 點選「建立政策」。

詳情請參閱「建立警告政策」。

後續步驟