Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

使用 VM 擴充功能管理工具政策安裝及管理作業套件代理程式

您可以使用 VM 擴充功能管理工具政策，在全域或特定區域中，為一組 Compute Engine VM 安裝及管理作業套件代理程式。舉例來說，您可以使用這些政策執行下列工作：

全車隊安裝：在下列項目上安裝 Ops Agent：
- Google Cloud 專案中一或多個可用區的所有 VM。
- 全球所有 VM (位於您的 Google Cloud 專案中)。
- 可用區中由標籤識別的 VM 子集。
- 專案中各可用區的 VM 子集，以標籤識別。 Google Cloud
版本管控：
- 將 Ops Agent 更新至最新版本。
- 將 Ops Agent 版本固定在特定版本。
設定管理：將自訂設定套用至政策管理的所有 VM 上的 Ops Agent。

您可以使用 VM 擴充功能管理工具建立政策，聲明要在 VM 上安裝哪些擴充功能。Ops Agent 是其中一個可用的擴充功能。如果 Ops Agent 是透過 VM 擴充功能管理工具安裝，VM 擴充功能管理工具政策就能管理 2.58.0 以上版本的 Ops Agent。這些政策無法管理 2.58.0 之前的 Ops Agent 版本、透過其他方式安裝的 Ops Agent 執行個體，或是任何版本的舊版 Monitoring 代理程式或 Logging 代理程式。

您可以使用Google Cloud 控制台或 Google Cloud CLI (gcloud)，建立及管理區域 VM 擴充功能政策。您可以使用 gcloud 建立及管理全域 VM 擴充功能政策。

事前準備

開始使用 VM 擴充功能管理工具擴充功能政策前，請先完成下列步驟：

查看支援的作業系統，確認作業系統支援 Ops Agent 和 VM 擴充功能管理工具。
授予使用 VM 擴充功能管理工具所需的角色。
如要使用指令列介面建立及管理擴充功能政策，請安裝 Google Cloud CLI。
解除安裝 VM 上已安裝的所有可觀測性代理程式。

查看支援的作業系統

嘗試使用 VM 擴充功能管理工具政策管理 Ops Agent 前，請先確認目標作業系統與 Ops Agent 和 VM 擴充功能管理工具都相容。

VM 擴充功能管理工具支援 Ops Agent 支援的所有作業系統，但 SUSE Linux Enterprise Server (SLES) 和 Ubuntu 除外。如要進一步瞭解 Ops Agent 支援的作業系統，請參閱「作業系統」一文。

如果您的作業系統同時支援 Ops Agent 和 VM 擴充功能管理工具，請繼續閱讀本文。

啟用使用 Ops Agent 時所需的 API

如要使用 Ops Agent 寫入記錄和指標，請務必在 Google Cloud 專案中啟用 Cloud Logging API 和 Cloud Monitoring API。

啟用 API 時所需的角色

如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

授予使用 Ops Agent 必須具備的角色

如要取得使用 Ops Agent 寫入記錄和指標所需的權限，請要求管理員在服務帳戶中授予下列 IAM 角色：

如要寫入記錄：記錄記錄寫入者 (roles/logging.logWriter)
如要寫入指標： Monitoring 指標寫入者 (roles/monitoring.metricWriter)

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

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

如要進一步瞭解角色和 Ops Agent，請參閱「授權 Ops Agent」。

授予使用 VM 擴充功能管理工具所需的角色

如要取得建立、查看、修改及刪除 VM 擴充功能政策所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

如要建立擴充功能政策，請指派： VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin)
如要查看擴充功能政策，請按照下列步驟操作：
- VM 擴充功能政策檢視者 (roles/compute.vmExtensionPolicyViewer)
- VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin)
如要修改擴充功能政策，您需要： VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin)
如要刪除擴充功能政策，請使用「VM 擴充功能政策管理員」 (roles/compute.vmExtensionPolicyAdmin)。

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

這些預先定義的角色具備建立、查看、修改及刪除 VM 擴充功能政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要建立、查看、修改及刪除 VM 擴充功能政策，必須具備下列權限：

建立擴充功能政策： compute.vmExtensionPolicies.create
如要查看擴充功能政策，請按照下列方式操作： compute.vmExtensionPolicies.list
如要查看擴充功能政策的詳細資料，請按照下列步驟操作： compute.vmExtensionPolicies.get
如要修改擴充功能政策： compute.vmExtensionPolicies.update
如要刪除擴充功能政策： compute.vmExtensionPolicies.delete

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

如要進一步瞭解 Compute Engine 中的 IAM 角色和權限，請參閱「Compute Engine 角色和權限」。

安裝 Google Cloud CLI

您可以使用 Google Cloud 控制台或 Google Cloud CLI (gcloud) 建立及管理 VM 擴充功能政策。如要使用 gcloud，請先安裝 Google Cloud CLI。

如要查看已安裝的元件，請執行下列指令：

gcloud components list

如要確認您使用的是最新版本，請執行下列指令：

gcloud components update

卸載所有可觀測性代理

在建立 VM 擴充功能管理工具策略來管理 VM 上的 Ops Agent 之前，請確保 VM 上沒有 Ops Agent 或舊版監控代理程式和 Logging 代理程式的執行個體。在同一部 VM 上執行 Ops Agent 和舊版代理程式，可能會導致重複擷取記錄或指標擷取作業發生衝突。

如果您使用擴充功能政策在 VM 上安裝 Ops Agent，但該 VM 已安裝其他可觀測性代理程式，政策會安裝代理程式，但系統偵測到衝突，因此代理程式無法執行。

移除現有代理程式的方式，取決於代理程式的安裝方式。

由 VM 管理員 OS 設定政策安裝的代理程式，包括：
- 在Google Cloud 建立 VM 時，使用控制台安裝的 Ops Agent。
- 透過正式發布的 VM 管理員 OS 設定政策安裝 Ops Agent。
- Ops Agent，或透過 Beta 版 VM 管理員 OS 設定政策安裝的舊版 Monitoring 代理程式或 Logging 代理程式。
如要瞭解如何使用這些政策識別 VM，請參閱「找出適用於 Ops Agent OS 政策的 VM」。

如要瞭解如何解除安裝 Ops Agent 及移除 OS 設定政策，請參閱「在受 Ops Agent OS 政策控管的 VM 上解除安裝 Ops Agent」。
使用安裝指令碼手動安裝的代理程式。如要瞭解如何解除安裝代理程式，請參閱下列文章：
- Ops Agent：解除安裝代理程式。
- 舊版 Monitoring 代理程式：解除安裝代理程式。
- 舊版 Logging 代理程式：解除安裝代理程式。

建立 VM 擴充功能政策，安裝 Ops Agent

建立 VM 擴充功能政策，在 Compute Engine 虛擬機器 (VM) 機群中自動安裝及管理 Ops Agent。透過定義策略，您可以確保在符合您指定的條件（例如虛擬機器標籤）的任何虛擬機器上安裝和維護特定的擴充功能（例如 Ops Agent）。

政策衝突與優先事項

VM 擴充功能管理工具會為每項新政策設定優先順序，數字越小代表優先順序越高；預設優先順序為 1000。VM 可以套用多項擴充功能政策 (例如 Ops Agent)，但 VM 只能套用一項 Ops Agent 擴充功能政策。

VM 擴充功能管理工具會使用優先順序，解決套用至 VM 的政策之間的衝突。如要進一步瞭解解決程序，請參閱「政策優先順序和衝突解決方式」。

全域政策的政策推出計畫

VM 擴充功能管理工具全域政策會使用推出計畫，決定政策如何發布至目標 VM。推出計畫分為兩種：

預先定義的發布計畫。預先定義的發布計畫有兩種，可透過 gcloud CLI 指令的 --rollout-predefined-plan 選項值選擇。
- 緩慢推出：在一段時間內，逐步在不同可用區部署 Ops Agent。建議採用這個推出計畫。
  
  使用 --rollout-predefined-plan=slow_rollout 選項指定這項發布計畫。
- 快速推出：立即將 Ops Agent 部署至所有區域和可用區的所有目標 VM。
  
  使用 --rollout-predefined-plan=fast_rollout 選項指定這項發布計畫。
自訂推出計畫，使用 gcloud CLI 指令的 --rollout-custom-plan 選項指定。

將自訂推出計畫新增至 Google Cloud 專案中的推出計畫集，即可建立自訂推出計畫；詳情請參閱 Compute Engine API 方法 rolloutPlans.insert。

如要進一步瞭解推出計畫，請參閱全域政策的推出計畫。

在所有 VM 中安裝最新版 Ops Agent

如要建立政策，在可用區或全域的所有 VM 上安裝最新版 Ops Agent，並在發布新版本時更新 Ops Agent，請按照下列步驟操作：

控制台

如要建立區域政策，可以使用 Google Cloud 控制台。

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
點選「+ 建立」。
在「Name」(名稱) 欄位中，輸入政策名稱。
選用：在「Description」(說明) 欄位中輸入政策的說明。
在「Priority」欄位中指定優先順序編號，以解決政策之間的衝突。數字越小越優先。預設值為 1000。
在「Zone」(可用區) 清單中，選取要套用這項政策的可用區。
在「管理擴充功能」部分中，按一下「新增擴充功能」，然後執行下列操作：
1. 從「擴充功能」清單中選取「Google Cloud's Extension for Ops Agent」。
2. 將「版本」欄位留空。
點選「建立」。

gcloud

如要建立區域或全域政策，可以使用 gcloud CLI。

區域

使用下列 gcloud compute zone-vm-extension-policies create 指令建立政策：

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

gcloud compute zone-vm-extension-policies create 會採用 --version 選項。如果省略 --version 選項，政策會安裝最新版本，並在發布新版本時更新 Ops Agent。

全球

使用下列 gcloud compute global-vm-extension-policies create 指令建立政策：

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

gcloud compute global-vm-extension-policies create 會採用 --version 選項。如果省略 --version 選項，政策會安裝最新版本，並在發布新版本時更新 Ops Agent。

將所有 VM 中的 Ops Agent 固定在特定版本

如要建立政策，在可用區或全域的所有 VM 上安裝特定版本的 Ops Agent，請按照下列步驟操作：

控制台

如要建立區域政策，可以使用 Google Cloud 控制台。

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
點選「+ 建立」。
在「Name」(名稱) 欄位中，輸入政策名稱。
選用：在「Description」(說明) 欄位中輸入政策的說明。
在「Priority」欄位中指定優先順序編號，以解決政策之間的衝突。數字越小越優先。預設值為 1000。
在「Zone」(可用區) 清單中，選取要套用這項政策的可用區。
在「管理擴充功能」部分中，按一下「新增擴充功能」，然後執行下列操作：
1. 從「擴充功能」清單中選取「Google Cloud's Extension for Ops Agent」。
2. 從「版本」清單中選取要安裝的版本。使用 2.58.0 以上版本。
點選「建立」。

gcloud

如要建立區域或全域政策，可以使用 gcloud CLI。

區域

使用下列 gcloud compute zone-vm-extension-policies create 指令建立政策：

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

VERSION：要安裝的 Ops Agent 版本。使用 2.58.0 以上版本。

如果省略 --version 選項，政策就會安裝最新版本，並在發布新版本時更新 Ops Agent，如安裝最新版本的範例所示。

全球

使用下列 gcloud compute global-vm-extension-policies create 指令建立政策：

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

VERSION：要安裝的 Ops Agent 版本。使用 2.58.0 以上版本。

如果省略 --version 選項，政策就會安裝最新版本，並在發布新版本時更新 Ops Agent，如安裝最新版本的範例所示。

如需 Ops Agent 版本清單，請參閱 GitHub 上的 Ops Agent 版本頁面。

在具有特定標籤的 VM 中安裝 Ops Agent

如要建立政策，在可用區或全域中具有特定標籤的 VM 上安裝最新版 Ops Agent，請按照下列步驟操作：

控制台

如要建立區域政策，可以使用 Google Cloud 控制台。

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
點選「+ 建立」。
在「Name」(名稱) 欄位中，輸入政策名稱。
選用：在「Description」(說明) 欄位中輸入政策的說明。
在「Priority」欄位中指定優先順序編號，以解決政策之間的衝突。數字越小越優先。預設值為 1000。
在「Zone」(可用區) 清單中，選取要套用這項政策的可用區。
在「擴充功能」部分中，按一下「新增擴充功能」，然後執行下列操作：
1. 從「擴充功能」清單中選取「Google Cloud's Extension for Ops Agent」。
2. 將「版本」欄位留空。
在「Target VM instances」(目標 VM 執行個體) 區段中，選取要套用政策的 VM。如要選取具有特定標籤的 VM，請按一下「新增標籤」，然後新增鍵/值組合。
點選「建立」。

gcloud

如要建立區域或全域政策，可以使用 gcloud CLI。

區域

使用 --inclusion-labels 選項，透過 gcloud compute zone-vm-extension-policies create 指令指定以逗號分隔的清單，其中包含鍵/值組合：

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

KEY1=VALUE1,KEY2=VALUE2：以半形逗號分隔的鍵/值組合清單，用於定義選取器的納入標籤。VM 必須具備選取器中指定的所有標籤 (邏輯 AND)，才會納入其中。如果您多次指定 --inclusion_labels 選項，政策就會以符合任一選取器中所有標籤的 VM 為目標 (邏輯 OR)。如果省略這個選項，政策會以指定可用區中的所有 VM 為目標。

全球

使用 --inclusion-labels 選項，透過 gcloud compute global-vm-extension-policies create 指令指定以逗號分隔的清單，其中包含鍵/值組合：

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

KEY1=VALUE1,KEY2=VALUE2：以半形逗號分隔的鍵/值組合清單，用於定義選取器的納入標籤。VM 必須具備選取器中指定的所有標籤 (邏輯 AND)，才會納入其中。如果您多次指定 --inclusion_labels 選項，政策就會以符合任一選取器中所有標籤的 VM 為目標 (邏輯 OR)。如果省略這個選項，政策會以指定可用區中的所有 VM 為目標。

在所有 VM 中安裝 Ops Agent，並使用自訂設定

如要建立政策，在區域或全域的所有 VM 上安裝最新版 Ops Agent，並為 Ops Agent 提供自訂設定，請按照下列步驟操作：

控制台

如要建立區域政策，可以使用 Google Cloud 控制台。

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
點選「+ 建立」。
在「Name」(名稱) 欄位中，輸入政策名稱。
選用：在「Description」(說明) 欄位中輸入政策的說明。
在「Priority」欄位中指定優先順序編號，以解決政策之間的衝突。數字越小越優先。預設值為 1000。
在「Zone」(可用區) 清單中，選取要套用這項政策的可用區。
在「擴充功能」部分中，按一下「新增擴充功能」，然後執行下列操作：
1. 從「擴充功能」清單中選取「Google Cloud's Extension for Ops Agent」。
2. 將「版本」欄位留空。
3. 在「設定檔內容」欄位中，輸入 Ops Agent 的 YAML 設定字串。
點選「建立」。

gcloud

如要建立區域或全域政策，可以使用 gcloud CLI。

區域

使用 --config-from-file 選項搭配 gcloud compute zone-vm-extension-policies create 指令，指定設定檔：

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

OPS_AGENT_CONFIG_PATH：包含 Ops Agent YAML 設定字串的檔案路徑。您執行 gcloud 指令的環境中必須有這個檔案。

Ops Agent 的設定 YAML 可能很長。將設定放入檔案並將檔案傳遞至 gcloud CLI，比嘗試在指令列輸入格式正確的 YAML 更不容易出錯。建立政策後變更這個檔案不會更新政策，如要更新政策，請使用 gcloud compute zone-vm-extension-policies update 指令。

全球

使用 --config-from-file 選項搭配 gcloud compute global-vm-extension-policies create 指令，指定設定檔：

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

OPS_AGENT_CONFIG_PATH：包含 Ops Agent YAML 設定字串的檔案路徑。您執行 gcloud 指令的環境中必須有這個檔案。

Ops Agent 的 YAML 設定可能很長。將設定放入檔案並將檔案傳遞至 gcloud CLI，比嘗試在指令列輸入格式正確的 YAML 更不容易出錯。建立政策後變更這個檔案不會更新政策，如要更新政策，請使用 gcloud compute global-vm-extension-policies update 指令。

如果您在建立或更新擴充功能政策時，為 Ops Agent 提供自訂設定，政策就會部署具有自訂設定的 Ops Agent。您不必手動重新啟動代理程式。

設定會與擴充功能政策一併儲存，因此請勿在設定中加入密碼等私密資料。由於設定會與擴充功能政策一起儲存，因此修改設定檔不會變更代理程式的設定。您必須使用適當的 gcloud 指令，更新政策儲存的設定：

如為區域政策，請使用 gcloud compute zone-vm-extension-policies update 指令。
如為全域政策，請使用 gcloud compute global-vm-extension-policies update 指令。

為 Ops Agent 提供自訂設定時，VM 擴充功能管理工具會將設定複製到目標 VM 上，供 Ops Agent 使用的使用者指定設定檔位置：

Linux：/etc/google-cloud-ops-agent/config.yaml
Windows：C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

如果 VM 上有 config.yaml 檔案，擴充功能政策會覆寫該檔案。

如要瞭解如何使用Google Cloud 控制台和 gcloud CLI 建立 VM 擴充功能政策，請參閱「建立擴充功能政策來安裝 VM 擴充功能」。

以較高優先順序透過快速推出計畫安裝 Ops Agent (僅限全域)

如要建立全域政策，以高於預設優先順序和快速推出計畫安裝最新版 Ops Agent，請使用下列 gcloud compute global-vm-extension-policies create 指令：

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

在 Google Cloud 專案的可用區子集中安裝 Ops Agent (僅限全域)

如要建立全域政策，並只套用至Google Cloud 專案中的部分區域，您必須使用自訂推出計畫，指定要套用政策的區域。如要瞭解如何建立自訂推出計畫，請參閱「關於推出計畫」。如要指定一組區域，請在建立推出計畫時使用 locationSelector.includedLocations 欄位。

如要建立使用自訂推出計畫的擴充功能政策，請使用下列 gcloud compute global-vm-extension-policies create 指令：

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

CUSTOM_PLAN_NAME：與自訂推出計畫相關聯的名稱。

透過更新 VM 擴充功能政策管理 Ops Agent

如要變更政策管理 Ops Agent 的方式，請更新政策。更新政策後，VM 擴充功能管理工具通常會在 1 分鐘內，將變更推送到所有適用的 VM。如果您修改納入標籤，Ops Agent 可能會根據 VM 是否符合更新後的標籤，在新 VM 上安裝，或從現有 VM 解除安裝。

以下各節說明如何管理 Ops Agent，以執行下列操作：

更新所有 VM 上代理程式的固定版本
修改所有 VM 的作業套件代理程式設定

更新可用區中所有 VM 的 Ops Agent 固定版本

如要變更可用區中所有 VM 的固定 Ops Agent 版本，請按照下列步驟操作：

控制台

如要建立區域政策，可以使用 Google Cloud 控制台。

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
選取要更新的政策。
按一下 [編輯]。
在「管理擴充功能」部分執行下列操作：
1. 選取「Google Cloud's Extension for Ops Agent」。
2. 修改「版本」欄位。使用 2.58.0 以上版本。
3. 按一下「完成」。
按一下 [儲存]。

gcloud

如要建立區域或全域政策，可以使用 gcloud CLI。

區域

使用 gcloud compute zone-vm-extension-policies update 搭配 --version 選項指令，即可修改固定的代理程式版本。

使用 gcloud 更新政策時，要求會完全取代現有政策。您省略的選填欄位會還原為預設值，而不是保留修改後政策的現有值。

如要透過政策變更可用區中所有 VM 安裝的 Ops Agent 版本，請使用下列指令：

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --version=ops-agent=VERSION

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

VERSION：要安裝的 Ops Agent 版本。使用 2.58.0 以上版本。如需版本清單，請參閱 GitHub 上的 Ops Agent版本頁面。

如果省略 --version 選項，政策就會安裝最新版本，並在發布新版本時更新 Ops Agent，如安裝最新版本的範例所示。

全球

使用 gcloud compute global-vm-extension-policies update 搭配 --version 選項指令，即可修改固定的代理程式版本。

使用 gcloud 更新政策時，要求會完全取代現有政策。您省略的選填欄位會還原為預設值，而不是保留修改後政策的現有值。

如要透過全域政策變更所有 VM 上安裝的 Ops Agent 版本，請使用下列指令：

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

VERSION：要安裝的 Ops Agent 版本。使用 2.58.0 以上版本。如需版本清單，請參閱 GitHub 上的 Ops Agent版本頁面。

如果省略 --version 選項，政策就會安裝最新版本，並在發布新版本時更新 Ops Agent，如安裝最新版本的範例所示。

修改所有 VM 的 Ops Agent 設定

如要修改 Ops Agent 的設定，請執行下列步驟：

控制台

如要建立區域政策，可以使用 Google Cloud 控制台。

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
選取要更新的政策。
按一下 [編輯]。
在「管理擴充功能」部分執行下列操作：
1. 選取「Google Cloud's Extension for Ops Agent」。
2. 修改「設定檔內容」欄位。
3. 按一下「完成」。
按一下 [儲存]。

gcloud

如要建立區域或全域政策，可以使用 gcloud CLI。

區域

使用 gcloud compute zone-vm-extension-policies update，並加上 --config-from-file 選項或 --config 選項，指定新設定。

使用 gcloud 更新政策時，要求會完全取代現有政策。您省略的任何選填欄位都會還原為預設值，而不是保留修改後政策的現有值。

如要透過政策變更可用區中所有 VM 上安裝的 Ops Agent 設定，請使用下列指令：

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

OPS_AGENT_CONFIG_PATH：包含 Ops Agent YAML 設定字串的檔案路徑。您執行 gcloud 指令的環境中必須有這個檔案。

Ops Agent 的 YAML 設定可能很長。將設定放入檔案並將檔案傳遞至 gcloud CLI，比嘗試在指令列中輸入格式正確的 YAML 更不容易出錯。

全球

使用 gcloud compute global-vm-extension-policies update，並加上 --config-from-file 選項或 --config 選項，指定新設定。

使用 gcloud 更新政策時，要求會完全取代現有政策。您省略的選填欄位會還原為預設值，而不是保留修改後政策的現有值。

如要透過政策變更所有 VM 上安裝的 Ops Agent 設定，請使用下列指令：

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

OPS_AGENT_CONFIG_PATH：包含 Ops Agent YAML 設定字串的檔案路徑。您執行 gcloud 指令的環境中必須有這個檔案。

Ops Agent 的設定 YAML 可能很長。將設定放入檔案並將檔案傳遞至 gcloud CLI，比嘗試在指令列中輸入格式正確的 YAML 更不容易出錯。

如果您在建立或更新擴充功能政策時，為 Ops Agent 提供自訂設定，政策就會部署具有自訂設定的 Ops Agent。您不必手動重新啟動代理程式。

如為區域政策，請使用 gcloud compute zone-vm-extension-policies update 指令。
如為全域政策，請使用 gcloud compute global-vm-extension-policies update 指令。

為 Ops Agent 提供自訂設定時，VM 擴充功能管理工具會將設定複製到 Ops Agent 用於目標 VM 上使用者指定設定檔的位置：

Linux：/etc/google-cloud-ops-agent/config.yaml
Windows：C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

如果 VM 上有 config.yaml 檔案，擴充功能政策會覆寫該檔案。

如要瞭解如何使用Google Cloud 控制台和 gcloud CLI 管理 VM 擴充功能政策，請參閱「透過更新 VM 擴充功能政策修改擴充功能」。

擴充現有全球政策，納入新區域 (僅限全球政策)

建立全域政策並推出後，如果在新區域中建立 VM，VM 擴充功能管理工具不會自動將政策套用至新區域中的 VM。如要在新區域中納入 VM，您必須重新啟動全域政策推出程序。

如要重新啟動全域政策推出作業，請使用 gcloud compute global-vm-extension-policies update 指令，並提供 --rollout-retry-uuid=UUID 選項。

舉例來說，假設您使用下列指令建立並推出全域政策：

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

如要將政策擴展至先前未使用的區域中建立的 VM，請使用下列指令重新啟動推出作業：

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

UUID：用於識別重試要求的通用唯一識別碼 (UUID)。您可以使用任何 UUID 產生器建立 UUID。詳情請參閱「重試推出」。

更新通用政策，排除一組區域 (僅限通用政策)

如要更新全域政策，排除Google Cloud 專案中的部分區域，您必須使用新的自訂推出計畫，指定要套用政策的區域。如要瞭解如何建立自訂推出計畫，請參閱「關於推出計畫」。如要指定一組區域，請在建立推出計畫時使用 locationSelector.includedLocations 欄位。

如要更新使用自訂推出計畫的擴充功能政策，請使用下列 gcloud compute global-vm-extension-policies update 指令：

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

NEW_CUSTOM_PLAN_NAME：與更新後的自訂推出計畫相關聯的名稱。
UUID：用於識別重試要求的通用唯一識別碼 (UUID)。您可以使用任何 UUID 產生器建立 UUID。詳情請參閱「重試推出」。

刪除 VM 擴充功能政策，解除安裝 Ops Agent

如要解除安裝 Ops Agent，請刪除管理該代理程式的 VM 擴充功能政策。如果另有一項優先順序較低的有效政策套用至 VM，且該政策也管理 Ops Agent，則代理程式會根據優先順序較低的政策，繼續安裝在該 VM 上。

VM 擴充功能管理工具會在政策刪除後一分鐘內，從所有可存取的 VM 移除 Ops Agent。如果無法存取 VM，VM 擴充功能管理工具會略過刪除代理程式的步驟。如果 VM 恢復運作，VM 擴充功能管理工具就會移除代理程式。

控制台

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
選取要刪除的政策。
點選「刪除」。
在確認對話方塊中點按「刪除」。

gcloud

區域

如要刪除管理 Ops Agent 的 VM 擴充功能政策，請使用 gcloud compute zone-vm-extension-policies delete 指令：

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

全球

如要刪除管理 Ops Agent 的全域 VM 擴充功能政策，請使用 gcloud compute global-vm-extension-policies delete 指令：

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

如要加速已開始的刪除推出作業，請發出使用 fast_rollout 計畫的新刪除指令。您也必須指定 --rollout-retry-uuid=UUID 選項：

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

UUID：用於識別重試要求的通用唯一識別碼 (UUID)。您可以使用任何 UUID 產生器建立 UUID。詳情請參閱「重試推出」。

擷取 VM 擴充功能政策的相關資訊

您可以擷取現有 VM 擴充功能政策的下列資訊：

Google Cloud 專案中的所有政策清單。
特定政策的設定資訊。

控制台

前往 Google Cloud 控制台的「擴充功能政策」頁面：
前往「擴充功能政策」

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
這個頁面會列出專案中的所有 VM 擴充功能政策。
如要查看特定擴充功能政策的詳細資料，請按一下政策名稱。

gcloud

區域

列出 VM 擴充功能政策

如要列出可用區中所有 VM 擴充功能政策的相關資訊，請使用 gcloud compute zone-vm-extension-policies list：

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

在指令中替換下列變數：

PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。
PAGE_SIZE_INTEGER：每頁要列出的政策數量，例如 2。如要進一步瞭解排序和篩選選項，請參閱 gcloud compute zone-vm-extension-policies list。

說明具名 VM 擴充功能政策

如要擷取區域中具名政策的設定，請使用 gcloud compute zone-vm-extension-policies describe：

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。
ZONE：目標可用區，例如 us-central1-f。

全球

列出全域 VM 擴充功能政策

如要列出全域 VM 擴充功能政策的相關資訊，請使用 gcloud compute global-vm-extension-policies list：

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

在指令中替換下列變數：

PROJECT_ID：專案的 ID。
PAGE_SIZE_INTEGER：每頁要列出的政策數量，例如 2。如要進一步瞭解排序和篩選選項，請參閱 gcloud compute global-vm-extension-policies list。

說明具名的全域 VM 擴充功能政策

如要擷取區域中具名政策的設定，請使用 gcloud compute global-vm-extension-policies describe：

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

在指令中替換下列變數：

POLICY_NAME：VM 擴充功能政策的名稱。
PROJECT_ID：專案的 ID。

如要瞭解如何使用Google Cloud 控制台和 gcloud CLI 擷取 VM 擴充功能政策的相關資訊，請參閱「查看擴充功能政策」。

驗證 Ops Agent 的安裝作業

本節將說明如何執行下列操作：

驗證 Ops Agent 安裝狀態或版本
確認 Ops Agent 正在收集遙測資料

驗證 Ops Agent 安裝狀態或版本

如要判斷 Ops Agent 的狀態或版本，請使用下列任一Google Cloud 控制台頁面：

Compute Engine

前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面：
前往「VM instances」(VM 執行個體) 頁面

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Compute Engine」的結果。
從清單中選取 VM。
按一下「可觀測性」分頁標籤。

Cloud Monitoring

前往 Google Cloud 控制台的「VM Instances」(VM 執行個體) 頁面：
前往「VM Instances」(VM 執行個體)

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
選取「清單」檢視。

在 VM 上安裝 Ops Agent 並開始收集記錄和指標後，代理程式的狀態會標示為綠色勾號，顯示在「Ops Agent」標籤旁。

如要判斷已安裝的代理程式版本，請將滑鼠游標懸停在 Compute Engine 或 Monitoring 資訊主頁上的「作業套件代理程式」標籤上。

確認 Ops Agent 是否正在收集遙測資料

如果已成功安裝 Ops Agent 並正常運作，代理程式就會將指標傳送至 Cloud Monitoring，並將記錄檔傳送至 Cloud Logging。

如要瞭解如何驗證指標收集作業，請參閱「代理程式正在執行，但系統未擷取資料」。
如要瞭解如何確認記錄收集作業是否成功，請參閱「確認記錄收集作業是否成功」。

重新啟動透過擴充功能政策安裝的 Ops Agent

如果 Ops Agent 是由 VM 擴充功能管理工具安裝及管理，則不會由作業系統的系統管理服務管理，也就是 Linux 上的 systemd 或 Windows 上的 Windows 服務管理工具。因此，Linux systemctl 指令和 Windows *-Service 指令不適用於透過擴充功能政策安裝的 Ops Agent。

如要重新啟動透過擴充功能政策安裝的 Ops Agent，請執行下列其中一項操作：

重新建立政策。
1. 刪除政策。刪除政策會停止並解除安裝 Ops Agent。
2. 建立新政策。新政策會安裝並啟動 Ops Agent。
使用暫時性、優先順序較高的政策。如果原始政策會影響大量 VM，但您只想在少數 VM 上重新啟動 Ops Agent，請為這些 VM 新增標籤，並設定新政策來依標籤篩選。

舉例來說，如果優先順序為 1000 的政策無法在 VM 上啟動 Ops Agent，您可以在 VM 中新增 status=failed 等標籤。然後建立優先順序較高的新政策，例如 500。舉例來說，Google Cloud CLI 指令可能如下所示：
區域
gcloud compute zone-vm-extension-policies create POLICY_NAME \ --project=PROJECT_ID \ --zone=ZONE \ --extensions=ops-agent \ --inclusion-labels=status=failed \ --priority=500 \ --config-from-file=ops-agent=/usr/ops-agent-config.yaml
在指令中替換下列變數：
- POLICY_NAME：VM 擴充功能政策的名稱。
- PROJECT_ID：專案的 ID。
- ZONE：目標可用區，例如 us-central1-f。
全球
gcloud compute global-vm-extension-policies create POLICY_NAME \ --project=PROJECT_ID \ --extensions=ops-agent \ --inclusion-labels=status=failed \ --priority=500 \ --config-from-file=ops-agent=/usr/ops-agent-config.yaml \ --rollout-predefined-plan=fast_rollout
在指令中替換下列變數：
- POLICY_NAME：VM 擴充功能政策的名稱。
- PROJECT_ID：專案的 ID。
新政策成功安裝 Ops Agent 後，請刪除政策並從 VM 移除標籤。由於原始政策仍有效，Ops Agent 會繼續安裝在 VM 上。

在 VM 上啟用客體代理程式偵錯記錄檔

VM 擴充功能管理工具政策會使用 Compute Engine 訪客代理程式，以 VM 擴充功能的形式管理 Ops Agent。如要瞭解如何啟用客體代理程式的偵錯記錄，請參閱「查看客體代理程式的偵錯記錄」。

排解擴充功能政策問題

本節提供相關資訊，協助您排解使用擴充功能政策管理 Ops Agent 時遇到的問題：

gcloud compute zone-vm-extension-policies 指令失敗
已建立擴充功能政策，但 Ops Agent 狀態為「未偵測到」
Linux systemctl 和 Windows 服務管理員不適用於 Ops Agent

如要瞭解如何排解 Ops Agent 問題，請參閱「排解 Ops Agent 問題」。

`gcloud compute zone-vm-extension-policies` 指令失敗

如果 gcloud compute zone-vm-extension-policies 指令失敗，回應會提供疑難排解建議。修正錯誤訊息建議的指令標記或引數錯誤。

如果指令輸出內容提及 IAM 權限不足，請參閱「授予使用 VM 擴充功能管理工具所需的角色」一文，瞭解必要角色和權限。

擴充功能政策已建立，但 Ops Agent 狀態為「未偵測到」

您已成功建立擴充功能政策，但 Ops Agent 在 VM 上顯示「未偵測到」狀態。

如果發生下列任一情況，Ops Agent 可能會顯示為「未偵測到」：

擴充功能政策無法安裝 Ops Agent。
已安裝的 Ops Agent 發生錯誤狀況，導致無法執行。

下列各節將說明如何診斷這些情況。

確認政策已安裝 Ops Agent

VM 擴充功能管理工具政策會使用 Compute Engine 訪客代理程式，以 VM 擴充功能的形式管理 Ops Agent。

如要判斷 Ops Agent 是否由擴充功能政策安裝，請使用下列其中一種方式，尋找訪客代理程式的記錄檔項目：

Logs Explorer

前往 Google Cloud 控制台的「Logs Explorer」頁面：
前往「Logs Explorer」(記錄檔探索工具)

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。
輸入以下查詢並點選「執行查詢」：

log_id("GCEGuestAgentManager")

Linux

在 Compute Engine VM 上執行下列指令：

journalctl -u google-guest-agent-manager

Windows

在 Compute Engine VM 上執行下列指令：

Get-Eventlog -Source google_guest_agent_manager -LogName Application

如果看到含有 Failed to install plugin "ops-agent-plugin" ... 等字串的記錄，或是查詢未傳回任何記錄，表示擴充功能政策無法安裝 Ops Agent。如需後續步驟，請參閱「擴充功能政策無法安裝 Ops Agent」。

如果看到含有 Successfully installed plugin "ops-agent_nnnnnnnn" 等字串的記錄，表示擴充功能政策已成功安裝 Ops Agent。如要瞭解後續步驟，請參閱「系統『未偵測到』已安裝的 Ops Agent」。

擴充功能政策無法安裝 Ops Agent

如果出現下列任一情況，擴充功能政策可能無法生效：

VM 未安裝客體代理程式。如要診斷及修正這個情況，請按照下列步驟操作：
1. 確認 VM 使用的作業系統支援 Compute Engine 客戶環境。
2. 查看 VM 上安裝的套件，確認其中包含 google-guest-agent。
3. 如果未安裝 google-guest-agent，請安裝訪客代理程式。
已安裝訪客代理程式，但版本過舊。如要診斷及修正這個情況，請按照下列步驟操作：
1. 驗證訪客環境，判斷 google-guest-agent 套件的版本。VM 擴充功能管理工具需要 20241209.01 以上版本。
2. 如果 google-guest-agent 版本舊於 20241209.01，請更新訪客環境。
VM 擴充功能管理工具不支援 VM 的作業系統。詳情請參閱「查看支援的作業系統」。

已安裝的 Ops Agent 狀態為「未偵測到」

如果發生下列任一情況，Ops Agent 的狀態可能會顯示為「未偵測到」：

VM 上已安裝可觀測性代理程式。現有代理程式可能會導致衝突，因此必須解除安裝。詳情請參閱「解除安裝所有可觀測性代理程式」。

解除安裝先前安裝的代理程式後，您可以重新啟動 Ops Agent。
Ops Agent 的權限不足，無法將資料傳送至 Cloud Logging 和 Cloud Monitoring。詳情請參閱「遙測傳輸失敗的常見原因」。

確認 Ops Agent 設定有效

您建立或更新擴充功能政策，為 Ops Agent 提供自訂設定，但代理程式狀態為「未偵測到」。問題可能是自訂設定有誤。使用客體代理程式偵錯記錄檔，找出設定錯誤。

啟用訪客代理程式偵錯記錄

如要瞭解如何啟用客體代理程式的偵錯記錄，請參閱「查看客體代理程式的偵錯記錄」。

檢查偵錯記錄

Logs Explorer

前往 Google Cloud 控制台的「Logs Explorer」頁面：
前往「Logs Explorer」(記錄檔探索工具)

如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。
輸入以下查詢並點選「執行查詢」：

severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

在 Linux Compute Engine VM 上執行下列指令：

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

在 Windows Compute Engine VM 上執行下列指令：

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

如果記錄包含 The agent config file is not valid 字串，表示您在建立或更新擴充功能政策時提供的 Ops Agent 自訂設定無效。

如要修正這個問題，請按照下列步驟操作：

請參閱「設定 Ops Agent」一文，修正設定。如要瞭解 Ops Agent 設定檔的結構。
更新擴充策略，使用修正後的設定。

Linux `systemctl status` 和 Windows `Get-Service` 指令無法搭配 Ops Agent 使用

您執行了類似 sudo systemctl status google-cloud-ops-agent"*" 的指令，但系統未傳回任何資訊。

如果 Ops Agent 是由 VM 擴充功能管理工具安裝及管理，則不會由作業系統的系統管理服務管理，也就是 Linux 上的 systemd 或 Windows 上的 Windows 服務管理工具。

如要查看由 VM 擴充功能管理工具管理的 Ops Agent 狀態資訊，請參閱下列內容：

Linux `systemctl restart` 和 Windows `Restart-Service` 指令無法搭配 Ops Agent 使用

您執行了 sudo systemctl restart google-cloud-ops-agent 等指令，但 Ops Agent 並未重新啟動。

如果 Ops Agent 是由 VM 擴充功能管理工具安裝及管理，則不會由作業系統的系統管理服務管理，也就是 Linux 上的 systemd 或 Windows 上的 Windows 服務管理工具。因此，您無法手動停止或啟動 Ops Agent，下列指令也無法搭配 Ops Agent 使用：

Linux：sudo systemctl [stop|start|restart]
Windows：Stop-Service、Start-Service、Restart-Service

如要停止或重新啟動由 VM 擴充功能管理工具管理的 Ops Agent，請刪除擴充功能政策來解除安裝代理程式。如要進一步瞭解如何停止或重新啟動 Ops Agent，請參閱「重新啟動透過擴充功能政策安裝的 Ops Agent」。

其他疑難排解資訊

如要進一步瞭解如何排解 VM 擴充功能管理工具政策的建立和使用問題，請參閱「排解 VM 擴充功能問題」。

如要進一步瞭解如何排解 Ops Agent 問題，請參閱「排解 Ops Agent 問題」。

配額

如要瞭解可在 Google Cloud 專案中建立的擴充功能政策數量，請參閱「Quota」。

定價

如要瞭解使用 VM 擴充功能管理工具的相關費用，請參閱「定價」。

若選擇安裝 Ops Agent，我們可能會針對代理程式傳送至您 Google Cloud 專案的指標、記錄檔或追蹤記錄向您收費。如要瞭解定價資訊，請參閱「Google Cloud Observability 定價」。

後續步驟

查看設定 Ops Agent 的詳細資訊。
進一步瞭解 VM 擴充功能管理工具。

使用 VM 擴充功能管理工具政策安裝及管理作業套件代理程式 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

查看支援的作業系統

啟用使用 Ops Agent 時所需的 API

授予使用 Ops Agent 必須具備的角色

授予使用 VM 擴充功能管理工具所需的角色

所需權限

安裝 Google Cloud CLI

卸載所有可觀測性代理

建立 VM 擴充功能政策，安裝 Ops Agent

政策衝突與優先事項

全域政策的政策推出計畫

在所有 VM 中安裝最新版 Ops Agent

控制台

gcloud

區域

全球

將所有 VM 中的 Ops Agent 固定在特定版本

控制台

gcloud

區域

全球

在具有特定標籤的 VM 中安裝 Ops Agent

控制台

gcloud

區域

全球

在所有 VM 中安裝 Ops Agent，並使用自訂設定

控制台

gcloud

區域

全球

以較高優先順序透過快速推出計畫安裝 Ops Agent (僅限全域)

在 Google Cloud 專案的可用區子集中安裝 Ops Agent (僅限全域)

透過更新 VM 擴充功能政策管理 Ops Agent

更新可用區中所有 VM 的 Ops Agent 固定版本

控制台

gcloud

區域

全球

修改所有 VM 的 Ops Agent 設定

控制台

gcloud

區域

全球

擴充現有全球政策，納入新區域 (僅限全球政策)

更新通用政策，排除一組區域 (僅限通用政策)

刪除 VM 擴充功能政策，解除安裝 Ops Agent

控制台

gcloud

區域

全球

擷取 VM 擴充功能政策的相關資訊

控制台

gcloud

區域

列出 VM 擴充功能政策

說明具名 VM 擴充功能政策

全球

列出全域 VM 擴充功能政策

說明具名的全域 VM 擴充功能政策

驗證 Ops Agent 的安裝作業

驗證 Ops Agent 安裝狀態或版本

Compute Engine

Cloud Monitoring

確認 Ops Agent 是否正在收集遙測資料

重新啟動透過擴充功能政策安裝的 Ops Agent

區域

全球

在 VM 上啟用客體代理程式偵錯記錄檔

排解擴充功能政策問題

gcloud compute zone-vm-extension-policies 指令失敗

擴充功能政策已建立，但 Ops Agent 狀態為「未偵測到」

確認政策已安裝 Ops Agent

Logs Explorer

Linux

Windows

擴充功能政策無法安裝 Ops Agent

已安裝的 Ops Agent 狀態為「未偵測到」

確認 Ops Agent 設定有效

使用 VM 擴充功能管理工具政策安裝及管理作業套件代理程式

`gcloud compute zone-vm-extension-policies` 指令失敗

Linux `systemctl status` 和 Windows `Get-Service` 指令無法搭配 Ops Agent 使用

Linux `systemctl restart` 和 Windows `Restart-Service` 指令無法搭配 Ops Agent 使用