

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 CloudWatch 代理程式收集指標、日誌和追蹤
<a name="Install-CloudWatch-Agent"></a>

CloudWatch 代理程式是一種軟體元件，可從 Amazon EC2 執行個體、內部部署伺服器和容器化應用程式收集指標、日誌和追蹤。相較於預設提供的基本監控，它可讓您更全面地監控基礎結構和應用程式。

**主要優點**
+ 收集系統層級指標 (CPU、記憶體、磁碟、網路) 
+ 從應用程式收集自訂指標
+ 從各種來源收集和集中日誌
+ 使用單一工具同時監控 AWS 和內部部署環境 
+ 根據收集的資料設定警示和通知 

CloudWatch 代理程式可讓您執行以下動作：
+ 從 Amazon EC2 執行個體跨作業系統收集內部系統層級指標。除了 EC2 執行個體的指標外，指標還可以包含訪客指標。可收集的其他指標會在 [CloudWatch 代理程式收集的指標](metrics-collected-by-CloudWatch-agent.md)中列出。
+ 從現場部署伺服器收集系統層級指標。這些可能包括混合環境中的伺服器，以及不受 管理的伺服器 AWS。
+ 使用 `StatsD` 和 `collectd` 通訊協定從您的應用程式或服務擷取自訂指標。Linux 伺服器和執行 Windows 的伺服器都支援 `StatsD`。`collectd` 則僅有 Linux 伺服器支援。
+ 從 Amazon EC2 執行個體和執行 Linux 或 Windows Server 的內部部署伺服器收集日誌。
**注意**  
CloudWatch 代理程式不支援從 FIFO 管道收集日誌。
+ 將指標傳送至 CloudWatch 或 Amazon Managed Service for Prometheus，或同時傳送至兩者。CloudWatch 代理程式設定檔的 `metrics` 區段包含 `metrics_destinations` 參數。您可以在此參數中指定 `cloudwatch`、`amp` 或同時指定兩者。
+ 版本 1.300031.0 及更新版本可用於啟用 CloudWatch Application Signals。如需詳細資訊，請參閱[應用程式訊號](CloudWatch-Application-Monitoring-Sections.md)。
+ 版本 1.300025.0 及更新版本可從 [OpenTelemetry](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-opentel) 或 [X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html#xray-instrumenting-xray-sdk) 用戶端 SDK 中收集追蹤，並將其傳送至 X-Ray。

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

可以在 CloudWatch 中檢視傳送至 CloudWatch 的指標，如同檢視任何其他 CloudWatch 指標一樣。CloudWatch 代理程式收集之指標的預設 CloudWatch 命名空間是 `CWAgent`，不過您可以在設定代理程式時指定不同的命名空間。

透過 CloudWatch 代理程式收集的日誌，會在 Amazon CloudWatch Logs 中處理和存放，如同較舊的 CloudWatch Logs 代理程式收集的日誌。如需 CloudWatch Logs 定價的資訊，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing)。

CloudWatch 代理程式收集的指標以自訂指標計費。如需 CloudWatch 指標定價的詳細資訊，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing)。

CloudWatch 代理程式依 MIT 授權下是開源的，並且是[在 GitHub 中託管](https://github.com/aws/amazon-cloudwatch-agent/)。如果您想要建置、自訂或影響 CloudWatch 代理程式，請參閱 GitHub 儲存庫以取得最新指示。如果您認為您發現潛在安全問題，請勿將其發佈在 GitHub 或任何公開論壇上。反之，請遵循[漏洞報告](https://aws.amazon.com/security/vulnerability-reporting/)或[電子郵件 AWS 安全性中](mailto:aws-security@amazon.com)的指示。

您可以使用命令列手動下載並安裝 CloudWatch 代理程式，也可以將其與 AWS Systems Manager 整合。安裝 CloudWatch 代理程式的一般流程如下：

1. 建立 IAM 角色或使用者，讓代理程式能夠從伺服器收集指標，並選擇性地與 AWS Systems Manager 整合。

1. 下載代理程式套件。

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

1. 在您的伺服器上安裝及啟動代理程式。

**Topics**
+ [支援的作業系統](supported-operating-systems.md)
+ [先決條件](prerequisites.md)
+ [下載 CloudWatch 代理程式套件](download-CloudWatch-Agent-on-EC2-Instance-commandline-first.md)
+ [驗證 CloudWatch 代理程式套件的簽章](verify-CloudWatch-Agent-Package-Signature.md)
+ [安裝 CloudWatch 代理程式](install-CloudWatch-Agent-on-EC2-Instance.md)
+ [使用安全增強型 Linux (SELinux) 設定 CloudWatch 代理程式](CloudWatch-Agent-SELinux.md)
+ [建立 CloudWatch 代理程式組態檔案](create-cloudwatch-agent-configuration-file.md)
+ [啟動 CloudWatch 代理程式](start-CloudWatch-Agent-on-premise-SSM-onprem.md)
+ [CloudWatch 代理程式收集的指標](metrics-collected-by-CloudWatch-agent.md)
+ [搭配相關遙測使用 CloudWatch 代理程式](CloudWatch-Agent-RelatedEntities.md)
+ [CloudWatch 代理程式的常用使用案例](CloudWatch-Agent-common-scenarios.md)
+ [CloudWatch 代理程式憑證偏好設定](CloudWatch-Agent-Credentials-Preference.md)
+ [針對 CloudWatch 代理程式進行疑難排解](troubleshooting-CloudWatch-Agent.md)