Visualizzazione dei registri di SSM Agent - AWS Systems Manager
Consentire la registrazione di debug di SSM Agent

AWS Systems ManagerChange Managernon è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta AWS Systems ManagerChange Managerla pagina Modifica della disponibilità.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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. Registrazione e 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 ulteriori informazioni sulla configurazione cihub/seelog, consulta Seelog Wiki su GitHub. Per esempi di configurazioni cihub/seelog, consulta l'archivio cihub/seelog examples 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. Utilizza Session Manager uno strumento per connetterti al nodo gestito in AWS Systems Manager 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.

    Nelle Ubuntu Server versioni 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.04, 18.04 e 16.04 LTS, il file seelog.xml deve essere creato nella directory /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\{{EXECUTABLENAME}}.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