Visualisation SSM Agent journaux - AWS Systems Manager
Permettant SSM Agent journalisation du débogage

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Visualisation SSM Agent journaux

AWS Systems Manager Agent (SSM Agent) écrit des informations sur les exécutions, les commandes, les actions planifiées, les erreurs et l'état de santé dans les fichiers journaux de chaque nœud géré. Vous pouvez consulter les fichiers journaux en vous connectant manuellement à un nœud géré, ou vous pouvez envoyer automatiquement les journaux à Amazon CloudWatch Logs. Pour plus d'informations sur l'envoi de CloudWatch journaux à Logs, consultezConnexion et surveillance AWS Systems Manager.

Vous pouvez voir SSM Agent se connecte aux nœuds gérés aux emplacements suivants.

Linux and macOS

/var/log/amazon/ssm/

Windows

%PROGRAMDATA%\Amazon\SSM\Logs\

Pour les nœuds gérés par Linux, le SSM Agent stderret stdout les fichiers sont écrits dans le répertoire suivant :/var/lib/amazon/ssm/.

Pour les nœuds gérés par Windows, le SSM Agent stderret stdout les fichiers sont écrits dans le répertoire suivant :%PROGRAMDATA%\Amazon\SSM\InstanceData\.

Pour plus d'informations sur l'autorisation SSM Agent journalisation du débogage, voirPermettant SSM Agent journalisation du débogage.

Pour plus d'informations sur cihub/seelog la configuration, consultez le wiki Seelog sur GitHub. Pour des exemples de cihub/seelog configurations, consultez le référentiel d'exemples cihub/seelog sur GitHub.

Permettant SSM Agent journalisation du débogage

Utilisez la procédure suivante pour autoriser SSM Agent journalisation du débogage sur vos nœuds gérés.

Linux and macOS
Pour autoriser SSM Agent journalisation du débogage sous Linux et macOS nœuds gérés

  1. Utilisez soit Session Manager, un outil dans AWS Systems Manager, pour vous connecter au nœud géré sur lequel vous souhaitez autoriser la journalisation du débogage, ou pour vous connecter au nœud géré. Pour de plus amples informations, veuillez consulter Utilisation de l’option Session Manager.

  2. Localisez le fichier seelog.xml.template

    Linux :

    Sur la plupart des types de nœud géré Linux, le fichier se trouve dans le répertoire /etc/amazon/ssm/seelog.xml.template.

    Activé Ubuntu Server 20.10 STR & 20.04, 18.04 et 16.04 LTS, le fichier se trouve dans le répertoire. /snap/amazon-ssm-agent/current/seelog.xml.template Copiez ce fichier du répertoire /snap/amazon-ssm-agent/current/ vers le répertoire /etc/amazon/ssm/ avant d'apporter des modifications.

    macOS:

    Activé macOS types d'instance, le fichier se trouve dans le répertoire/opt/aws/ssm/seelog.xml.template.

  3. Remplacez le nom du fichier seelog.xml.template par seelog.xml.

    Note

    Activé Ubuntu Server 20.10 STR & 20.04, 18.04 et 16.04 LTS, le fichier seelog.xml doit être créé dans le répertoire. /etc/amazon/ssm/ Vous pouvez créer ce répertoire et ce fichier en exécutant les commandes suivantes. 

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

  4. Modifiez le fichier seelog.xml pour modifier le comportement de journalisation par défaut. Modifiez la valeur de minlevel de info pour déboguer, comme illustré dans l'exemple suivant.

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

  5. (Facultatif) Redémarrer SSM Agent à l'aide de la commande suivante.

    Linux :

    sudo service amazon-ssm-agent restart

    macOS:

    sudo /opt/aws/ssm/bin/amazon-ssm-agent restart
Windows
Pour autoriser SSM Agent connexion au débogage Windows Server nœuds gérés

  1. Utilisez soit Session Manager pour vous connecter au nœud géré sur lequel vous souhaitez autoriser la journalisation du débogage, ou pour vous connecter aux nœuds gérés. Pour de plus amples informations, veuillez consulter Utilisation de l’option Session Manager.

  2. Effectuez une copie du fichier seelog.xml.template. Remplacez le nom de la copie par seelog.xml. Ce fichier se trouve dans le répertoire suivant.

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

  3. Modifiez le fichier seelog.xml pour modifier le comportement de journalisation par défaut. Modifiez la valeur de minlevel de info pour déboguer, comme illustré dans l'exemple suivant.

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

  4. Recherchez l'entrée suivante.

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

    Modifiez cette entrée pour utiliser le chemin d'accès suivant.

    filename="C:\ProgramData\Amazon\SSM\Logs\{{EXECUTABLENAME}}.log"

  5. Recherchez l'entrée suivante.

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

    Modifiez cette entrée pour utiliser le chemin d'accès suivant.

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

  6. Redémarrer SSM Agent en utilisant la PowerShell commande suivante en mode administrateur.

    Restart-Service AmazonSSMAgent