（可选）开启 Session Manager 插件日志记录

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

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

开启 Session Manager 插件的日志记录（Windows）

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

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

2. 将文件名更改为 seelog.xml。

3. 打开文件，然后将 minlevel="off" 更改为 minlevel="info" 或 minlevel="debug"。

   注意

   默认情况下，有关打开数据通道和重新连接会话的日志条目在 INFO (信息) 级别记录。数据流（数据包和确认）条目在 DEBUG (调试) 级别记录。

4. 更改要修改的其他配置选项。可以更改的选项包括：

   • 调试级别：您可以将调试级别从 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"/>

5. 保存该文件。

启用 Session Manager 插件的日志记录（Linux 和 macOS）

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

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

2. 将文件名更改为 seelog.xml。

3. 打开文件，然后将 minlevel="off" 更改为 minlevel="info" 或 minlevel="debug"。

   注意

   默认情况下，有关打开数据通道和重新连接会话的日志条目在 INFO (信息) 级别记录。数据流（数据包和确认）条目在 DEBUG (调试) 级别记录。

4. 更改要修改的其他配置选项。可以更改的选项包括：

   • 调试级别：您可以将调试级别从 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 运行会话命令，或者给安装插件的目录指定完全读写权限。要绕过这些限制，请更改存储日志的位置。

5. 保存该文件。