Collecte des journaux de conteneur avec collecteur de journaux Amazon ECS - Amazon Elastic Container Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Collecte des journaux de conteneur avec collecteur de journaux Amazon ECS

Note

Vous ne pouvez pas utiliser le collecteur de journaux Amazon ECS sur les instances gérées Amazon ECS.

Si vous n'êtes pas sûr de savoir comment de collecter les différents journaux de vos instances de conteneur, vous pouvez utiliser le collecteur de journaux d'Amazon ECS. Il est disponible GitHub pour Linux et Windows. Le script collecte les journaux généraux du système d'exploitation ainsi que les journaux des agents de conteneur Docker et Amazon ECS, ce qui peut être utile pour les AWS Support cas de dépannage. Puis, il compresse et archive les informations collectées dans un seul fichier qui peut être facilement partagé à des fins de diagnostic. Il prend également en charge l'activation du mode de débogage pour le démon Docker et l'agent de conteneur Amazon ECS sur les variantes d'Amazon Linux (AMI optimisée pour Amazon ECS, par exemple).

Note

Sur Amazon Linux, AMIs version optimisée pour Amazon ECS 20250909 et versions ultérieures, le collecteur de journaux Amazon ECS est préinstallé /opt/amazon/ecs/ecs-logs-collector.sh et prêt à être utilisé sans téléchargement depuis. GitHub Pour plus d'informations, consultez ECS Logs Collector dans la documentation de l'AMI optimisée pour ECS.

Actuellement, le collecteur de journaux Amazon ECS prend en charge les systèmes d'exploitation suivants :

  • Amazon Linux

  • Utilisation de Red Hat Enterprise Linux

  • Ubuntu

  • Windows Server

Pour exécuter le collecteur de logs Amazon ECS pour Linux (AMI optimisée pour ECS)

  1. Connectez-vous à votre instance de conteneur.

  2. Exécutez le script pour collecter les journaux et créer l'archive.

    Note

    Pour activer le mode de débogage pour le démon Docker et l’agent de conteneur Amazon ECS, ajoutez l’option --mode=enable-debug à la commande suivante. Cela pourrait redémarrer le démon Docker, ce qui entraînerait la suppression de tous les conteneurs en cours d’exécution sur l’instance. Pensez à drainer l'instance de conteneur et à transférer les tâches importantes vers d'autres instances de conteneur avant d'activer le mode de débogage. Pour de plus amples informations, veuillez consulter Drainage des instances de conteneur Amazon ECS.

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

Une fois que vous avez exécuté le script, vous pouvez examiner les journaux collectés dans le dossier collect créé par le script. Le collect.tgz fichier est une archive compressée de tous les journaux, que vous pouvez partager AWS Support pour obtenir de l'aide au diagnostic.

Pour télécharger et exécuter le collecteur de journaux Amazon ECS pour Linux

  1. Connectez-vous à votre instance de conteneur.

  2. Téléchargez le script de collecteur de journaux Amazon ECS.

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

  3. Exécutez le script pour collecter les journaux et créer l'archive.

    $ sudo bash ./ecs-logs-collector.sh
Pour télécharger et exécuter le collecteur de journaux Amazon ECS pour Windows

  1. Connectez-vous à votre instance de conteneur. Pour plus d’informations, consultez la section Connexion à votre instance Windows à l’aide de RDP dans le Guide de l’utilisateur Amazon EC2.

  2. Téléchargez le script du collecteur de journaux Amazon ECS à l'aide 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. Exécutez le script pour collecter les journaux et créer l'archive.

    Note

    Pour activer le mode de débogage pour le démon Docker et l’agent de conteneur Amazon ECS, ajoutez l’option -RunMode debug à la commande suivante. Cette action redémarre le démon Docker, ce qui supprime tous les conteneurs qui s'exécutent sur l'instance. Pensez à drainer l'instance de conteneur et à transférer les tâches importantes vers d'autres instances de conteneur avant d'activer le mode de débogage. Pour de plus amples informations, veuillez consulter Drainage des instances de conteneur Amazon ECS.

    .\ecs-logs-collector.ps1

Une fois que vous avez exécuté le script, vous pouvez examiner les journaux collectés dans le dossier collect créé par le script. Le collect.tgz fichier est une archive compressée de tous les journaux, que vous pouvez partager avec le AWS Support pour obtenir de l'aide au diagnostic.