將 SSM Agent 日誌傳送至 CloudWatch Logs - AWS Systems Manager

AWS Systems ManagerChange Manager 不再開放給新客戶。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱AWS Systems ManagerChange Manager可用性變更。

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

將 SSM Agent 日誌傳送至 CloudWatch Logs

AWS Systems Manager 代理程式 (SSM Agent) 是在為 Systems Manager 設定的 EC2 執行個體、邊緣裝置、內部部署伺服器和虛擬機器 (VMs) 上執行的 Amazon 軟體。 SSM Agent會在雲端處理 Systems Manager 服務的請求，並依照請求中的指定設定您的機器。如需 SSM Agent 的詳細資訊，請參閱 使用 SSM Agent。

此外，您可以使用下列步驟，設定 SSM Agent 以傳送日誌資料至 Amazon CloudWatch Logs。

開始之前

在 CloudWatch Logs 中建立日誌群組。如需詳細資訊，請參閱《Amazon CloudWatch Logs 使用者指南》中的 CloudWatch Logs 入門。

若要設定 SSM Agent 以將日誌傳送至 CloudWatch

  1. 登入節點並找出下列檔案：

    Linux

    在大多數 Linux 節點類型上：/etc/amazon/ssm/seelog.xml.template。

    在 Ubuntu Server 20.04、18.04 和 16.04 LTS 上︰/snap/amazon-ssm-agent/current/seelog.xml.template

    macOS

    /opt/aws/ssm/seelog.xml.template

    Windows

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

  2. 將檔案名稱從 seelog.xml.template 變更為 seelog.xml

    注意

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

    sudo mkdir -p /etc/amazon/ssm
    sudo cp -pr /snap/amazon-ssm-agent/current/* /etc/amazon/ssm
    sudo cp -p /etc/amazon/ssm/seelog.xml.template /etc/amazon/ssm/seelog.xml

  3. 使用文字編輯器開啟 seelog.xml 檔案，並找出下列區段。

    Linux and macOS
    <outputs formatid="fmtinfo">
   <console formatid="fmtinfo"/>
   <rollingfile type="size" filename="/var/log/amazon/ssm/amazon-ssm-agent.log" maxsize="30000000" maxrolls="5"/>
   <filter levels="error,critical" formatid="fmterror">
      <rollingfile type="size" filename="/var/log/amazon/ssm/errors.log" maxsize="10000000" maxrolls="5"/>
   </filter>
</outputs>
    Windows
    <outputs formatid="fmtinfo">
   <console formatid="fmtinfo"/>
   <rollingfile type="size" maxrolls="5" maxsize="30000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\amazon-ssm-agent.log"/>
   <filter formatid="fmterror" levels="error,critical">
      <rollingfile type="size" maxrolls="5" maxsize="10000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\errors.log"/>
   </filter>
</outputs>

  4. 編輯檔案，在 </filter> 結束標籤後面新增自訂名稱元素。在以下範例中，自訂名稱已指定為 cloudwatch_receiver。

    Linux and macOS
    <outputs formatid="fmtinfo">
   <console formatid="fmtinfo"/>
   <rollingfile type="size" filename="/var/log/amazon/ssm/amazon-ssm-agent.log" maxsize="30000000" maxrolls="5"/>
   <filter levels="error,critical" formatid="fmterror">
      <rollingfile type="size" filename="/var/log/amazon/ssm/errors.log" maxsize="10000000" maxrolls="5"/>
   </filter>
   <custom name="cloudwatch_receiver" formatid="fmtdebug" data-log-group="your-CloudWatch-log-group-name"/>
</outputs>
    Windows
    <outputs formatid="fmtinfo">
   <console formatid="fmtinfo"/>
   <rollingfile type="size" maxrolls="5" maxsize="30000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\amazon-ssm-agent.log"/>
   <filter formatid="fmterror" levels="error,critical">
      <rollingfile type="size" maxrolls="5" maxsize="10000000" filename="{{LOCALAPPDATA}}\Amazon\SSM\Logs\errors.log"/>
   </filter>
   <custom name="cloudwatch_receiver" formatid="fmtdebug" data-log-group="your-CloudWatch-log-group-name"/>
</outputs>

  5. 儲存變更，然後重新啟動 SSM Agent 或節點。

  6. 透過 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

  7. 在導覽窗格中，選擇 Log groups (日誌群組)，然後選擇日誌群組的名稱。

    提示

    SSM Agent日誌檔資料的日誌串流依節點 ID 組織。