Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

为 Redis 工作负载设置代理

本文档介绍了如何在 Compute Engine 实例上安装 Agent for Compute Workloads，以及如何配置该代理以连接到在这些计算实例上运行的 Redis 工作负载。

安装并配置代理后，它会从 Redis 工作负载和底层计算实例收集指标，并将其发送到 Workload Manager。然后，您可以使用 Workload Manager 评估扫描 Redis 工作负载，以查找基础设施、操作系统和工作负载配置是否偏离最佳实践。

准备工作

在安装和配置 Agent for Compute Workloads 之前，您需要确保满足以下前提条件：

您已在一个或多个计算实例上部署 Redis 工作负载。
您已查看可创建 Workload Manager 评估的支持的区域。
您的管理员已为您授予创建和运行 Workload Manager 评估所需的 IAM 角色。
您已授予代理所需的 IAM 角色。
您已启用对 Cloud API 的访问权限。

代理所需的 IAM 角色

Compute Workloads Agent 使用附加到计算实例的服务账号进行身份验证并访问 Google Cloud 资源。

为了提高安全性，我们建议您使用单用途服务账号，而不是使用 Compute Engine 默认服务账号。

为确保服务账号具有让 Agent for Compute Workloads 向Google Cloud 进行身份验证并访问 Google Cloud 资源所需的权限，请让您的管理员为服务账号授予项目的以下 IAM 角色：

从计算实例收集指标： Compute Viewer (roles/compute.viewer)
将数据写入 Workload Manager 数据仓库： Workload Manager Insights Writer (roles/workloadmanager.insightWriter)
将代理日志发送到 Cloud Logging： Logs Writer (roles/logging.logWriter)
如果您使用 Secret Manager 存储用于连接到 Redis 实例的密码：Secret Manager Secret Accessor (roles/secretmanager.secretAccessor)

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

您的管理员还可以通过自定义角色或其他预定义角色向服务账号授予所需的权限。

启用对 Cloud API 的访问权限

Compute Engine 建议将实例配置为允许针对所有 Cloud API 的所有访问权限范围，并且仅使用实例服务账号的 IAM 权限来控制对Google Cloud 资源的访问权限。如需了解详情，请参阅创建使用用户管理的服务账号的虚拟机。

如果您限制了对 Cloud API 的访问权限，则 Agent for Compute Workloads 要求主机计算实例至少具有以下 Cloud API 访问权限范围：

https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅范围最佳实践。

如果您是在没有外部 IP 地址的计算实例上运行 Redis 工作负载，则需要在该实例的子网上启用专用 Google 访问通道，以便 Agent for Compute Workloads 可以访问 Google API 和服务。如需了解如何启用专用 Google 访问通道，请参阅配置专用 Google 访问通道。

使用软件包管理器安装和配置代理

本部分介绍如何使用软件包管理系统在计算实例上安装 Agent for Compute Workloads，并将其配置为与 Redis 实例连接。

如需安装适用于 Compute Workloads 的代理，请完成以下步骤：

RHEL

在 Red Hat Enterprise Linux (RHEL) 上，您可以使用 yum 软件包管理命令安装 Agent for Compute Workloads。此命令可完成以下任务：

下载最新版本的代理。
为代理创建名为 google-cloud-workload-agent 的 systemd 服务。
启用并启动 google-cloud-workload-agent 服务。

如需在基于 RHEL 的计算实例上安装和配置 Agent for Compute Workloads，请完成以下步骤：

与您的计算实例建立 SSH 连接。

在终端中，安装代理：

sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Agent for Compute Workloads
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-workload-agent

打开代理的配置文件：

/etc/google-cloud-workload-agent/configuration.json

按照配置参数中的说明，为所有必需参数指定值。
保存配置文件
重启代理以使更改生效。

SLES

在 SUSE Linux Enterprise Server (SLES) 上，您可以使用 zypper 软件包管理命令安装 Agent for Compute Workloads。此命令可完成以下任务：

下载最新版本的代理。
为代理创建名为 google-cloud-workload-agent 的 systemd 服务。
启用并启动 google-cloud-workload-agent 服务。

如需在基于 SLES 的计算实例上安装和配置 Agent for Compute Workloads，请完成以下步骤：

与您的计算实例建立 SSH 连接。

在终端中，安装代理：

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
google-cloud-workload-agent
sudo zypper install google-cloud-workload-agent

打开代理的配置文件：

/etc/google-cloud-workload-agent/configuration.json

按照配置参数中的说明，为所有必需参数指定值。
保存配置文件
重启代理以使更改生效。

Debian

在 Debian 上，您可以使用 apt 软件包管理命令安装 Agent for Compute Workloads。此命令可完成以下任务：

下载最新版本的代理。
为代理创建名为 google-cloud-workload-agent 的 systemd 服务。
启用并启动 google-cloud-workload-agent 服务。

如需在基于 Debian 的计算实例上安装和配置 Agent for Compute Workloads，请完成以下步骤：

与您的计算实例建立 SSH 连接。

在终端中，安装代理：

echo 'deb https://packages.cloud.google.com/apt google-cloud-workload-agent-x86-64-apt main' | sudo tee -a /etc/apt/sources.list.d/google-cloud-workload-agent.list
sudo apt-get update
sudo apt-get install google-cloud-workload-agent

打开代理的配置文件：

/etc/google-cloud-workload-agent/configuration.json

按照配置参数中的说明，为所有必需参数指定值。
保存配置文件
重启代理以使更改生效。

Windows

在 Windows 上，您可以使用 googet 软件包管理命令安装 Agent for Compute Workloads。此命令可完成以下任务：

下载最新版本的代理。
创建名为 google-cloud-workload-agent 的 Windows 服务。
创建每分钟运行一次的计划任务，以检查服务是否正在运行，并在必要时重启服务。

如需在基于 Windows 的计算实例上安装和配置 Agent for Compute Workloads，请完成以下步骤：

使用 RDP 与计算实例建立连接。

如需了解如何执行此操作，请参阅使用 RDP 连接到 Windows 虚拟机。

以管理员身份从 PowerShell 运行以下命令：

googet addrepo google-cloud-workload-agent  https://packages.cloud.google.com/yuck/repos/google-cloud-workload-agent-windows-x86_64
googet install google-cloud-workload-agent

打开代理的配置文件：

%ProgramFiles%\Google\google-cloud-workload-agent\conf\configuration.json

按照配置参数中的说明，为所有必需参数指定值。
保存配置文件
重启代理以使更改生效。

使用虚拟机扩展程序管理器在一组虚拟机上安装和管理代理

本部分介绍如何使用虚拟机扩展管理器在虚拟机群组中安装和管理 Compute 工作负载代理。

借助虚拟机扩展程序管理器政策，您可以执行以下任务：

在整个舰队范围内安装：在以下项上安装 Agent for Compute Workloads：
- Google Cloud 项目中的所有虚拟机，或通过标签标识的虚拟机子集。
- 可用区内的所有虚拟机，或由标签标识的部分虚拟机。
配置管理：将自定义配置应用于政策管理的所有虚拟机上的代理。

如需详细了解虚拟机扩展程序管理器，请参阅虚拟机扩展程序管理器简介。

设置虚拟机扩展程序管理器

如需设置虚拟机扩展程序管理器，请完成以下步骤：

在虚拟机扩展程序管理器文档中，查看准备工作部分。
设置创建和管理虚拟机扩展程序管理器政策所需的 IAM 角色。如需了解详情，请参阅以下内容：

在一组虚拟机上安装和配置代理

如需使用虚拟机扩展程序管理器政策在虚拟机群组上安装最新版本的 Agent for Compute Workloads，请参阅相应部分：

在 Google Cloud 项目中的虚拟机上安装和配置代理
在特定可用区内的虚拟机上安装和配置代理

在 Google Cloud 项目中的虚拟机上安装和配置代理

如需使用虚拟机扩展程序管理器政策在 Google Cloud 项目中的所有虚拟机上或通过标签标识的虚拟机子集上安装代理，请完成以下步骤：

控制台

在 Google Cloud 控制台中，前往虚拟机扩展程序政策页面。

前往“虚拟机扩展程序政策”
点击创建扩展程序政策。
在名称字段中，输入政策的名称。
可选：在说明字段中，输入政策的说明。
在优先级字段中，指定一个优先级编号，以解决政策之间的冲突。数字越小，优先级越高。默认值为 1000。
在范围部分，选择全球发布。
在管理扩展程序部分中，点击添加扩展程序，然后执行以下操作：
1. 从扩展程序列表中，选择 Google Cloud 的计算工作负载扩展程序。
2. 将版本字段留空。
  
  这会指示政策安装最新版本的 Agent for Compute Workloads。
3. 在配置文件内容字段中，输入要应用于代理的配置。
  
  如需了解代理为 Redis 工作负载支持的配置参数，请参阅配置参数。
  
  注意：如果您将虚拟机扩展程序管理器政策应用于已在运行 Agent for Compute Workloads 的虚拟机，则该政策会使用您在政策中设置的版本和配置来替换现有代理的版本和配置。
  
  代理的现有配置会写入相应虚拟机上 /etc/google-cloud-workload-agent/ 目录中的 BAK 文件。
4. 点击完成。
5. 在发布字段中，选择要使用的发布方案选项：缓慢发布（推荐）或快速发布。
  
  如需了解发布计划，请参阅发布计划简介。
可选：如需将政策发布范围限制为所需的虚拟机，请执行以下操作：
1. 点击添加标签，并添加用于标识所需虚拟机的标签。
2. 点击完成。
点击创建。

gcloud

在终端或 Cloud Shell 中，运行 gcloud compute global-vm-extension-policies create 命令：

gcloud compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

替换以下内容：

POLICY_NAME：虚拟机扩展程序政策的唯一名称。
PROJECT_ID：您要为其创建政策的Google Cloud 项目的项目 ID
ROLL_OUT_SPEED：您希望以多快的速度推出政策。支持的值包括 slow_rollout（推荐）和 fast_rollout。如需了解详情，请参阅发布计划简介。
或者，您也可以通过指定 --rollout-custom-plan 选项来使用自定义发布计划。如需了解详情，请参阅发布计划简介。
您可以使用 --rollout-predefined-plan 或 --rollout-custom-plan，但不能在同一命令中同时使用这两者。
DESCRIPTION：政策的可选说明。
CONFIG_FILE_PATH：包含 Agent for Compute Workloads 配置的 JSON 文件的本地路径。
- 或者，如需以内嵌字符串的形式提供配置，请使用 --config 标志，而不是 --config-from-file。例如 --config=google-cloud-workload-extension="CONFIG"。
- 您可以使用 --config-from-file 或 --config，但不能在同一命令中同时使用这两者。
- 如需了解代理支持的配置参数，请参阅配置参数。
注意：如果您将虚拟机扩展程序管理器政策应用于已在运行 Agent for Compute Workloads 的虚拟机，则该政策会使用您在政策中设置的内容替换现有代理的版本和配置。

代理的现有配置会写入相应虚拟机上 /etc/google-cloud-workload-agent/ 目录中的 BAK 文件。
KEY_1=VALUE_1：一个逗号分隔列表，其中包含用于定义政策定位虚拟机的标签的键值对。
- 如需让虚拟机成为政策的目标，该虚拟机必须具有所有指定的标签。
- 如果您多次指定 --inclusion-labels，则政策会以与所提供的任何选择器匹配的虚拟机为目标（逻辑 OR）。如果您省略此标志，则政策会以项目中的所有虚拟机为目标。
PRIORITY：一个介于 0 到 65535 之间的整数，用于定义政策的优先级。数字越小，优先级越高。默认值为 1000。如需了解详情，请参阅政策优先级和冲突解决。

在特定可用区内的虚拟机上安装和配置代理

如需使用虚拟机扩展管理器政策在特定可用区内的虚拟机群上安装和配置最新版本的 Compute 工作负载代理，请完成以下步骤：

控制台

在 Google Cloud 控制台中，前往虚拟机扩展程序政策页面。

前往“虚拟机扩展程序政策”
点击创建扩展程序政策。
在名称字段中，输入政策的名称。
可选：在说明字段中，输入政策的说明。
在优先级字段中，指定一个优先级编号，以解决政策之间的冲突。数字越小，优先级越高。默认值为 1000。
使用区域和可用区列表，选择您要应用此政策的可用区。
在管理扩展程序部分中，点击添加扩展程序，然后执行以下操作：
1. 从扩展程序列表中，选择 Google Cloud 的计算工作负载扩展程序。
2. 将版本字段留空。
  
  这会指示政策安装最新版本的 Agent for Compute Workloads。
3. 在配置文件内容字段中，输入要应用于代理的配置。
  
  如需了解代理为 Redis 工作负载支持的配置参数，请参阅配置参数。
  
  注意：如果您将虚拟机扩展程序管理器政策应用于已在运行 Agent for Compute Workloads 的虚拟机，则该政策会使用您在政策中设置的版本和配置来替换现有代理的版本和配置。
  
  代理的现有配置会写入相应虚拟机上 /etc/google-cloud-workload-agent/ 目录中的 BAK 文件。
4. 点击完成。
可选：如需将政策发布范围限制为所需的虚拟机，请执行以下操作：
1. 点击添加标签，并添加用于标识所需虚拟机的标签。
2. 点击完成。
点击创建。

gcloud

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

替换以下内容：

POLICY_NAME：虚拟机扩展程序政策的名称。

如果相应地区中已存在具有指定名称的政策，则该命令会失败。
ZONE：您要应用此政策的可用区。
CONFIG_FILE_PATH：JSON 文件的本地路径，该文件包含 Agent for Compute Workloads 与 Redis 工作负载连接的配置。
- 或者，如需以内嵌字符串的形式提供配置，请使用 --config 标志，而不是 --config-from-file。例如 --config=google-cloud-workload-extension="CONFIG"。 Google Cloud 建议您使用 --config-from-file。
- 您可以使用 --config-from-file 或 --config，但不能在同一命令中同时使用这两者。
- 如需了解代理为 Redis 工作负载支持的配置参数，请参阅配置参数。
注意：如果您将虚拟机扩展程序管理器政策应用于已在运行 Agent for Compute Workloads 的虚拟机，则该政策会使用您在政策中设置的内容替换现有代理的版本和配置。

代理的现有配置会写入相应虚拟机上 /etc/google-cloud-workload-agent/ 目录中的 BAK 文件。
DESCRIPTION：政策的可选说明。
KEY_1=VALUE_1：一个逗号分隔列表，其中包含用于定义政策定位虚拟机的标签的键值对。
- 如需让虚拟机成为政策的目标，该虚拟机必须具有所有指定的标签。
- 如果您多次指定 --inclusion-labels，则政策会以与所提供的任何选择器匹配的虚拟机为目标（逻辑 OR）。如果您省略此标志，则政策会以指定可用区中的所有虚拟机为目标。
PRIORITY：一个介于 0 到 65535 之间的整数，用于定义政策的优先级。数字越小，优先级越高。默认值为 1000。

示例：

以下命令会在名为 test-project 的Google Cloud 项目中创建名为 test-agent-policy 的政策，该政策会在可用区 us-centrail-f 中部署的所有虚拟机上安装最新版本的 Agent for Compute Workloads。agent-config.json 中指定的配置会应用于代理。

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

管理一组虚拟机上的代理

如需更改虚拟机扩展程序管理器政策管理 Compute Workloads Agent 的方式，请更新该政策。更新政策时，虚拟机扩展程序管理器通常会在一分钟内将更改发布到所有适用的虚拟机。如果您修改了包含标签，则系统可能会在新虚拟机上安装 Agent for Compute Workloads，或根据虚拟机是否与更新后的标签匹配，从现有虚拟机中卸载该代理。

以下部分介绍了如何管理 Agent for Compute Workloads，以执行以下操作：

在一组虚拟机上修改代理配置
更新全局政策以纳入新区域
更新全局政策以排除可用区

在一组虚拟机上修改代理配置

如需修改您使用虚拟机扩展程序管理器政策在虚拟机群组上安装的 Agent for Compute Workloads 实例的配置，您必须修改相应政策。

如需修改虚拟机群组中的代理配置，请完成以下步骤：

控制台

在 Google Cloud 控制台中，前往虚拟机扩展程序政策页面。

前往“虚拟机扩展程序政策”
点击要修改的政策。
在延期政策详情页面中，点击修改。
在管理扩展程序部分，切换用于计算工作负载的 Google Cloud 扩展程序。
在配置文件内容字段中，输入要应用于代理的配置。

如需了解代理支持的配置参数，请参阅配置参数
点击完成。
点击保存。

gcloud

如需修改虚拟机群组中 Agent for Compute Workloads 的配置，请运行 gcloud compute zone-vm-extension-policies update 命令。使用 gcloud 更新政策时，相应请求会完全替换现有政策。您省略的所有可选字段都会恢复为默认值，而不是保留修改后的政策中的现有值。

如需修改代理配置，请执行以下操作：

gcloud compute zone-vm-extension-policies update POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY_NUMBER \]
    [--description="DESCRIPTION"]

替换以下内容：

POLICY_NAME：您要修改的虚拟机扩展程序政策的名称。
ZONE：政策适用的 Google Cloud 可用区。
CONFIG_FILE_PATH：包含 Agent for Compute Workloads 配置的 JSON 文件的本地路径。
- 您还可以使用 --config 标志（而非 --config-from-file）以内嵌字符串的形式提供代理配置。例如 --config=google-cloud-workload-extension="CONFIG"。 Google Cloud 建议您使用 --config-from-file。
- 您可以使用 --config-from-file 或 --config，但不能在同一命令中同时使用这两者。
- 如需了解代理支持的配置参数，请参阅配置参数
KEY_1=VALUE_1：逗号分隔列表，用于定义政策定位虚拟机的标签。
- 如需让虚拟机成为政策的目标，该虚拟机必须具有所有指定的标签。
- 如果您多次指定 --inclusion-labels，则政策会以与所提供的任何选择器匹配的虚拟机为目标（逻辑 OR）。如果您省略此标志，则政策会以指定可用区中的所有虚拟机为目标。
PRIORITY_NUMBER：您要为政策设置的优先级。您可以指定一个介于 0 到 65535 之间的整数。
DESCRIPTION：虚拟机扩展程序政策的说明。

更新全局政策以纳入新可用区

在创建并推出全局政策后，如果您在新可用区中创建虚拟机，虚拟机扩展程序管理器不会自动将该政策应用于新可用区中的虚拟机。如需将虚拟机纳入新可用区，您必须重新开始全球政策发布。

如需重新开始全球政策发布，请完成以下步骤：

在终端或 Cloud Shell 中，运行 gcloud compute global-vm-extension-policies update 命令并提供 --rollout-entry-uuid 选项，如下所示：
```
gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID
```
替换以下内容：
- UUID：用于标识重试请求的通用唯一标识符 (UUID)。您可以使用任何 UUID 生成器来创建 UUID。如需了解详情，请参阅重试发布。
- ROLL_OUT_SPEED：您希望以多快的速度推出政策。支持的值包括 slow_rollout（推荐）和 fast_rollout。如需了解详情，请参阅发布计划简介。
- 或者，您也可以通过指定 --rollout-custom-plan 选项来使用自定义发布计划。如需了解详情，请参阅发布计划简介。
- 您可以使用 --rollout-predefined-plan 或 --rollout-custom-plan，但不能在同一命令中同时使用这两者。

更新全局政策以排除可用区

如需更新全球政策以排除可用区，请完成以下步骤：

在终端或 Cloud Shell 中，运行 gcloud compute global-vm-extension-policies update 命令，并提供指定应用政策的可用区的自定义发布计划：
```
gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID
```
替换以下内容：
- NEW_CUSTOM_PLAN_NAME：新自定义发布方案的名称，用于标识应用政策的可用区。如需了解如何创建自定义发布计划，请参阅发布计划简介。
- UUID：用于标识重试请求的通用唯一标识符 (UUID)。您可以使用任何 UUID 生成器来创建 UUID。如需了解详情，请参阅重试发布。

从一组虚拟机中卸载代理

如需从虚拟机群组中卸载 Agent for Compute Workloads，您必须删除管理该虚拟机群组的虚拟机扩展程序管理器政策。

删除政策时，如果另一项优先级较低的有效政策应用于虚拟机并声明了 Agent for Compute Workloads，则该代理会根据优先级较低的政策继续安装在该虚拟机上。

虚拟机扩展程序管理器会在政策删除后一分钟内从所有可访问的虚拟机中移除代理。如果由于客机代理被移除或虚拟机被删除而导致虚拟机无法访问，则虚拟机扩展程序管理器会跳过 Agent for Compute Workloads 的删除操作。如果此类虚拟机再次可用，则虚拟机扩展程序管理器会在此时移除 Agent for Compute Workloads。

如需从虚拟机舰队中卸载 Agent for Compute Workloads，请完成以下步骤：

控制台

在 Google Cloud 控制台中，前往虚拟机扩展程序政策页面。

前往“虚拟机扩展程序政策”
点击用于管理虚拟机群组中 Agent for Compute Workloads 的政策。
在扩展程序政策详情页面中，点击删除并确认删除。

gcloud

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

替换以下内容：

POLICY_NAME：您要删除的虚拟机扩展程序政策的名称。
PROJECT_ID：政策所在 Google Cloud 项目的 ID。
ZONE：该政策所在的 Google Cloud 可用区。

验证代理安装

如需验证代理是否按预期运行，请完成以下步骤：

RHEL

与您的计算实例建立 SSH 连接。

检查代理软件包的状态：

systemctl status google-cloud-workload-agent

如果代理软件包按预期运行，则输出包含 active (running)。例如：

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

SLES

与您的计算实例建立 SSH 连接。

检查代理软件包的状态：

systemctl status google-cloud-workload-agent

如果代理软件包按预期运行，则输出包含 active (running)。例如：

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Debian

与您的计算实例建立 SSH 连接。

检查代理软件包的状态：

systemctl status google-cloud-workload-agent

如果代理软件包按预期运行，则输出包含 active (running)。例如：

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Windows

使用 RDP 与计算实例建立连接。

如需了解如何执行此操作，请参阅使用 RDP 连接到 Windows 虚拟机。
以管理员身份从 PowerShell 运行以下命令：
```
$(Get-Service -Name 'google-cloud-workload-agent' -ErrorAction Ignore).Status
```
如果代理按预期运行，则状态会显示为 Running。

示例配置文件

以下是一个配置示例，可让 Agent for Compute Workloads 与 Redis 实例建立连接。对于身份验证，系统会使用 Secret Manager Secret，该 Secret 存储在运行 Redis 实例的同一 Google Cloud 项目中。

{
  "log_level": "INFO",
  "common_discovery": {
    "collection_frequency": "10800s"
  },
  "redis_configuration": {
    "enabled": true,
    "connection_parameters": {
      "username": "db_user_name",
      "secret": {
        "secret_name": "db_pwd_secret_name",
        "project_id": ""
      },
      "host": "localhost",
      "port": 1433
    }
  }
}

配置参数

下表介绍了支持 Redis 工作负载评估的 Agent for Compute Workloads 的配置参数：

参数
`log_level`	`String` 如需设置代理的日志记录级别，请设置所需的值。可用的日志级别如下： `DEBUG` `INFO` `WARNING` `ERROR` 默认日志级别为 `INFO`。除非有 Cloud Customer Care 的指导，否则请勿更改日志记录级别。
`log_to_cloud`	`Boolean` 如需将代理的日志重定向到 Cloud Logging，请指定 `true`。默认值为 `true`。
`agent_properties.log_usage_metrics`	`Boolean` 如需启用代理健康状况指标的日志记录，请将该值设置为 `true`。默认值为 `false`。
`common_discovery.collection_frequency`	`Duration` 指定代理的工作负载发现服务运行的频率（以秒为单位）。默认值为 `10800s`。确保此参数的值以小写字母 `s` 结尾。
`redis_configuration.enabled`	`Boolean` 如需让代理从 Redis 实例收集指标，请将该值设置为 `true`。默认值为 `false`。重要提示：如需使其他 Redis 特定的代理参数正常运行，您必须将 `redis_configuration.enabled` 设置为 `true`。
`redis_configuration.connection_parameters.username`	`String` 指定代理用于查询 Redis 实例的用户账号。
`redis_configuration.connection_parameters.password`	`String` 指定代理用于查询 Redis 实例的用户账号的纯文本密码。我们建议您使用 `secret.name` 和 `secret.project_id` 参数，而不是指定明文密码。对于身份验证，代理会按以下优先顺序使用参数：如果指定了 `secret` 参数集，则优先使用该参数集，而不是 `password` 参数。我们建议您在代理的配置文件中仅设置一个身份验证选项。
`redis_configuration.connection_parameters.secret.secret_name`	`String` 可选。为了安全地提供代理用于查询 Redis 实例的用户账号的密码，请指定包含该密码的 Secret Manager Secret 的名称。对于身份验证，代理会按以下优先顺序使用参数：如果指定了 `secret` 参数集，则优先使用该参数集，而不是 `password` 参数。我们建议您在代理的配置文件中仅设置一个身份验证选项。
`redis_configuration.connection_parameters.secret.project_id`	`String` 可选。如需使用 `secret.secret_name` 参数对指定的用户账号进行身份验证，请指定存储 Secret Manager 密文的 Google Cloud 项目的项目 ID。如果 Secret 和工作负载位于同一 Google Cloud 项目中，则将此参数的值设置为空字符串 (`""`)。
`redis_configuration.connection_parameters.host`	`String` 指定 Redis 主机名。
`redis_configuration.connection_parameters.port`	`Int` 指定 Redis 实例接受查询的端口。

为 Redis 工作负载设置代理 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

代理所需的 IAM 角色

启用对 Cloud API 的访问权限

使用软件包管理器安装和配置代理

RHEL

SLES

Debian

Windows

使用虚拟机扩展程序管理器在一组虚拟机上安装和管理代理

设置虚拟机扩展程序管理器

在一组虚拟机上安装和配置代理

在 Google Cloud 项目中的虚拟机上安装和配置代理

控制台

gcloud

在特定可用区内的虚拟机上安装和配置代理

控制台

gcloud

管理一组虚拟机上的代理

在一组虚拟机上修改代理配置

控制台

gcloud

更新全局政策以纳入新可用区

更新全局政策以排除可用区

从一组虚拟机中卸载代理

控制台

gcloud

验证代理安装

RHEL

SLES

Debian

Windows

示例配置文件

配置参数

后续步骤

为 Redis 工作负载设置代理