# Recopilación de registros de contenedor con el recopilador de registros de Amazon ECS
<a name="ecs-logs-collector"></a>

**nota**  
No puede utilizar el recopilador de registros de Amazon ECS en instancias administradas 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](https://github.com/awslabs/ecs-logs-collector) como para [Windows](https://github.com/awslabs/aws-ecs-logs-collector-for-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.

**nota**  
En las AMI optimizadas para Amazon ECS de Amazon Linux, versión 20250909 y posteriores, el recopilador de registros de Amazon ECS viene preinstalado en `/opt/amazon/ecs/ecs-logs-collector.sh` y está listo para usarse sin necesidad de descargarlo desde GitHub. Para obtener más información, consulte [Recopilador de registros de ECS](https://github.com/aws/amazon-ecs-ami?tab=readme-ov-file#ecs-logs-collector) en la documentación de AMI optimizada para ECS.

Actualmente, el recopilador de registros de Amazon ECS admite los siguientes sistemas operativos:
+ Amazon Linux
+ Red Hat Enterprise Linux
+ Ubuntu
+ Windows Server

**Para ejecutar el recopilador de registros de Amazon ECS para Linux (AMI optimizada para ECS)**

1. Conéctese a la instancia de contenedor. 

1. Use 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 vaciar 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](container-instance-draining.md).

   ```
   [ec2-user ~]$ sudo /opt/amazon/ecs/ecs-logs-collector.sh
   ```

Después de haber puesto en marcha 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 Linux**

1. Conéctese a la instancia de contenedor. 

1. 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
   ```

1. Use el script para recopilar los registros y crear el archivo.

   ```
   $ sudo bash ./ecs-logs-collector.sh
   ```

**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 [Conectarse a una instancia de Windows mediante RDP](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connecting_to_windows_instance.html) en la *Guía del usuario de Amazon EC2*.

1. 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
   ```

1. Use 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 vaciar 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](container-instance-draining.md).

   ```
   .\ecs-logs-collector.ps1
   ```

Después de haber puesto en marcha 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.