使用 CloudWatch 代理程式收集指標、日誌和追蹤

統一的 CloudWatch 代理程式可讓您執行以下操作：

• 從 Amazon EC2 執行個體跨作業系統收集內部系統層級指標。除了 EC2 執行個體的指標外，指標還可以包含訪客指標。可收集的其他指標會在 CloudWatch 代理程式收集的指標中列出。

• 從現場部署伺服器收集系統層級指標。這些可能包括混合環境中的伺服器，以及不受 管理的伺服器 AWS。

• 使用 StatsD 和 collectd 通訊協定從您的應用程式或服務擷取自訂指標。Linux 伺服器和執行 Windows 的伺服器都支援 StatsD。collectd 則僅有 Linux 伺服器支援。

• 從 Amazon EC2 執行個體和執行 Linux 或 Windows Server 的內部部署伺服器收集日誌。

  注意

  CloudWatch 代理程式不支援從 FIFO 管道收集日誌。

• 版本 1.300031.0 及更新版本可用於啟用 CloudWatch Application Signals。如需詳細資訊，請參閱Application Signals。

• 版本 1.300025.0 及更新版本可從 OpenTelemetry 或 X-Ray 用戶端 SDK 中收集追蹤，並將其傳送至 X-Ray。

  使用 CloudWatch 代理程式可讓您收集追蹤，而無需執行單獨的追蹤收集常駐程式，有助於減少您執行和管理的代理程式數量。

您可以讓代理程式將其收集的指標傳送到 CloudWatch 或 Amazon Managed Service for Prometheus 或兩者。傳送至 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 或任何公開論壇上。相反地，請遵循漏洞報告或直接傳送電子郵件 AWS 安全中的指示。

本節中的步驟說明如何在 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) 的電腦

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

• Windows 11

• 64 位元 Windows 10

下列作業系統上的 AMD64 架構都支援代理程式。此處所列出每個主要版本的所有次要版本更新也支援此代理程式。

• 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. 建立 IAM 角色或使用者，讓代理程式能夠從伺服器收集指標，並選擇性地與 整合 AWS Systems Manager。

2. 下載代理程式套件。

3. 修改 CloudWatch 代理程式組態檔案，並指定您希望收集的指標。

4. 在您的伺服器上安裝及啟動代理程式。當您在 EC2 執行個體上安裝代理程式時，您可以連接您在步驟 1 建立的 IAM 角色。當您在內部部署伺服器上安裝代理程式時，您可以指定一個具名描述檔，其中包含您在步驟 1 中所建立 IAM 使用者的登入資料。

目錄

• 安裝 CloudWatch 代理程式

• 使用 在新執行個體上安裝 CloudWatch 代理程式 AWS CloudFormation

• CloudWatch 代理程式登入資料偏好設定

• 驗證 CloudWatch 代理程式套件的簽章

• 建立 CloudWatch 代理程式組態檔案

• 使用 Amazon CloudWatch 可觀測性 EKS 附加元件或 Helm Chart 安裝 CloudWatch 代理程式 Amazon CloudWatch

• CloudWatch 代理程式收集的指標

• 使用 CloudWatch 代理程式搭配相關的遙測

• CloudWatch 代理程式的常用使用案例

• 針對 CloudWatch 代理程式進行疑難排解