Visualizzazione dei registri di SSM Agent

AWS Systems Manager Agent (SSM Agent) scrive informazioni su esecuzioni, comandi, azioni pianificate, errori e stati di integrità nei file di registro su ciascun nodo gestito. Puoi visualizzare i file di log collegandoti manualmente a un nodo gestito oppure puoi inviare automaticamente i log ad Amazon CloudWatch Logs. Per ulteriori informazioni sull'invio di log a CloudWatch Logs, consulta. Monitoraggio AWS Systems Manager

È possibile visualizzare i registri di SSM Agent sui nodi gestiti nelle seguenti posizioni.

Linux and macOS

/var/log/amazon/ssm/

Windows

%PROGRAMDATA%\Amazon\SSM\Logs\

Per i nodi gestiti Linux, i file di SSM Agent stderr e stdout vengono scritti nella seguente directory: /var/lib/amazon/ssm/.

Per i nodi gestiti Windows, i file stderr e stdout di SSM Agent vengono scritti nella seguente directory: %PROGRAMDATA%\Amazon\SSM\InstanceData\.

Per informazioni su come abilitare la registrazione di debug di SSM Agent, consultare Consentire la registrazione di debug di SSM Agent.

Per maggiori informazioni sulla cihub/seelog configurazione, consulta il Wiki di Seelog su. GitHub Per esempi di cihub/seelog configurazioni, consulta l'archivio degli esempi cihub/seelog su. GitHub

Consentire la registrazione di debug di SSM Agent

La procedura seguente permette di abilitare la registrazione di debug di SSM Agent nei nodi gestiti.

Linux and macOS

Per permettere a SSM Agent il debug di registrazione su Linux e i nodi gestiti macOS.

1. UtilizzaSession Manager, una funzionalità di AWS Systems Manager, per connetterti al nodo gestito in cui desideri consentire la registrazione del debug oppure accedi al nodo gestito. Per ulteriori informazioni, consulta Utilizzo di Session Manager.

2. Individuare il file seelog.xml.template.

   Linux:

   Sulla maggior parte dei tipi di nodo gestito Linux, il file si trova nella directory /etc/amazon/ssm/seelog.xml.template.

   Su Ubuntu Server 20.10 STR & 20.04, 18.04 e 16.04 LTS, il file si trova nella directory /snap/amazon-ssm-agent/current/seelog.xml.template. Copiare questo file dalla directory /snap/amazon-ssm-agent/current/ alla directory /etc/amazon/ssm/ prima di apportare qualsiasi modifica.

   macOS:

   Sui tipi di istanza macOS, il file si trova nella directory /opt/aws/ssm/seelog.xml.template.

3. Modificare il nome del file da seelog.xml.template a seelog.xml.

   Nota

   Su Ubuntu Server 20.10 STR e 20.04, 18.04 e 16.04 LTS, il file seelog.xml deve essere creato nella /etc/amazon/ssm/. È possibile creare questa directory e il file eseguendo i seguenti comandi.

   sudo mkdir -p /etc/amazon/ssm

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

4. Modificare il file seelog.xml per cambiare il comportamento di registrazione predefinito. Cambiare il valore minlevel da info a debug, come mostrato nell'esempio seguente.

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

5. (Facoltativo) Riavviare SSM Agent utilizzando il seguente comando.

   Linux:

   sudo service amazon-ssm-agent restart

   macOS:

   sudo /opt/aws/ssm/bin/amazon-ssm-agent restart

Windows

Per permettere a SSM Agent la registrazione di debug su nodi gestiti Windows Server

1. Utilizzare Session Manager per connettersi al nodo gestito in cui abilitare la registrazione di debug oppure accedere ai nodi gestiti. Per ulteriori informazioni, consulta Utilizzo di Session Manager.

2. Creare una copia del file seelog.xml.template. Cambiare il nome della copia in seelog.xml. Il file si trova nella directory seguente:

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

3. Modificare il file seelog.xml per cambiare il comportamento di registrazione predefinito. Cambiare il valore minlevel da info a debug, come mostrato nell'esempio seguente.

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

4. Individuare la voce seguente:

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

   Modificare questa voce in modo che utilizzi il percorso seguente:

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

5. Individuare la voce seguente:

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

   Modificare questa voce in modo che utilizzi il percorso seguente:

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

6. Riavviare SSM Agent utilizzando il seguente PowerShell comando in modalità Amministratore.

   Restart-Service AmazonSSMAgent