Visualización de registros de SSM Agent - AWS Systems Manager
Permiso del registro de depuración de SSM Agent

Visualización de registros de SSM Agent

AWS Systems Manager Agent (SSM Agent) escribe información acerca de ejecuciones, comandos, acciones programadas, errores y estados en los archivos de registros en cada nodo administrado. Puede ver los archivos de registros si se conecta a un nodo administrado de forma manual o puede enviar los registros a Amazon CloudWatch Logs de forma automática. Para obtener más información sobre el envío de registros a Registros de CloudWatch, consulte Supervisión de AWS Systems Manager.

Puede ver los registros de SSM Agent de los nodos administrados en las siguientes ubicaciones.

Linux and macOS

/var/log/amazon/ssm/

Windows

%PROGRAMDATA%\Amazon\SSM\Logs\

Para los nodos administrados de Linux, los archivos de SSM Agent stderr y stdout se escriben en el siguiente directorio: /var/lib/amazon/ssm/.

Para los nodos administrados de Windows, los archivos de SSM Agent stderr y stdout se escriben en el siguiente directorio: %PROGRAMDATA%\Amazon\SSM\InstanceData\.

Para obtener más información acerca de cómo permitir el registro de depuración de SSM Agent, consulte Permiso del registro de depuración de SSM Agent.

Para obtener más información acerca de la configuración de cihub/seelog, consulte la Seelog Wiki en GitHub. Para ver ejemplos de configuraciones de cihub/seelog, consulte el repositorio cihub/seelog examples en GitHub.

Permiso del registro de depuración de SSM Agent

Utilice el siguiente procedimiento para permitir el registro de depuración de SSM Agent en los nodos administrados.

Linux and macOS
Para permitir el registro de depuración de SSM Agent en nodos administrados de Linux y macOS

  1. Utilice Session Manager, una capacidad de AWS Systems Manager, para conectarse al nodo administrado en el que desea permitir el registro de depuración o inicie sesión en el nodo administrado. Para obtener más información, consulte Uso de Session Manager.

  2. Localice el archivo seelog.xml.template.

    Linux:

    En la mayoría de los tipos de nodos administrados de Linux, el archivo se ubica en el directorio /etc/amazon/ssm/seelog.xml.template.

    En Ubuntu Server 20.10 STR y 20.04, 18.04 y 16.04 LTS, el archivo se ubica en el directorio /snap/amazon-ssm-agent/current/seelog.xml.template. Copie este archivo del directorio /snap/amazon-ssm-agent/current/ en el directorio /etc/amazon/ssm/ antes de realizar cualquier cambio.

    macOS:

    En los tipos de instancias de macOS, el archivo se ubica en el directorio /opt/aws/ssm/seelog.xml.template.

  3. Cambie el nombre del archivo de seelog.xml.template a seelog.xml.

    nota

    En Ubuntu Server 20.10 STR y 20.04, 18.04 y 16.04 LTS, el archivo seelog.xml se debe crear en el directorio /etc/amazon/ssm/. Ejecute los siguientes comandos para crear este directorio y archivo. 

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

  4. Edite el archivo seelog.xml para cambiar el comportamiento de registro predeterminado. Cambie el valor de minlevel de info (información) a debug (depurar), tal y como se muestra en el siguiente ejemplo.

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

  5. (Opcional) Reinicie SSM Agent con el siguiente comando.

    Linux:

    sudo service amazon-ssm-agent restart

    macOS:

    sudo /opt/aws/ssm/bin/amazon-ssm-agent restart
Windows
Para permitir el registro de depuración de SSM Agent en nodos administrados de Windows Server

  1. Utilice Session Manager para conectarse al nodo administrado en el que desea permitir el registro de depuración o inicie sesión en el nodo administrado. Para obtener más información, consulte Uso de Session Manager.

  2. Realice una copia del archivo seelog.xml.template. Cambie el nombre de la copia por seelog.xml. El archivo se encuentra en el siguiente directorio:

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

  3. Edite el archivo seelog.xml para cambiar el comportamiento de registro predeterminado. Cambie el valor de minlevel de info (información) a debug (depurar), tal y como se muestra en el siguiente ejemplo.

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

  4. Localice la siguiente entrada.

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

    Cambie esta entrada para utilizar la siguiente ruta.

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

  5. Localice la siguiente entrada.

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

    Cambie esta entrada para utilizar la siguiente ruta.

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

  6. Reinicie SSM Agent con el siguiente comando de PowerShell en el modo de administrador.

    Restart-Service AmazonSSMAgent