¿Cómo utilizo el script de recopilación de registros de ECS para recopilar registros de mi instancia de contenedor de Amazon ECS?

Descripción corta

Utilice el script de recopilación de registros de Amazon ECS para recopilar registros generales del sistema operativo (OS), Docker y agentes de contenedores para Amazon ECS. El script comprime y archiva los registros en un único archivo que puede compartir para solucionar un problema.

También puede usar el runbook de AWS Systems Manager AWSSupport-CollectECSInstanceLogs para recopilar registros de su instancia de ECS y cargarlos en un bucket de Amazon Simple Storage Service (Amazon S3). En el parámetro de entrada LogDestination, indique la ubicación del bucket de Amazon S3.

Nota: AWSSupport-CollectECSInstanceLogs no admite el modo de depuración. Para más información, consulte Ejecución de una operación automatizada con tecnología de Automatización de Systems Manager.

Resolución

Descarga y ejecución del recopilador de registros de Amazon ECS

Para obtener instrucciones sobre cómo puede conectarse a su instancia de contenedor, consulte Conexión a la instancia de contenedor mediante SSH. Para obtener instrucciones sobre cómo descargar y ejecutar el recopilador de registros para Linux y Windows, consulte Recopilación de registros de contenedores con el recopilador de registros de Amazon ECS.

Para Linux, debe usar curl. Para confirmar que tiene instalado curl, ejecute el siguiente comando:

curl --version

El resultado del comando es similar al siguiente:

curl 7.47.0 (x86_64-pc-linux-gnu) libcurl/7.47.0 GnuTLS/3.4.10 zlib/1.2.8 libidn/1.32 librtmp/2.3

**Nota:**Si el comando no devuelve los resultados esperados, instale el paquete curl.

Tras ejecutar el script, puede revisar los registros recopilados en la carpeta de recopilación que creó el script. En Linux, el archivo comprimido de todos los registros es collect-i-ffffffffffffffffff-YYYYMMDDHHmm.tgz. En Windows, es el archivo collect.tgz.

Ejecución del recopilador de registros de Amazon ECS en modo de depuración

El modo de depuración le permite solucionar problemas complejos en su entorno de ECS que es posible que los detalles de registro estándar no puedan solucionar.

Para activar el registro de depuración del daemon de Docker y el agente de contenedores de Amazon ECS, utilice**--mode=enable-debug** para Linux y -RunMode debug para Windows.

Nota: El script reinicia el daemon de Docker y el agente Amazon ECS y finaliza la ejecución de todos los contenedores de la instancia. Antes de ejecutar el siguiente comando, vacíe la instancia de contenedor y traslade las tareas importantes a otras instancias de contenedor.

Linux

El modo de depuración solo funciona en sistemas basados en el sistema operativo Amazon Linux y Systemd.

Cuando ejecute el script, ejecute el siguiente comando:

[ec2-user ~]$ sudo bash ./ecs-logs-collector.sh --mode=enable-debug

Windows

Al ejecutar el script, utilice Windows PowerShell con permisos de administrador para ejecutar el siguiente comando:

.\ecs-logs-collector.ps1 -RunMode debug