• 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 日誌傳送至 CloudWatch Logs
<a name="monitoring-ssm-agent"></a>

AWS Systems Manager 代理程式 (SSM Agent) 是在為 Systems Manager 設定的 EC2 執行個體、邊緣裝置、內部部署伺服器和虛擬機器 (VMs) 上執行的 Amazon 軟體。 SSM Agent會在雲端處理 Systems Manager 服務的請求，並依照請求中的指定設定您的機器。如需 SSM Agent 的詳細資訊，請參閱 [使用 SSM Agent](ssm-agent.md)。

此外，您可以使用下列步驟，設定 SSM Agent 以傳送日誌資料至 Amazon CloudWatch Logs。

**開始之前**  
在 CloudWatch Logs 中建立日誌群組。如需詳細資訊，請參閱*《Amazon CloudWatch Logs 使用者指南》*中的 [CloudWatch Logs 入門](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_GettingStarted.html)。

**若要設定 SSM Agent 以將日誌傳送至 CloudWatch**

1. 登入節點並找出下列檔案：

**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`

**macOS**  
`/opt/aws/ssm/seelog.xml.template`

**Windows**  
`%ProgramFiles%\Amazon\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 -pr /snap/amazon-ssm-agent/current/* /etc/amazon/ssm
   ```

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

1. 使用文字編輯器開啟 `seelog.xml` 檔案，並找出下列區段。

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

   ```
   <outputs formatid="fmtinfo">
      <console formatid="fmtinfo"/>
      <rollingfile type="size" filename="/var/log/amazon/ssm/amazon-ssm-agent.log" maxsize="30000000" maxrolls="5"/>
      <filter levels="error,critical" formatid="fmterror">
         <rollingfile type="size" filename="/var/log/amazon/ssm/errors.log" maxsize="10000000" maxrolls="5"/>
      </filter>
   </outputs>
   ```

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

   ```
   <outputs formatid="fmtinfo">
      <console formatid="fmtinfo"/>
      <rollingfile type="size" maxrolls="5" maxsize="30000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\amazon-ssm-agent.log"/>
      <filter formatid="fmterror" levels="error,critical">
         <rollingfile type="size" maxrolls="5" maxsize="10000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\errors.log"/>
      </filter>
   </outputs>
   ```

------

1. 編輯檔案，在 </filter> 結束標籤後面新增*自訂名稱*元素。在以下範例中，自訂名稱已指定為 `cloudwatch_receiver`。

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

   ```
   <outputs formatid="fmtinfo">
      <console formatid="fmtinfo"/>
      <rollingfile type="size" filename="/var/log/amazon/ssm/amazon-ssm-agent.log" maxsize="30000000" maxrolls="5"/>
      <filter levels="error,critical" formatid="fmterror">
         <rollingfile type="size" filename="/var/log/amazon/ssm/errors.log" maxsize="10000000" maxrolls="5"/>
      </filter>
      <custom name="cloudwatch_receiver" formatid="fmtdebug" data-log-group="your-CloudWatch-log-group-name"/>
   </outputs>
   ```

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

   ```
   <outputs formatid="fmtinfo">
      <console formatid="fmtinfo"/>
      <rollingfile type="size" maxrolls="5" maxsize="30000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\amazon-ssm-agent.log"/>
      <filter formatid="fmterror" levels="error,critical">
         <rollingfile type="size" maxrolls="5" maxsize="10000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\errors.log"/>
      </filter>
      <custom name="cloudwatch_receiver" formatid="fmtdebug" data-log-group="your-CloudWatch-log-group-name"/>
   </outputs>
   ```

------

1. 儲存變更，然後重新啟動 SSM Agent 或節點。

1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇 **Log groups (日誌群組)**，然後選擇日誌群組的名稱。
**提示**  
SSM Agent日誌檔資料的日誌串流依節點 ID 組織。