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

# （可选）开启 Session Manager 插件日志记录
<a name="install-plugin-configure-logs"></a>

Session Manager 插件包括一个允许对运行的会话进行日志记录的选项。默认情况下，日志记录处于关闭状态。

如果允许日志记录，则 Session Manager 插件会在本地计算机上为应用程序活动 (`session-manager-plugin.log`) 和错误 (`errors.log`) 创建日志文件。

**Topics**
+ [开启 Session Manager 插件的日志记录（Windows）](#configure-logs-windows)
+ [启用 Session Manager 插件的日志记录（Linux 和 macOS）](#configure-logs-linux)

## 开启 Session Manager 插件的日志记录（Windows）
<a name="configure-logs-windows"></a>

1. 找到插件的 `seelog.xml.template` 文件。

   默认位置是 `C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template`。

1. 将文件名更改为 `seelog.xml`。

1. 打开文件，然后将 `minlevel="off"` 更改为 `minlevel="info"` 或 `minlevel="debug"`。
**注意**  
默认情况下，有关打开数据通道和重新连接会话的日志条目在 **INFO** (信息) 级别记录。数据流（数据包和确认）条目在 **DEBUG** (调试) 级别记录。

1. 更改要修改的其他配置选项。可以更改的选项包括：
   + **调试级别**：您可以将调试级别从 `formatid="fmtinfo"` 更改为 `formatid="fmtdebug"`。
   + **日志文件选项**：您可以更改日志文件选项，包括日志的存储位置，但日志文件名除外。
**重要**  
不要更改文件名，否则日志记录无法正常工作。

     ```
     <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\session-manager-plugin.log" maxsize="30000000" maxrolls="5"/>
     <filter levels="error,critical" formatid="fmterror">
     <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\errors.log" maxsize="10000000" maxrolls="5"/>
     ```

1. 保存该文件。

## 启用 Session Manager 插件的日志记录（Linux 和 macOS）
<a name="configure-logs-linux"></a>

1. 找到插件的 `seelog.xml.template` 文件。

   默认位置是 `/usr/local/sessionmanagerplugin/seelog.xml.template`。

1. 将文件名更改为 `seelog.xml`。

1. 打开文件，然后将 `minlevel="off"` 更改为 `minlevel="info"` 或 `minlevel="debug"`。
**注意**  
默认情况下，有关打开数据通道和重新连接会话的日志条目在 **INFO** (信息) 级别记录。数据流（数据包和确认）条目在 **DEBUG** (调试) 级别记录。

1. 更改要修改的其他配置选项。可以更改的选项包括：
   + **调试级别**：您可以将调试级别从 `formatid="fmtinfo"` 更改为 `outputs formatid="fmtdebug"`。
   + **日志文件选项**：您可以更改日志文件选项，包括日志的存储位置，但日志文件名除外。
**重要**  
不要更改文件名，否则日志记录无法正常工作。

     ```
     <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/session-manager-plugin.log" maxsize="30000000" maxrolls="5"/>
     <filter levels="error,critical" formatid="fmterror">
     <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/errors.log" maxsize="10000000" maxrolls="5"/>
     ```
**重要**  
如果使用指定的默认目录存储日志，则必须使用 **sudo** 运行会话命令，或者给安装插件的目录指定完全读写权限。要绕过这些限制，请更改存储日志的位置。

1. 保存该文件。