檢視 SSM Agent 日誌 - AWS Systems Manager

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

檢視 SSM Agent 日誌

AWS Systems Manager Agent (SSM Agent) 會在各個受管節點的日誌檔案中寫入有關執行、命令、排程動作、錯誤和運作狀態的資訊。您可以透過手動連線到受管節點來檢視日誌檔,也可以自動將日誌傳送到 Amazon CloudWatch Logs。如需將記錄檔傳送至 CloudWatch 記錄檔的詳細資訊,請參閱監控 AWS Systems Manager

您可以在下列位置中檢視受管節點上的 SSM Agent 日誌。

Linux and macOS

/var/log/amazon/ssm/

Windows

%PROGRAMDATA%\Amazon\SSM\Logs\

對於 Linux 受管節點,SSM Agent stderrstdout 檔案會寫入下列目錄:/var/lib/amazon/ssm/

對於 Windows 受管節點,SSM Agent stderrstdout 檔案會寫入下列目錄:%PROGRAMDATA%\Amazon\SSM\InstanceData\

如需有關允許 SSM Agent 偵錯記錄的資訊,請參閱 允許 SSM Agent 偵錯記錄

如需有關cihub/seelog組態的詳細資訊,請參閱(詳)。 GitHub如需cihub/seelog組態範例,請參閱上的 cihub/seelog 範例儲存庫。 GitHub

允許 SSM Agent 偵錯記錄

使用下列程序,以便允許受管節點上的 SSM Agent 偵錯記錄。

Linux and macOS
允許 SSM Agent 對 Linux 和 macOS 受管節點上的日誌記錄進行偵錯
  1. 您可以使用 Session Manager (AWS Systems Manager 的功能) 來連線至想要允許偵錯記錄的受管節點,或登入受管節點。如需詳細資訊,請參閱 使用 Session Manager

  2. 找到 seelog.xml.template 檔案。

    Linux

    在大多數 Linux 受管節點類型上,檔案位於目錄 /etc/amazon/ssm/seelog.xml.template 中。

    在 Ubuntu Server 20.10 STR、20.04、18.04 和 16.04 LTS 上,檔案位於目錄 /snap/amazon-ssm-agent/current/seelog.xml.template 中。將此檔案從 /snap/amazon-ssm-agent/current/ 目錄複製至 /etc/amazon/ssm/ 目錄,然後再進行任何變更。

    macOS:

    在 macOS 執行個體類型上,檔案位於目錄 /opt/aws/ssm/seelog.xml.template 中。

  3. 將檔名從 seelog.xml.template 變更為 seelog.xml

    注意

    在 Ubuntu Server 20.10 STR、20.04、18.04 和 16.04 LTS 上,必須在目錄 /etc/amazon/ssm/ 中建立檔案 seelog.xml。可透過執行下列命令來建立此目錄和檔案。

    sudo mkdir -p /etc/amazon/ssm
    sudo cp -p /snap/amazon-ssm-agent/current/seelog.xml.template /etc/amazon/ssm/seelog.xml
  4. 編輯 seelog.xml 檔案以變更預設的記錄行為。將 minlevel (minlevel) 的值從 info (資訊) 變更為 debug (除錯),如以下範例所示。

    <seelog type="adaptive" mininterval="2000000" maxinterval="100000000" critmsgcount="500" minlevel="debug">

  5. (選用) 使用以下命令重新啟動 SSM Agent。

    Linux︰

    sudo service amazon-ssm-agent restart

    macOS:

    sudo /opt/aws/ssm/bin/amazon-ssm-agent restart
Windows
允許 SSM Agent 對 Windows Server 受管節點上的日誌記錄進行偵錯
  1. 您可以使用 Session Manager 來連線至想要允許偵錯日誌記錄的受管節點,或登入受管節點。如需詳細資訊,請參閱 使用 Session Manager

  2. 請複製 seelog.xml.template 檔案。將該複製的檔案名稱改為 seelog.xml。檔案位於以下目錄:

    %PROGRAMFILES%\Amazon\SSM\seelog.xml.template

  3. 編輯 seelog.xml 檔案以變更預設的記錄行為。將 minlevel (minlevel) 的值從 info (資訊) 變更為 debug (除錯),如以下範例所示。

    <seelog type="adaptive" mininterval="2000000" maxinterval="100000000" critmsgcount="500" minlevel="debug">

  4. 找到下列項目。

    filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\{{EXECUTABLENAME}}.log"

    變更此項目以使用以下路徑。

    filename="C:\ProgramData\Amazon\SSM\Logs\amazon-ssm-agent.log"

  5. 找到下列項目。

    filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\errors.log"

    變更此項目以使用以下路徑。

    filename="C:\ProgramData\Amazon\SSM\Logs\errors.log"

  6. 在管理員模式下SSM Agent使用以下 PowerShell 命令重新啟動。

    Restart-Service AmazonSSMAgent