Recopilación de registros de contenedor con el recopilador de registros de Amazon ECS - Amazon Elastic Container Service

Recopilación de registros de contenedor con el recopilador de registros de Amazon ECS

Si no está seguro de cómo recopilar todos los diversos registros en las instancias de contenedor, puede utilizar el recopilador de registros de Amazon ECS. Está disponible en GitHub tanto para Linux como para Windows. El script recopila registros generales del sistema operativo, así como registros del agente de contenedor de Amazon ECS y de Docker, que pueden resultar útiles para solucionar problemas en los casos de AWS Support. A continuación, comprime y archiva la información recopilada en un solo archivo que se puede compartir fácilmente con fines de diagnóstico. También permite habilitar el modo de depuración para el daemon de Docker y el agente de contenedor de Amazon ECS en variantes de Amazon Linux como, por ejemplo, la AMI optimizada para Amazon ECS. Actualmente, el recopilador de registros de Amazon ECS admite los siguientes sistemas operativos:

  • Amazon Linux

  • Red Hat Enterprise Linux 7

  • Debian 8

  • Ubuntu 14.04

  • Ubuntu 16.04

  • Ubuntu 18.04

  • Windows Server 2016

nota

El código fuente del recopilador de registros de Amazon ECS está disponible en GitHub tanto para Linux como para Windows. Le recomendamos enviar solicitudes de inserción para los cambios que le gustaría que incluyamos. No obstante, Amazon Web Services actualmente no permite ejecutar copias modificadas de este software.

Para descargar y ejecutar el recopilador de registros de Amazon ECS para Linux

  1. Conéctese a la instancia de contenedor.

  2. Descargue el script del recopilador de registros de Amazon ECS.

    curl -O https://raw.githubusercontent.com/awslabs/ecs-logs-collector/master/ecs-logs-collector.sh

  3. Ejecute el script para recopilar los registros y crear el archivo.

    nota

    Para habilitar el modo de depuración para el daemon de Docker y el agente de contenedor de Amazon ECS, agregue la opción --mode=enable-debug al siguiente comando. Esto puede reiniciar el daemon de Docker, que cierra todos los contenedores que están en ejecución en la instancia. Sopese la posibilidad de drenar la instancia de contenedor y transferir las tareas importantes a otras instancias de contenedor antes de activar el modo de depuración. Para obtener más información, consulte Drenaje de instancias de contenedor de Amazon ECS.

    [ec2-user ~]$ sudo bash ./ecs-logs-collector.sh
importante

Recomendamos que edite los registros y elimine toda la información confidencial de los archivos. Puede buscar datos conocidos y también variables de entorno, como AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY y AWS_SESSION_TOKEN, en el archivo.

Después de haber ejecutado el script, puede examinar los registros recopilados en la carpeta collect creada por el script. El archivo collect.tgz es un archivo comprimido que contiene todos los registros, y lo puede compartir con AWS Support para facilitar el diagnóstico.

Para descargar y ejecutar el recopilador de registros de Amazon ECS para Windows

  1. Conéctese a la instancia de contenedor. Para obtener más información, consulte Connecting to Your Windows Instance en la Guía del usuario de Amazon EC2.

  2. Descargue el script del recopilador de registros de Amazon ECS a través de PowerShell.

    Invoke-WebRequest -OutFile ecs-logs-collector.ps1 https://raw.githubusercontent.com/awslabs/aws-ecs-logs-collector-for-windows/master/ecs-logs-collector.ps1

  3. Ejecute el script para recopilar los registros y crear el archivo.

    nota

    Para habilitar el modo de depuración para el daemon de Docker y el agente de contenedor de Amazon ECS, agregue la opción -RunMode debug al siguiente comando. Esto reinicia el daemon de Docker, que cierra todos los contenedores que están en ejecución en la instancia. Sopese la posibilidad de drenar la instancia de contenedor y transferir las tareas importantes a otras instancias de contenedor antes de activar el modo de depuración. Para obtener más información, consulte Drenaje de instancias de contenedor de Amazon ECS.

    .\ecs-logs-collector.ps1
importante

Recomendamos que edite los registros y elimine toda la información confidencial de los archivos. Puede buscar datos conocidos y también variables de entorno, como AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY y AWS_SESSION_TOKEN, en el archivo.

Después de haber ejecutado el script, puede examinar los registros recopilados en la carpeta collect creada por el script. El archivo collect.tgz es un archivo comprimido con todos los registros, que puede compartir con AWS Support para facilitar el diagnóstico.