Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Raccolta log dei container con il raccoglitore di log di Amazon ECS
<a name="ecs-logs-collector"></a>

**Nota**  
Non puoi usare il raccoglitore di log di Amazon ECS sulle istanze gestite da Amazon ECS.

Se hai dubbi su come raccogliere tutti i vari log nelle tue istanze di container, puoi utilizzare il programma di raccolta log di Amazon ECS. È disponibile sia GitHub per [Linux](https://github.com/awslabs/ecs-logs-collector) che per [Windows](https://github.com/awslabs/aws-ecs-logs-collector-for-windows). Lo script raccoglie i log generali del sistema operativo, nonché i log degli agenti container Docker e Amazon ECS, che possono essere utili per la risoluzione dei casi. Supporto AWS Quindi comprime e archivia le informazioni raccolte in un singolo file che può essere facilmente condiviso per scopi di diagnostica. Supporta inoltre l'abilitazione della modalità di debug per il daemon Docker e l'agente del container di Amazon ECS nelle varianti di Amazon Linux, ad esempio l'AMI ottimizzata per Amazon ECS.

**Nota**  
Su Amazon Linux ottimizzato per Amazon ECS AMIs versione 20250909 e successive, il raccoglitore di log di Amazon ECS è preinstallato e pronto all'uso senza dover essere scaricato da. `/opt/amazon/ecs/ecs-logs-collector.sh` GitHub Per ulteriori informazioni, consulta [ECS Logs Collector](https://github.com/aws/amazon-ecs-ami?tab=readme-ov-file#ecs-logs-collector) nella documentazione dell'AMI ottimizzata per ECS.

Al momento, il programma di raccolta log di Amazon ECS supporta i seguenti sistemi operativi:
+ Amazon Linux
+ Red Hat Enterprise Linux
+ Ubuntu
+ Windows Server

**Per eseguire Amazon ECS logs collector per Linux (AMI ottimizzata per ECS)**

1. Connettiti alla tua istanza di container. 

1. Esegui lo script per raccogliere i log e creare l'archivio.
**Nota**  
Per abilitare la modalità di debug per il daemon Docker e l'agente del container di Amazon ECS, aggiungi l'opzione `--mode=enable-debug` al seguente comando. Questo potrebbe portare al riavvio del daemon Docker, con conseguente interruzione di tutti i container in esecuzione nell'istanza. Prendi in considerazione di svuotare l'istanza di container e di spostare eventuali attività importanti su altre istanze di container prima di abilitare la modalità di debug. Per ulteriori informazioni, consulta [Drenare le istanze di container di Amazon ECS](container-instance-draining.md).

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

Dopo aver eseguito lo script, puoi esaminare i log raccolti nella cartella `collect` creata dallo script. Il `collect.tgz` file è un archivio compresso di tutti i log, che puoi condividere per ricevere assistenza diagnostica. Supporto AWS 

**Come scaricare ed eseguire il programma di raccolta log di Amazon ECS per Linux**

1. Connettiti alla tua istanza di container. 

1. Scarica lo script del programma di raccolta di log di Amazon ECS.

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

1. Esegui lo script per raccogliere i log e creare l'archivio.

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

**Per scaricare ed eseguire il programma di raccolta log di Amazon ECS per Windows**

1. Connettiti alla tua istanza di container. Per ulteriori informazioni, consulta [Connessione a un'istanza Windows tramite RDP](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connecting_to_windows_instance.html) nella *Guida per l'utente di Amazon EC2*.

1. Scarica lo script di raccolta dei log di Amazon ECS utilizzando. 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. Esegui lo script per raccogliere i log e creare l'archivio.
**Nota**  
Per abilitare la modalità di debug per il daemon Docker e l'agente del container di Amazon ECS, aggiungi l'opzione `-RunMode debug` al seguente comando. Questo comporta il riavvio del daemon Docker, con conseguente interruzione di tutti i container in esecuzione nell'istanza. Prendi in considerazione di svuotare l'istanza di container e di spostare eventuali attività importanti su altre istanze di container prima di abilitare la modalità di debug. Per ulteriori informazioni, consulta [Drenare le istanze di container di Amazon ECS](container-instance-draining.md).

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

Dopo aver eseguito lo script, puoi esaminare i log raccolti nella cartella `collect` creata dallo script. Il `collect.tgz` file è un archivio compresso di tutti i registri, che puoi condividere con Support per ricevere AWS assistenza diagnostica.