使用 CloudWatch 代理收集指标、日志和跟踪信息 - Amazon CloudWatch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

使用 CloudWatch 代理收集指标、日志和跟踪信息

您可以通过统一 CloudWatch 代理执行以下操作：

  • 跨操作系统从 Amazon EC2 实例中收集内部系统级指标。除了 EC2 实例的指标之外，这些指标还可以包括来宾中的指标。可以收集的其他指标列在CloudWatch 代理收集的指标中。

  • 从本地服务器中收集系统级别指标。这些服务器可能包括混合环境中的服务器以及不是由 Amazon 管理的服务器。

  • 使用 StatsD 和 collectd 协议从应用程序或服务中检索自定义指标。StatsD 在 Linux 服务器和运行 Windows Server 的服务器上都受支持。collectd 仅在 Linux 服务器上受支持。

  • 从运行 Linux 或 Windows Server 的 Amazon EC2 实例和本地部署服务器收集日志。

    注意

    CloudWatch 代理不支持从 FIFO 管道收集日志。

  • 将指标发送到 CloudWatch 或 Amazon Managed Service for Prometheus，或者同时发送到两者。CloudWatch 代理配置文件在 metrics 部分中包含一个 metrics_destinations 参数。您可以在此参数中指定 cloudwatch、amp 或同时指定两者。

  • 版本 1.300031.0 及更高版本可用于启用 CloudWatch Application Signals。有关更多信息，请参阅 Application Signals。

  • 版本 1.300025.0 及更高版本可以从 OpenTelemetry 或 X-Ray 客户端开发工具包中收集跟踪数据，并将这些跟踪数据发送到 X-Ray。

    使用 CloudWatch 代理，您可以轻松收集跟踪，而无需运行单独的跟踪收集进程守护程序，这有助于减少运行和管理的代理数量。

发送到 CloudWatch 的指标可以像任何其他 CloudWatch 指标一样在 CloudWatch 中查看。CloudWatch 代理收集的指标的默认 CloudWatch 命名空间为 CWAgent，不过您可以在配置该代理时指定其他命名空间。

由统一 CloudWatch 代理收集的日志在 Amazon CloudWatch Logs中处理和存储，就像较旧的 CloudWatch Logs 代理收集的日志一样。有关 CloudWatch Logs 定价的信息，请参阅 Amazon CloudWatch 定价。

CloudWatch 代理收集的指标按自定义指标计费。有关 CloudWatch 指标定价的信息，请参阅 Amazon CloudWatch 定价。

CloudWatch 代理是 MIT 许可证下的开源代理，并且托管在 GitHub 上。如果您想要构建、自定义或贡献 CloudWatch 代理，请参阅 GitHub 存储库以获取最新说明。如果您认为您发现了潜在的安全问题，请勿将其发布到 GitHub 或任何公共论坛上。请按照漏洞报告中的说明进行操作，或者直接向 Amazon 安全发送电子邮件。

本节中的步骤介绍如何在 Amazon EC2 实例和本地部署服务器上安装统一 CloudWatch 代理。有关 CloudWatch 代理能够收集的指标的更多信息，请参阅 CloudWatch 代理收集的指标。

支持的操作系统

在以下操作系统的 x86-64 架构上支持 CloudWatch 代理。此处列出的每个主要版本的所有次要版本更新也支持该代理。

  • Amazon Linux 2023

  • Amazon Linux 2

  • Ubuntu Server 版本 24.04、23.10、22.04、20.04、18.04、16.04 和 14.04

  • CentOS 版本 9、8 和 7

  • Red Hat Enterprise Linux（RHEL）版本 9、8 和 7

  • Debian 版本 12、11 和 10

  • SUSE Linux Enterprise Server（SLES）版本 15 和 12

  • Oracle Linux 版本 9、8 和 7

  • AlmaLinux 版本 9 和 8

  • Rocky Linux 版本 9 和 8

  • 以下 macOS 计算机：EC2 M1 Mac1 实例以及运行 macOS 14（Sonoma）、macOS 13（Ventura）和 macOS 12（Monterey）的计算机

  • 64 位版本的 Windows Server 2025、Windows Server 2022、Windows Server 2019 和 Windows Server 2016

  • Windows 11

  • 64 位 Windows 10

在以下操作系统的 ARM64 架构上支持该代理。此处列出的每个主要版本的所有次要版本更新也支持该代理。

  • Amazon Linux 2023

  • Amazon Linux 2

  • Ubuntu Server 版本 23.10、22.04、20.04、18.04 和 16.04

  • CentOS 版本 9 和 8

  • Red Hat Enterprise Linux（RHEL）版本 9、8 和 7

  • Debian 版本 12、11 和 10

  • SUSE Linux Enterprise Server 15

  • 以下 macOS 计算机：macOS 14（Sonoma）、macOS 13（Ventura）和 macOS 12（Monterey）

安装过程概览

您可以使用命令行手动下载并安装 CloudWatch 代理，也可以将其与 SSM 集成。使用这两种方法之一安装 CloudWatch 代理的一般流程如下所示：

  1. 创建使代理能够从服务器中收集指标且（可选）与 Amazon Systems Manager 集成的 IAM 角色或用户。

  2. 下载代理软件包。

  3. 修改 CloudWatch 代理配置文件并指定要收集的指标。

  4. 在服务器上安装并启动代理。当您在 EC2 实例上安装代理时，将会附加在步骤 1 中创建的 IAM 角色。当您在本地部署服务器上安装代理时，您会指定一个命名的配置文件，其中包含您在步骤 1 中创建的 IAM 用户的凭证。

内容