使用虚拟机扩展程序管理器政策安装 Ops Agent

借助虚拟机扩展程序管理器政策，您可以在一组 Compute Engine 虚拟机上安装 Ops Agent。扩展程序政策可以在 Google Cloud 项目、文件夹或组织中全局或在特定可用区内安装 Ops Agent，使代理版本保持最新，并对代理应用自定义配置。文件夹级和组织级扩展程序政策目前处于预览版阶段。

准备工作

在创建虚拟机扩展程序管理器扩展程序政策以管理 Ops Agent 之前，请执行以下操作：

移除现有的可观测性代理

在为 Ops Agent 创建虚拟机扩展程序管理器政策之前，请确保虚拟机上没有 Ops Agent 或旧版 Monitoring 代理和 Logging 代理的实例。在同一虚拟机上运行 Ops Agent 和旧版代理可能会导致提取重复的日志或导致指标提取冲突。

如果您使用扩展程序政策在已安装其他可观测性代理的虚拟机上安装 Ops Agent，则该政策会安装该代理，但由于检测到冲突，该代理无法运行。

移除现有代理的方式取决于这些代理的安装方式。

启用使用 Ops Agent 所需的 API

如需使用 Ops Agent 写入日志和指标，您必须在 Google Cloud 项目中启用 Cloud Logging API 和 Cloud Monitoring API。

启用 API 所需的角色

如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

启用 API

授予使用 Ops Agent 所需的角色

如需获得使用 Ops Agent 写入日志和指标所需的权限，请让管理员为您授予服务账号的以下 IAM 角色：

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需详细了解角色和 Ops Agent，请参阅向 Ops Agent 授权。

启用虚拟机扩展程序管理器使用的 API

虚拟机扩展程序管理器使用 Compute Engine API。 在您的 Google Cloud 项目中启用此 API（如果尚未启用）。

启用 Compute Engine API

授予使用虚拟机扩展程序管理器所需的角色

如需查看在项目、文件夹或组织级层创建和管理扩展程序政策所需的权限，请选择其中一个级层：

项目

如需获得在项目级层管理可用区级或全球级虚拟机扩展政策所需的权限，请让管理员向您授予项目的 Compute VM 扩展政策管理员 (roles/compute.vmExtensionPolicyAdmin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供在项目级层管理可用区级或全球虚拟机扩展程序政策所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

在项目级管理可用区级或全局虚拟机扩展程序政策需要以下权限：

  • 创建项目级扩展程序政策：compute.vmExtensionPolicies.create
  • 修改项目级扩展程序政策：compute.vmExtensionPolicies.update
  • 删除项目级扩展程序政策： compute.vmExtensionPolicies.delete
  • 列出项目级扩展程序政策：compute.vmExtensionPolicies.list
  • 描述项目级扩展程序政策：compute.vmExtensionPolicies.get

您也可以使用自定义角色或其他预定义角色来获取这些权限。

文件夹

文件夹级扩展程序政策目前处于预览版阶段。

如需获得在文件夹级层管理可用区级或全球级虚拟机扩展政策所需的权限，请让管理员向您授予文件夹的 Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供在文件夹级层管理可用区级或全局虚拟机扩展程序政策所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需在文件夹级层管理可用区级或全局虚拟机扩展程序政策，您需要具备以下权限：

  • 创建文件夹级扩展程序政策：compute.folderVmExtensionPolicies.create
  • 修改文件夹级扩展程序政策：compute.folderVmExtensionPolicies.update
  • 删除文件夹级扩展程序政策：compute.folderVmExtensionPolicies.delete
  • 列出文件夹级扩展程序政策：compute.folderVmExtensionPolicies.list
  • 描述文件夹级扩展程序政策： compute.folderVmExtensionPolicies.get

您也可以使用自定义角色或其他预定义角色来获取这些权限。

组织

组织级扩展程序政策目前处于预览版阶段。

如需获得在组织级层管理可用区级或全球级虚拟机扩展政策所需的权限，请让管理员为您授予组织的组织级 Compute 虚拟机扩展政策管理员 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供在组织级层管理可用区级或全球级虚拟机扩展程序政策所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

在组织级层管理可用区级或全局虚拟机扩展程序政策需要以下权限：

  • 创建组织级扩展程序政策：compute.orgVmExtensionPolicies.create
  • 修改组织级扩展程序政策：compute.orgVmExtensionPolicies.update
  • 删除组织级扩展程序政策：compute.orgVmExtensionPolicies.delete
  • 列出组织级扩展程序政策： compute.orgVmExtensionPolicies.list
  • 描述组织级扩展程序政策：compute.orgVmExtensionPolicies.get

您也可以使用自定义角色或其他预定义角色来获取这些权限。

如需详细了解 Compute Engine 中的 IAM 角色和权限，请参阅 Compute Engine 角色和权限。

安装 Google Cloud CLI

如需使用 Google Cloud CLI 创建扩展程序政策，您必须先安装 Google Cloud CLI。

如需使用 gcloud 创建和管理文件夹级和组织级扩展程序政策，您必须安装 gcloud“预览版”组件。如需了解详情，请参阅 Alpha 版、Beta 版和预览版组件。

如需查看已安装的组件，请运行以下命令：

gcloud components list

如需验证您是否拥有最新版本，请运行以下命令：

gcloud components update

政策冲突和优先级

虚拟机扩展程序管理器会为每个新政策关联一个优先级，数字越小，优先级越高；默认优先级为 1000。虚拟机可以由扩展程序（例如 Ops Agent）的多项政策涵盖，但只有一项 Ops Agent 扩展程序政策对虚拟机有效。如需了解如何确定扩展程序的有效政策，请参阅查看虚拟机上扩展程序的详细信息和状态。

虚拟机扩展程序管理器会使用优先级来解决应用于虚拟机的政策之间的冲突。如需详细了解解决流程，请参阅政策优先级和冲突解决。

全球政策的政策发布计划

虚拟机扩展程序管理器全局政策使用发布计划来确定如何将政策分发到目标虚拟机。发布方案有两种类型：

  • 预定义发布计划。有两个预定义的发布计划，由 gcloud CLI 命令的 --rollout-predefined-plan 选项使用的值选择。

    • 慢速发布：在一段时间内，逐步在不同可用区中部署 Ops Agent。建议采用此发布计划。

      使用 --rollout-predefined-plan=slow_rollout 选项指定此发布计划。

    • 快速发布，即立即将 Ops Agent 部署到所有可用区和区域中的所有目标虚拟机。

      使用 --rollout-predefined-plan=fast_rollout 选项指定此发布计划。

  • 自定义发布计划，通过对 gcloud CLI 命令使用 --rollout-custom-plan 选项来指定。

    通过将自定义发布计划添加到 Google Cloud 项目中的发布计划集来创建自定义发布计划；如需了解详情，请参阅 Compute Engine API 方法 rolloutPlans.insert。

如需详细了解发布计划，请参阅全局政策的发布计划。

创建虚拟机扩展程序政策以安装 Ops Agent

借助虚拟机扩展程序管理器，您可以创建政策，声明要在虚拟机上安装哪些扩展程序。Ops Agent 是可用的扩展程序之一。通过定义政策，您可以确保在符合您指定的条件（例如虚拟机标签）的任何虚拟机上安装和维护受支持的扩展程序（包括 Ops Agent）。

您可以使用 Ops Agent 的扩展程序政策来执行以下任务：

  • 整组安装：在项目、文件夹和组织级层安装 Ops Agent：

    • 一个或多个可用区中的所有虚拟机。
    • 全球范围内的所有虚拟机。
    • 可用区中带有标签的虚拟机子集。
    • 跨可用区的一组带标签的虚拟机

  • 版本控制：

    • 将 Ops Agent 更新到最新版本。
    • 将 Ops Agent 版本固定到特定版本。

  • 配置管理：将自定义配置应用和更新到由政策管理的所有虚拟机上的 Ops Agent。

如果 Ops Agent 是通过扩展程序政策安装的，则虚拟机扩展程序管理器支持 Ops Agent 2.58.0 或更高版本。 虚拟机扩展程序管理器无法管理早期版本的 Ops Agent、通过其他方式安装的 Ops Agent 实例，或旧版 Monitoring 代理或 Logging 代理。

以下部分提供了使用 gcloud 或 Google Cloud 控制台根据特定条件安装 Ops Agent 的政策示例。如需了解如何使用 Compute Engine API 创建和管理扩展程序政策，请参阅虚拟机扩展程序管理器文档。

在所有虚拟机上安装最新版 Ops Agent

如需创建在可用区或全球范围内的所有虚拟机上安装最新版本的 Ops Agent 的政策，并在发布新版本时更新 Ops Agent，请执行以下操作：

控制台

如需创建可用区级政策，您可以使用 Google Cloud 控制台。

  1. 在 Google Cloud 控制台中，前往扩展程序政策页面：

    前往扩展程序政策

    如果您使用搜索栏查找此页面，请选择子标题为 Compute Engine 的结果。

  2. 点击 + 创建。
  3. 在名称字段中，输入政策的名称。
  4. 可选：在说明字段中，输入政策的说明。
  5. 在优先级字段中，指定一个优先级编号，以解决政策之间的冲突。数字越小，优先级越高。默认值为 1000。
  6. 在可用区列表中，选择要应用此政策的可用区。
  7. 在管理扩展程序部分中，点击添加扩展程序，然后执行以下操作：
    1. 从扩展程序列表中，选择 Google Cloud's Extension for Ops Agent。
    2. 将版本字段留空。
  8. 点击创建。

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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • ZONE：目标可用区，例如 us-central1-f。

gcloud compute zone-vm-extension-policies create 命令接受 --version 选项。 如果您省略 --version 选项，则该政策会安装最新版本，并在新版本发布时更新 Ops Agent。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute zone-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

全球

项目级

使用以下 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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。

gcloud compute global-vm-extension-policies create 命令接受 --version 选项。如果您省略 --version 选项，则该政策会安装最新版本，并在新版本发布时更新 Ops Agent。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute global-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

在所有虚拟机上将 Ops Agent 固定到特定版本

如需创建在可用区或全球范围内的所有虚拟机上安装特定版本 Ops Agent 的政策，请执行以下操作：

控制台

如需创建可用区级政策，您可以使用 Google Cloud 控制台。

  1. 在 Google Cloud 控制台中，前往扩展程序政策页面：

    前往扩展程序政策

    如果您使用搜索栏查找此页面，请选择子标题为 Compute Engine 的结果。

  2. 点击 + 创建。
  3. 在名称字段中，输入政策的名称。
  4. 可选：在说明字段中，输入政策的说明。
  5. 在优先级字段中，指定一个优先级编号，以解决政策之间的冲突。数字越小，优先级越高。默认值为 1000。
  6. 在可用区列表中，选择要应用此政策的可用区。
  7. 在管理扩展程序部分中，点击添加扩展程序，然后执行以下操作：
    1. 从扩展程序列表中，选择 Google Cloud's Extension for Ops Agent。
    2. 从版本列表中，选择要安装的版本。 使用 2.58.0 或更高版本。
  8. 点击创建。

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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • ZONE：目标可用区，例如 us-central1-f。
  • VERSION：要安装的 Ops Agent 版本。 使用 2.58.0 或更高版本。

    如果您省略 --version 选项，则政策会安装最新版本，并在新版本发布时更新 Ops Agent，如安装最新版本的示例所示。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute zone-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

全球

项目级

使用以下 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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • VERSION：要安装的 Ops Agent 版本。 使用 2.58.0 或更高版本。

    如果您省略 --version 选项，则政策会安装最新版本，并在新版本发布时更新 Ops Agent，如安装最新版本的示例所示。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute global-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

如需查看 Ops Agent 版本列表，请参阅 GitHub 上的 Ops Agent 版本页面。

在具有特定标签的虚拟机上安装 Ops Agent

如需创建一项政策，以便在可用区中或全球范围内具有特定标签的虚拟机上安装最新版本的 Ops Agent，请执行以下操作：

控制台

如需创建可用区级政策，您可以使用 Google Cloud 控制台。

  1. 在 Google Cloud 控制台中，前往扩展程序政策页面：

    前往扩展程序政策

    如果您使用搜索栏查找此页面，请选择子标题为 Compute Engine 的结果。

  2. 点击 + 创建。
  3. 在名称字段中，输入政策的名称。
  4. 可选：在说明字段中，输入政策的说明。
  5. 在优先级字段中，指定一个优先级编号，以解决政策之间的冲突。数字越小，优先级越高。默认值为 1000。
  6. 在可用区列表中，选择要应用此政策的可用区。
  7. 在管理扩展程序部分中，点击添加扩展程序，然后执行以下操作：
    1. 从扩展程序列表中，选择 Google Cloud's Extension for Ops Agent。
    2. 将版本字段留空。
  8. 在目标虚拟机实例部分中，选择要应用该政策的虚拟机。 如需选择具有特定标签的虚拟机，请点击添加标签，然后添加键值对。
  9. 点击创建。

gcloud

如需在项目、文件夹或组织级层创建或管理可用区级或全球级政策，您可以使用 gcloud CLI。

可用区级

项目级

使用 gcloud compute zone-vm-extension-policies create 命令的 --inclusion-labels 选项指定逗号分隔列表形式的键值对：

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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • ZONE：目标可用区，例如 us-central1-f。
  • KEY1=VALUE1,KEY2=VALUE2：以英文逗号分隔的键值对列表，用于定义选择器的包含标签。虚拟机必须具有选择器中指定的所有标签（逻辑“与”）才能包含在内。如果您多次指定 --inclusion_labels 选项，则政策会以与任何选择器中的所有标签匹配的虚拟机为目标（逻辑 OR）。如果您省略此选项，则政策会以指定可用区中的所有虚拟机为目标。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute zone-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

全球

项目级

使用 gcloud compute global-vm-extension-policies create 命令的 --inclusion-labels 选项指定逗号分隔列表形式的键值对：

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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • KEY1=VALUE1,KEY2=VALUE2：以英文逗号分隔的键值对列表，用于定义选择器的包含标签。虚拟机必须具有选择器中指定的所有标签（逻辑“与”）才能包含在内。如果您多次指定 --inclusion_labels 选项，则政策会以与任何选择器中的所有标签匹配的虚拟机为目标（逻辑 OR）。如果您省略此选项，则政策会以指定可用区中的所有虚拟机为目标。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute global-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

在所有虚拟机上安装具有自定义配置的 Ops Agent

如需创建在可用区或全球范围内的所有虚拟机上安装最新版本的 Ops Agent 并为 Ops Agent 提供自定义配置的政策，请执行以下操作：

控制台

如需创建可用区级政策，您可以使用 Google Cloud 控制台。

  1. 在 Google Cloud 控制台中，前往扩展程序政策页面：

    前往扩展程序政策

    如果您使用搜索栏查找此页面，请选择子标题为 Compute Engine 的结果。

  2. 点击 + 创建。
  3. 在名称字段中，输入政策的名称。
  4. 可选：在说明字段中，输入政策的说明。
  5. 在优先级字段中，指定一个优先级编号，以解决政策之间的冲突。数字越小，优先级越高。默认值为 1000。
  6. 在可用区列表中，选择要应用此政策的可用区。
  7. 在管理扩展程序部分中，点击添加扩展程序，然后执行以下操作：
    1. 从扩展程序列表中，选择 Google Cloud's Extension for Ops Agent。
    2. 将版本字段留空。
    3. 在配置文件内容字段中，输入 Ops Agent 的 YAML 配置字符串。
  8. 点击创建。

gcloud

如需在项目、文件夹或组织级层创建或管理可用区级或全球级政策，您可以使用 gcloud CLI。

可用区级

项目级

使用 gcloud compute zone-vm-extension-policies create 命令的 --config-from-file 选项指定配置文件：

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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • ZONE：目标可用区，例如 us-central1-f。
  • OPS_AGENT_CONFIG_PATH：包含 Ops Agent 的 YAML 配置字符串的文件的路径。此文件必须存在于您运行 gcloud 命令的环境中。

    Ops Agent 的配置 YAML 可能很长。与尝试在命令行中输入格式正确的 YAML 相比，将配置放入文件中并将文件传递给 gcloud CLI 的出错率要低得多。在创建政策后更改此文件不会更新政策；如需更新政策，请使用 gcloud compute zone-vm-extension-policies update 命令。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute zone-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

全球

项目级

使用 gcloud compute global-vm-extension-policies create 命令的 --config-from-file 选项指定配置文件：

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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • OPS_AGENT_CONFIG_PATH：包含 Ops Agent 的 YAML 配置字符串的文件的路径。此文件必须存在于您运行 gcloud 命令的环境中。

    Ops Agent 的配置 YAML 可能很长。与尝试在命令行中输入格式正确的 YAML 相比，将配置放入文件中并将文件传递给 gcloud CLI 的出错率要低得多。创建政策后更改此文件不会更新政策；如需更新政策，请使用 gcloud compute global-vm-extension-policies update 命令。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute global-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

如果您在创建或更新扩展程序政策时为 Ops Agent 提供了自定义配置，则该政策会使用自定义配置部署 Ops Agent。您无需手动重启代理。

配置会与扩展程序政策一起存储，因此请勿在配置中包含密码等敏感数据。由于配置存储在扩展程序政策中，因此修改配置文件不会更改代理的配置。您必须使用相应的 gcloud 命令更新随政策存储的配置：

当您为 Ops Agent 提供自定义配置时，虚拟机扩展程序管理器会将该配置复制到目标虚拟机上 Ops Agent 用于用户指定配置文件的位置：

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

如果虚拟机上存在 config.yaml 文件，则扩展程序政策会覆盖该文件。

如需了解如何使用Google Cloud 控制台和 gcloud CLI 创建虚拟机扩展程序政策，请参阅使用扩展程序政策安装虚拟机扩展程序。

使用优先级较高的快速发布计划安装 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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute global-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_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：虚拟机扩展程序政策的名称。
  • PROJECT_ID：项目的标识符。
  • CUSTOM_PLAN_NAME：与自定义发布方案关联的名称。

文件夹和组织级层

如需在文件夹或组织级层执行上述任务，请使用 gcloud preview compute global-vm-extension-policies create 命令并进行以下替换之一：

  • 对于文件夹级扩展政策，请将 --project=PROJECT_ID 选项替换为 --folder=folders/FOLDER_ID，其中 FOLDER_ID 是文件夹的数字 ID。
  • 对于组织级扩展程序政策，请将 --project=PROJECT_ID 选项替换为 --organization=organizations/ORGANIZATION_ID，其中 ORGANIZATION_ID 是组织的数字 ID。

验证 Ops Agent 的安装

本部分介绍了如何执行以下操作：

验证 Ops Agent 安装的状态或版本

如需确定 Ops Agent 的状态或版本，请使用以下Google Cloud 控制台页面之一：

Compute Engine

  1. 在 Google Cloud 控制台中，前往虚拟机实例页面：

    前往虚拟机实例

    如果您使用搜索栏查找此页面，请选择子标题为 Compute Engine 的结果。

  2. 从列表中选择一个虚拟机。
  3. 点击可观测性标签页。

Cloud Monitoring

  1. 在 Google Cloud 控制台中，前往虚拟机实例页面：

    前往虚拟机实例

    如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

  2. 选择列表视图。

在虚拟机上安装 Ops Agent 并且该代理正在收集日志和指标时，代理的状态会标记为 Ops Agent 标签旁边的绿色对勾标记。

如需确定已安装代理的版本，请将鼠标悬停在 Compute Engine 或 Monitoring 信息中心上的 Ops Agent 标签上。

验证 Ops Agent 是否正在收集遥测数据

如果 Ops Agent 已成功安装并正常运行，则它会将指标发送到 Cloud Monitoring，并将日志发送到 Cloud Logging。

后续步骤