将 Ops Agent 安装在单个虚拟机上

Linux

1. 使用 SSH 或类似工具建立与虚拟机实例的终端连接，并确保您拥有 sudo 访问权限。

2. 切换到您具有写入权限的目录，例如您的主目录。

3. 使用以下命令下载并运行代理安装脚本：

   curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
   sudo bash add-google-cloud-ops-agent-repo.sh --also-install
   

   安装完成后，该代理会自动启动。

Windows

1. 使用 RDP 或类似工具连接到您的实例，然后登录到 Windows。

2. 右键点击 PowerShell 图标并选择以管理员身份运行，以管理员权限打开 PowerShell 终端。

3. 运行以下 PowerShell 命令：

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
   Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall"
   

Linux

1. 使用 SSH 或类似工具建立与虚拟机实例的终端连接，并确保您拥有 sudo 访问权限。

2. 切换到您具有写入权限的目录，例如您的主目录。

3. 下载代理安装脚本：

   curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
   

   运行 add-google-cloud-ops-agent-repo.sh 脚本时，您还可以设置以下标志：

   • --verbose：在脚本执行期间启用详细日志记录。
   • --also-install：添加代理软件包代码库后安装代理。
   • --version：设置要安装的脚本的代理版本。 如需了解版本信息，请参阅列出所有代理版本。
   • --uninstall：卸载代理。
   • --remove-repo：安装或卸载代理后移除相应的代理软件包代码库。
   • --dry-run：仅触发脚本执行的试运行，并输出应执行的命令。
   • --uninstall-standalone-logging-agent：卸载旧版 Logging 代理 (StackdriverLogging)。
   • --uninstall-standalone-monitoring-agent：卸载旧版 Monitoring 代理 (StackdriverMonitoring)。

   如需了解详情并查看示例注释，请参阅脚本注释。

4. 添加代理的软件包代码库并安装代理：

   1. 如需列出可用的代理版本，请参阅列出所有代理版本。

   2. 对于生产环境，您可能需要固定到某个主要版本，以避免安装可能包含向后不兼容更改的主要版本。如需固定到某个主要版本，请运行以下命令：

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.*.*
      

      例如，如果要固定到代理的 1.x.x 版本，请运行以下命令：

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=1.*.*
      

   3. 如需安装代理的特定版本，请运行以下命令：

      sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
        --version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION
      

您可以在安装脚本成功运行后将其删除。

• 如需验证代理是否按预期工作，请运行以下命令：

  sudo systemctl status google-cloud-ops-agent"*"
  

  验证组件“Logging 代理”和“指标代理”是否正在运行。

如果您在安装时遇到问题，请参阅问题排查页面。

Windows

1. 使用 RDP 或类似工具连接到您的实例，然后登录到 Windows。

2. 右键点击 PowerShell 图标并选择以管理员身份运行，以管理员权限打开 PowerShell 终端。

3. 下载代理安装脚本：

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.ps1", "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1")
   

   运行 add-google-cloud-ops-agent-repo.ps1 脚本时，您还可以设置以下标志：

   • -Verbose：在脚本执行期间启用详细日志记录。
   • -AlsoInstall：添加代理软件包代码库后安装代理。
   • -Version：设置要安装的脚本的代理版本。 如需了解版本信息，请参阅列出所有代理版本。
   • -Uninstall：卸载代理。
   • -RemoveRepo：安装或卸载代理后移除相应的代理软件包代码库。
   • -WhatIf：仅触发脚本执行的试运行，并输出应执行的命令。
   • -UninstallStandaloneLoggingAgent：卸载旧版 Logging 代理 (StackdriverLogging)。
   • -UninstallStandaloneMonitoringAgent：卸载旧版 Monitoring 代理 (StackdriverMonitoring)。

   如需了解详情并查看示例注释，请参阅脚本注释。

4. 添加代理的软件包代码库并安装代理：

   1. 如需列出可用的代理版本，请参阅列出所有代理版本。

   2. 对于生产环境，您可能需要固定到某个主要版本，以避免安装可能包含向后不兼容更改的主要版本。如需固定到某个主要版本，请运行以下命令：

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version MAJOR_VERSION.*.*"
      

      例如，如果要固定到代理的 1.x.x 版本，请运行以下命令：

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.*.*"
      

   3. 如需安装代理的特定版本，请运行以下命令：

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version version-number"
      

      例如：

      Invoke-Expression "${env:UserProfile}\add-google-cloud-ops-agent-repo.ps1 -AlsoInstall -Version 1.0.1"
      

您可以在安装脚本成功运行后将其删除。

• 如需验证代理是否按预期工作，请运行以下命令：

  Get-Service google-cloud-ops-agent
  

  代理的状态应为 Running。

如果您在安装时遇到问题，请参阅问题排查页面。

Cloud Monitoring

在 Google Cloud 控制台中，进入虚拟机实例信息中心页面：

进入虚拟机实例信息中心

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

信息中心的清单标签页上的列表视图列出了所有虚拟机，并包含代理的状态列，如以下屏幕截图所示：

代理列会报告以下值：

• 未检测到：未安装代理或代理未运行。如果您不确定是否已安装代理，则可以查询已安装的版本。如果您已安装代理，则可以重启代理。 如果您已安装并启动 Ops Agent，但状态仍为未检测到，则表示代理可能未正确启动或无法发送指标。

  如需排查启动问题，请参阅代理已安装，但无法运行。如需排查指标注入问题，请参阅排查数据注入问题。常规的代理诊断脚本和健康检查可能也有用。

• Ops Agent：您正在运行 Ops Agent。 如果您在条目旁边没有看到绿色对勾标记，则表示根据检测到的虚拟机操作系统，有可用的代理升级。

  将鼠标悬停在表中的 Ops Agent 指示标志上时，您会看到有关 Ops Agent 版本的信息。如果您运行的是较旧版本，则还会看到升级代理的建议。

• 待处理：正在安装或升级 Ops Agent。

  如果代理安装处于待处理状态超过 10 分钟，则应用 Ops Agent 操作系统政策或启动代理时会出现问题。如需了解问题排查信息，请参阅自动安装政策的代理诊断工具。

• 旧版代理：您正在运行旧版 Monitoring 或 Logging 代理。如需了解如何转换到 Ops Agent，请参阅从旧版代理迁移到 Ops Agent。

• 不适用：此虚拟机不属于运行代理的受支持平台。

• 未知：虚拟机未运行，因此代理的状态未知。

您可以通过执行以下操作来安装 Ops Agent：

• 选择要在其中安装代理的虚拟机实例。
• 点击实例表中的安装/更新 Ops Agent 选项。

您还可以从特定虚拟机的虚拟机详情页面安装或更新 Ops Agent。

尽可能使用 Ops Agent 操作系统政策安装代理。如需了解详情，请参阅管理 Ops Agent 操作系统政策涵盖的虚拟机。并非所有操作系统的所有版本都支持 Ops Agent 操作系统政策。在这种情况下，点击安装/更新 Ops Agent 可提供一系列在 Cloud Shell 中运行的命令。

Ops Agent 默认会收集指标和日志。您可以通过配置 Ops Agent 来更改此默认行为。

Compute Engine

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

   前往虚拟机实例

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

2. 点击要在其中安装代理的虚拟机的名称。

3. 点击可观测性标签页。

4. 点击安装 Ops Agent。

   尽可能使用 Ops Agent 操作系统政策安装代理。如需了解详情，请参阅管理 Ops Agent 操作系统政策涵盖的虚拟机。并非所有操作系统的所有版本都支持 Ops Agent 操作系统政策。在这种情况下，点击安装/更新 Ops Agent 可提供一系列在 Cloud Shell 中运行的命令。

   Ops Agent 默认会收集指标和日志。您可以通过配置 Ops Agent 来更改此默认行为。

   如果代理安装处于待处理状态超过 10 分钟，则应用 Ops Agent 操作系统政策或启动代理时会出现问题。如需了解问题排查信息，请参阅自动安装政策的代理诊断工具。

Linux

1. 修改以下配置文件（如果尚不存在，请创建该文件）：

    /etc/systemd/system.conf
   

2. 将以下内容添加到该文件中：

    DefaultEnvironment="HTTP_PROXY=http://proxy-ip:proxy-port" "HTTPS_PROXY=http://proxy-ip:proxy-port" "NO_PROXY=http://metadata.google.internal"  # Skip proxy for the local Metadata Server.
   

3. 重新加载环境变量：

    sudo systemctl daemon-reload
   

4. 通过在虚拟机实例上运行以下命令来重启该代理。

    sudo systemctl restart google-cloud-ops-agent"*"
   

Windows

1. 如果您使用的是 HTTP 代理，请通过管理员命令提示符运行以下命令。这样会设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量，以便代理可以使用出站 HTTPS 发送数据：

   setx HTTP_PROXY http://proxy-ip:proxy-port /m
   setx HTTPS_PROXY http://proxy-ip:proxy-port /m
   setx no_proxy metadata.google.internal /m
   

Google Cloud 控制台

如需查看虚拟机上 Ops Agent 的版本，请执行以下操作：

• 在 Monitoring 虚拟机实例页面的实例表中，找到虚拟机条目。如需了解导航信息，请参阅使用 Google Cloud 控制台安装代理。

• 将鼠标悬停在表条目中的 Ops Agent 指示标志上。

CENTOS/RHEL

在 Red Hat 或 CentOS Linux 上运行以下命令：

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

DEBIAN/UBUNTU

在 Debian 或 Ubuntu 上运行以下命令：

dpkg-query --show --showformat '${Package} ${Version} ${Architecture} ${Status}\n' google-cloud-ops-agent

SLES/SUSE

在 SUSE 上运行以下命令：

rpm --query --queryformat '%{NAME} %{VERSION} %{RELEASE} %{ARCH}\n' google-cloud-ops-agent

WINDOWS

在 Windows 上运行以下命令：

googet installed google-cloud-ops-agent

LINUX

在您的实例上运行以下命令：

     sudo systemctl restart google-cloud-ops-agent

Windows

1. 使用 RDP 或类似工具连接到您的实例，然后登录到 Windows。

2. 右键点击 PowerShell 图标并选择以管理员身份运行，以管理员权限打开 PowerShell 终端。

3. 运行以下 PowerShell 命令：

Restart-Service google-cloud-ops-agent -Force

Google Cloud 控制台

您可以使用 Cloud Monitoring 安装说明来升级 Ops Agent。如需了解详情，请参阅使用 Google Cloud 控制台安装代理。

Linux

如需将代理升级到最新版本，请运行以下命令：

sudo bash add-google-cloud-ops-agent-repo.sh --also-install

如需将代理升级到特定主要版本的最新版本，请运行以下命令：

sudo bash add-google-cloud-ops-agent-repo.sh --also-install \
  --version=MAJOR_VERSION.*.*

Windows

如需升级到最新的代理版本，请执行以下操作：

1. 使用 RDP 或类似工具连接到您的实例，然后登录到 Windows。

2. 右键点击 PowerShell 图标并选择以管理员身份运行，以管理员权限打开 PowerShell 终端。

   Copy-Item -Path "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml" -Destination "C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.bak"
   

3. 运行以下 PowerShell 命令以移除已安装的代理并运行安装命令：

   googet -noconfirm remove google-cloud-ops-agent
   googet -noconfirm install google-cloud-ops-agent
   

CENTOS/RHEL

列出代理的可用版本：

sudo yum list --showduplicates google-cloud-ops-agent

DEBIAN/UBUNTU

列出代理的可用版本：

sudo apt-cache madison google-cloud-ops-agent

SLES/SUSE

列出代理的可用版本：

sudo zypper search -s google-cloud-ops-agent

WINDOWS

列出代理的可用版本：

googet available google-cloud-ops-agent

Linux

运行以下命令：

sudo bash add-google-cloud-ops-agent-repo.sh --uninstall

（可选）如需在卸载代理之外移除代码库，请将 --remove-repo 附加到上一个命令中。

Windows

如需卸载 Ops Agent，请按照以下步骤操作：

1. 使用 RDP 或类似工具连接到您的实例，然后登录到 Windows。

2. 右键点击 PowerShell 图标并选择以管理员身份运行，以管理员权限打开 PowerShell 终端。

3. 运行以下 PowerShell 命令：

   googet -noconfirm remove google-cloud-ops-agent