旧版 Monitoring 和 Logging 代理支持服务终止

重要提示：此弃用仅适用于您安装了旧版 Monitoring 代理或旧版 Logging 代理的环境，不适用于具有内置或预安装 监控和日志记录代理的托管式环境。

自 2026 年 9 月 28 日起，旧版 Monitoring 代理和 Logging 代理已正式终止支持。我们将不再发布此软件的新版本，并且所有标准支持和维护都已结束。

虽然旧版代理的现有安装不会关闭，并且会继续将日志流式传输到 Cloud Logging，将指标流式传输到 Cloud Monitoring，但我们不再建议使用这些代理。不过，这些分发版本仍可供下载和安装。

继续使用旧版代理意味着您将无法收到更新、bug 修复或对新操作系统的支持，最终导致与 Google Cloud Observability 不兼容。我们强烈建议您迁移到受支持的替代方案。

要点和日期

以下是旧版 Logging 代理弃用的关键日期：

• 2026 年 9 月 28 日，旧版代理的标准维护和常规 bug 修复将结束。12 个月的迁移宽限期开始。 在此期间，Cloud Customer Care 将通过支持服务工单协助您完成迁移工作。
• 2027 年 9 月 28 日，Cloud Customer Care 迁移协助将正式结束。在此日期之后，您需要自行负责处理迁移。

可供选择的迁移方案

我们建议您尽快迁移到以下受支持的替代方案之一：

• Ops Agent：用于从 Compute Engine 实例收集遥测数据的主要代理和首选代理。此代理将日志记录和指标组合到单个代理中，提供了用于收集日志和指标的基于 YAML 的配置，并具有高吞吐量日志记录功能。如需了解详情，请参阅从旧版代理迁移到 Ops Agent。
• Google 构建的 OpenTelemetry 收集器：Google 的开源 OpenTelemetry 收集器的可用于生产用途的版本。借助该收集器，您可以将相关的 OpenTelemetry 协议 (OTLP) 跟踪记录、指标和日志从应用发送到 Google Cloud Observability 和其他后端。如需了解详情，请参阅 Google 构建的 OpenTelemetry 收集器概览。
• 上游 Fluentd（仅限日志记录）：旧版 Logging 代理基于的开源、社区驱动的日志数据收集器。许多旧版环境使用高度自定义的 Fluentd 配置，这些配置无法针对 Ops Agent 进行转换。通过将上游 Fluentd 与 Google 平台插件配对，您可以维护当前设置，并确保日志继续不间断地流入 Cloud Logging。如需了解详情，请参阅从旧版 Logging 代理迁移到上游 Fluentd。

确定受影响的 Compute Engine 实例

如需识别运行旧版 Monitoring 代理或旧版 Logging 代理的 Compute Engine 实例，请按照以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Metrics Explorer 页面：

   进入 Metrics Explorer

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

2. 在查询构建器窗格的工具栏中，选择名为  PromQL 的按钮。
3. 在结果窗格中，选择表格。
4. 在编辑器中输入以下查询之一，然后点击运行查询：
   • 如需生成一个表，其中列出运行代理的每个虚拟机的实例 ID 以及代理的版本，请使用以下命令：

     max by (instance_id, version, ${__groupby}) ({__name__="agent.googleapis.com/agent/uptime", monitored_resource="gce_instance"})
             

   • 如需生成一个表格来显示运行每个代理版本的实例总数，请使用以下命令：

     count by (version, ${__groupby}) ({__name__="agent.googleapis.com/agent/uptime", monitored_resource="gce_instance"})
             

   在版本列中，显示 stackdriver_agent 的条目是指旧版 Monitoring 代理，而显示 google-fluentd 的条目是指旧版 Logging 代理。