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

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

您可以使用本節中的資訊，對 CloudWatch 代理程式可能遇到的問題進行疑難排解。

CloudWatch 代理程式命令列參數

若要查看 CloudWatch 代理程式支援的完整參數清單，請在您安裝所在的電腦，在命令列輸入以下內容：

amazon-cloudwatch-agent-ctl -help

使用 Run Command 安裝 CloudWatch 代理程式失敗

若要使用 Systems Manager Run Command 安裝 CloudWatch 代理程式，目標伺服器上的 SSM 代理程式必須是 2.2.93.0 版或更新版本的 SSM 代理程式。如果您的 SSM Agent 不是正確的版本，您可能會看到錯誤，其中包含以下訊息：

no latest version found for package AmazonCloudWatchAgent on platform linux

failed to download installation package reliably

如需有關更新 SSM Agent 版本的資訊，請參閱《AWS Systems Manager 使用者指南》中的安裝和設定 SSM Agent。

CloudWatch 代理程式無法啟動

如果 CloudWatch 代理程式無法啟動，表示您的設定可能有問題。組態資訊會記錄在 configuration-validation.log 檔案中。此檔案在 Linux 伺服器上位於 /opt/aws/amazon-cloudwatch-agent/logs/configuration-validation.log，在執行 Windows Server 的伺服器上則位於 $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\configuration-validation.log。

確認 CloudWatch 代理程式正在執行中

您可以查詢 CloudWatch 代理程式，以確認它是否正在執行或已停止。您可以使用 AWS Systems Manager 從遠端執行此操作。您也可以使用命令列，但只會檢查本機伺服器。

如果代理程式正在執行，輸出會如下所示。

{
       "status": "running",
       "starttime": "2017-12-12T18:41:18",
       "version": "1.73.4"
}

如果代理程式已停止，"status" 欄位將顯示 "stopped"。

CloudWatch 代理程式不會啟動，且錯誤提及 Amazon EC2 區域

若代理程式未啟動，而且錯誤訊息提及 Amazon EC2 區域端點，則您可能已將代理程式設定為需要存取 Amazon EC2 端點，卻沒有授予該存取權限。

例如，您若指定代理程式組態檔案中 append_dimensions 參數的值 (取決於 Amazon EC2 中繼資料)，而且您使用代理，那麼您必須確保伺服器可以存取 Amazon EC2 的端點。如需有關這些端點的詳細資訊，請參閱 Amazon Web Services 一般參考中的 Amazon Elastic Compute Cloud (Amazon EC2)。

CloudWatch 代理程式無法在 Windows Server 上啟動

若使用的是 Windows Server，您可能會看到下列錯誤：

Start-Service : Service 'Amazon CloudWatch Agent (AmazonCloudWatchAgent)' cannot be started due to the following
error: Cannot start service AmazonCloudWatchAgent on computer '.'.
At C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1:113 char:12
+     $svc | Start-Service
+            ~~~~~~~~~~~~~
    + CategoryInfo          : OpenError: (System.ServiceProcess.ServiceController:ServiceController) [Start-Service],
   ServiceCommandException
    + FullyQualifiedErrorId : CouldNotStartService,Microsoft.PowerShell.Commands.StartServiceCommand

若要修正此問題，請先確定伺服器服務正在執行中。如果代理程式嘗試在未執行伺服器服務時啟動，就可以看到此錯誤。

如果伺服器服務已在執行中，可能是下列問題。在某些 Windows Server 安裝上，CloudWatch 代理程式需要 30 秒以上的時間才能啟動。由於 Windows Server 依預設只允許服務有 30 秒的時間進行啟動，因此這會導致代理程式失敗，並出現類似以下的錯誤：

若要修正此問題，請增加服務逾時值。如需詳細資訊，請參閱服務未啟動，且事件 7000 和 7011 已記錄在 Windows 事件記錄檔中。

指標在哪裡？

如果 CloudWatch 代理程式已執行，但您在 AWS Management Console 或 中找不到其收集的指標 AWS CLI，請確認您使用的是正確的命名空間。根據預設，代理程式所收集指標的命名空間為 CWAgent。您可以使用代理程式組態檔案中 metrics 區段的 namespace 欄位來自訂此命名空間。如果看不到您預期的指標，請檢查組態檔案以確認所使用的命名空間。

當您首次下載 CloudWatch 代理程式套件時，代理程式組態檔案為 amazon-cloudwatch-agent.json。此檔案位於您當初執行設定精靈的目錄，或者您可能已將它移到不同的目錄。如果您使用設定精靈，精靈輸出的代理程式組態檔案名為 config.json。如需有關組態檔案的詳細資訊，包括 namespace 欄位，請參閱 CloudWatch 代理程式組態檔案：Metrics (指標) 區段。

CloudWatch 代理程式需要在容器中執行很長時間，或是記錄跳轉限制錯誤

當您以容器服務的形式執行 CloudWatch 代理程式，並希望將 Amazon EC2 指標維度新增至代理程式收集的所有指標時，您可能會在代理程式的 v1.247354.0 版本中看到下列錯誤：

2022-06-07T03:36:11Z E! [processors.ec2tagger] ec2tagger: Unable to retrieve Instance Metadata Tags. This plugin must only be used on an EC2 instance.
2022-06-07T03:36:11Z E! [processors.ec2tagger] ec2tagger: Please increase hop limit to 2 by following this document https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html#configuring-IMDS-existing-instances.
2022-06-07T03:36:11Z E! [telegraf] Error running agent: could not initialize processor ec2tagger: EC2MetadataRequestError: failed to get EC2 instance identity document
caused by: EC2MetadataError: failed to make EC2Metadata request
        status code: 401, request id: 
caused by:

如果代理程式試圖在沒有適當跳轉限制的情況下從容器內的 IMDSv2 取得中繼資料，您可能會看到此錯誤。在比 v1.247354.0 更早的代理程式版本中，您可能會遇見此問題但看不到此日誌訊息。

若要解決此問題，請依照設定執行個體中繼資料選項中的指示將跳轉限制增加至 2。

我已更新代理程式設定，但在 CloudWatch 主控台中看不到新的指標或日誌

如果您更新 CloudWatch 代理程式組態檔案，則下次啟動代理程式時，您需要使用 fetch-config 選項。例如，如果您將更新的檔案存放在本機電腦上，請輸入下列命令：

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -s -m ec2 -c file:configuration-file-path

CloudWatch 代理程式檔案和位置

下表列出 CloudWatch 代理程式安裝和使用的檔案，以及這些檔案在執行 Linux 或 Windows Server 伺服器上的位置。

尋找 CloudWatch 代理程式版本的相關資訊

若要尋找 Linux 伺服器上的 CloudWatch 代理程式版本編號，請輸入以下命令：

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a status

若要尋找 Windows Server 上的 CloudWatch 代理程式版本編號，請輸入以下命令：

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status

您也可以下載有關代理程式最新變更的 README 檔案，以及指出目前可供下載之版本編號的檔案。這些檔案位於下列位置 :

CloudWatch 代理程式產生的日誌

代理程式會在執行時產生日誌。此日誌包含故障診斷資訊。此日誌是 amazon-cloudwatch-agent.log 檔案。此檔案在 Linux 伺服器上位於 /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log，在執行 Windows Server 的伺服器上則位於 $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\amazon-cloudwatch-agent.log。

您可以設定代理程式在 amazon-cloudwatch-agent.log 檔案中記錄其他詳細資訊。在代理程式組態檔案的 agent 區段中，將 debug 欄位設為 true，然後重新設定並重新啟動 CloudWatch 代理程式。若要停用此額外資訊的記錄，請將 debug 欄位設為 false。然後，重新設定並重新啟動代理程式。如需詳細資訊，請參閱手動建立或編輯 CloudWatch 代理程式組態檔案。

在 CloudWatch 代理程式 1.247350.0 版及更新版本中，您可以選擇將代理程式組態檔案 agent 區段中的 aws_sdk_log_level 欄位設為下列選項中的一或多項。如有多個選項，請使用 | 字元進行分隔。

如需這些選項的詳細資訊，請參閱 LogLevelType。

停用和重新啟動 CloudWatch 代理程式

您可以使用 AWS Systems Manager 或 命令列手動停止 CloudWatch 代理程式。

若要重新啟動代理程式，請按照 (選用) 修改 CloudWatch 代理程式的常見組態和命名描述檔 中的說明操作。