Raccolta log dei container con il raccoglitore di log di Amazon ECS - Amazon Elastic Container Service

Raccolta log dei container con il raccoglitore di log di Amazon ECS

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 su GitHub sia per Linux che per Windows. Lo script raccoglie i log generici del sistema operativo, nonché i log dell'agente del container Docker e Amazon ECS che possono essere utili per la risoluzione dei problemi relativi ai casi di AWS Support. 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. Al momento, il programma di raccolta log di Amazon ECS supporta i seguenti sistemi operativi:

  • Amazon Linux

  • Red Hat Enterprise Linux 7

  • Debian 8

  • Ubuntu 14.04

  • Ubuntu 16.04

  • Ubuntu 18.04

  • Windows Server 2016

Nota

Il codice sorgente per il programma di raccolta log di Amazon ECS è disponibile su GitHub sia per Linux che per Windows. Consigliamo di inviare le richieste pull per le modifiche che desideri siano incluse. Tuttavia, Amazon Web Services al momento non supporta l'esecuzione di copie modificate di questo software.

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

  1. Connettiti alla tua istanza di container.

  2. 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

  3. 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.

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

Consigliamo di modificare i log e rimuovere tutti i dati sensibili dai file. cercare dati noti e anche variabili di ambiente quali AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY e AWS_SESSION_TOKEN nel file.

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

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 nella Guida per l'utente di Amazon EC2.

  2. Scarica lo script del programma di raccolta 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

  3. 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.

    .\ecs-logs-collector.ps1
Importante

Consigliamo di modificare i log e rimuovere tutti i dati sensibili dai file. cercare dati noti e anche variabili di ambiente quali AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY e AWS_SESSION_TOKEN nel file.

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