• 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)。

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

# (選用) 開啟 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. 儲存檔案。