• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

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

# 檢視 SSM Agent 日誌
<a name="ssm-agent-logs"></a>

AWS Systems Manager 代理程式 (SSM Agent) 會將有關執行、命令、排程動作、錯誤和運作狀態的資訊寫入每個受管節點上的日誌檔案。透過手動連線至受管節點，可檢視日誌檔案，或者您可以自動傳送日誌至 Amazon CloudWatch Logs。如需有關將日誌傳送至 CloudWatch Logs 的詳細資訊，請參閱[在 中記錄和監控 AWS Systems Manager](monitoring.md)。

您可以在下列位置中檢視受管節點上的 SSM Agent 日誌。

------
#### [ Linux and macOS ]

 `/var/log/amazon/ssm/` 

------
#### [ Windows ]

 `%PROGRAMDATA%\Amazon\SSM\Logs\` 

------

對於 Linux 受管節點，SSM Agent `stderr` 和 `stdout` 檔案會寫入下列目錄：`/var/lib/amazon/ssm/`。

對於 Windows 受管節點，SSM Agent `stderr` 和 `stdout` 檔案會寫入下列目錄：`%PROGRAMDATA%\Amazon\SSM\InstanceData\`。

如需有關允許 SSM Agent 偵錯記錄的資訊，請參閱 [允許 SSM Agent 偵錯記錄](#ssm-agent-debug-log-files)。

如需有關 `cihub/seelog` 組態的詳細資訊，請參閱 GitHub 上的 [Seelog Wiki](https://github.com/cihub/seelog/wiki)。如需 `cihub/seelog` 組態的範例，請參閱 GitHub 上的 [cihub/seelog 範例](https://github.com/cihub/seelog-examples)儲存庫。

## 允許 SSM Agent 偵錯記錄
<a name="ssm-agent-debug-log-files"></a>

使用下列程序，以便允許受管節點上的 SSM Agent 偵錯記錄。

------
#### [ Linux and macOS ]

**允許 SSM Agent 對 Linux 和 macOS 受管節點上的日誌記錄進行偵錯**

1. 使用 中的Session Manager工具 AWS Systems Manager連線到您要允許偵錯記錄的受管節點，或登入受管節點。如需詳細資訊，請參閱[使用 Session Manager](session-manager-working-with.md)。

1. 找到 **seelog.xml.template** 檔案。

   **Linux**︰

   在大多數 Linux 受管節點類型上，檔案位於目錄 `/etc/amazon/ssm/seelog.xml.template` 中。

   在 Ubuntu Server 20.04、18.04 和 16.04 LTS 上，檔案位於目錄 `/snap/amazon-ssm-agent/current/seelog.xml.template` 中。將此檔案從 `/snap/amazon-ssm-agent/current/` 目錄複製至 `/etc/amazon/ssm/` 目錄，然後再進行任何變更。

   **macOS**: 

   在 macOS 執行個體類型上，檔案位於目錄 `/opt/aws/ssm/seelog.xml.template` 中。

1. 將檔名從 `seelog.xml.template` 變更為 `seelog.xml`。
**注意**  
在 Ubuntu Server 20.04、18.04 和 16.04 LTS 上，必須在目錄 `/etc/amazon/ssm/` 中建立檔案 `seelog.xml`。可透過執行下列命令來建立此目錄和檔案。  

   ```
   sudo mkdir -p /etc/amazon/ssm
   ```

   ```
   sudo cp -p /snap/amazon-ssm-agent/current/seelog.xml.template /etc/amazon/ssm/seelog.xml
   ```

1. 編輯 `seelog.xml` 檔案以變更預設的記錄行為。將 **minlevel (minlevel)** 的值從 **info (資訊)** 變更為 **debug (除錯)**，如以下範例所示。

    `<seelog type="adaptive" mininterval="2000000" maxinterval="100000000" critmsgcount="500" minlevel="debug">` 

1. (選用) 使用以下命令重新啟動 SSM Agent。

   Linux︰

   ```
   sudo service amazon-ssm-agent restart
   ```

   macOS:

   ```
   sudo /opt/aws/ssm/bin/amazon-ssm-agent restart
   ```

------
#### [ Windows ]

**允許 SSM Agent 對 Windows Server 受管節點上的日誌記錄進行偵錯**

1. 您可以使用 Session Manager 來連線至想要允許偵錯日誌記錄的受管節點，或登入受管節點。如需詳細資訊，請參閱[使用 Session Manager](session-manager-working-with.md)。

1. 請複製 **seelog.xml.template** 檔案。將該複製的檔案名稱改為 **seelog.xml**。檔案位於以下目錄：

    `%PROGRAMFILES%\Amazon\SSM\seelog.xml.template` 

1. 編輯 `seelog.xml` 檔案以變更預設的記錄行為。將 **minlevel (minlevel)** 的值從 **info (資訊)** 變更為 **debug (除錯)**，如以下範例所示。

    `<seelog type="adaptive" mininterval="2000000" maxinterval="100000000" critmsgcount="500" minlevel="debug">` 

1. 找到下列項目。

    `filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\{{EXECUTABLENAME}}.log"` 

   變更此項目以使用以下路徑。

    `filename="C:\ProgramData\Amazon\SSM\Logs\{{EXECUTABLENAME}}.log"` 

1. 找到下列項目。

    `filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\errors.log"` 

   變更此項目以使用以下路徑。

    `filename="C:\ProgramData\Amazon\SSM\Logs\errors.log"` 

1. 在管理員模式中使用下列 PowerShell 命令，重新啟動 SSM Agent。

   ```
   Restart-Service AmazonSSMAgent
   ```

------