• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 将 SSM Agent 日志发送到 CloudWatch Logs
<a name="monitoring-ssm-agent"></a>

AWS Systems Manager Agent（SSM Agent）是在为 Systems Manager 配置的 EC2 实例、边缘设备、本地服务器和虚拟机（VM）上运行的 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> 标签后添加 *custom name* 元素。在以下示例中，指定的 custom name 名称为 `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 进行整理。