(選用) 開啟 Session Manager 外掛程式日誌 - AWS Systems Manager

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

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