Collecte des journaux de conteneurs avec le 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 conteneurs avec le collecteur de journaux 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). Actuellement, le collecteur de journaux Amazon ECS prend en charge les systèmes d'exploitation suivants :

  • Amazon Linux

  • Red Hat Enterprise Linux 7

  • Debian 8

  • Ubuntu 14.04

  • Ubuntu 16.04

  • Ubuntu 18.04

  • Windows Server 2016

Note

Le code source du collecteur de logs Amazon ECS est disponible GitHub pour Linux et Windows. Nous vous conseillons d'envoyer des requêtes d'extraction pour les modifications que vous souhaitez inclure. Toutefois, Amazon Web Services ne prend actuellement pas en charge l'exécution de copies modifiées de ce logiciel.

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.

    Note

    Pour activer le mode de débogage pour le démon Docker et l'agent de conteneur Amazon ECS, ajoutez l'--mode=enable-debugoption à la commande suivante. Cela peut redémarrer le démon Docker, qui tue tous les conteneurs exécutés 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 Vidange des instances de conteneurs Amazon ECS.

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

Nous vous recommandons de modifier les journaux et de supprimer toutes les données sensibles des fichiers. Vous pouvez rechercher des données connues, ainsi que des variables d'environnement telles que AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY, et AWS_SESSION_TOKEN dans le fichier.

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 Windows

  1. Connectez-vous à votre instance de conteneur. Pour plus d'informations, consultez Connect to your Windows instance using RDP dans le guide de l' EC2 utilisateur Amazon.

  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'-RunMode debugoption à 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 Vidange des instances de conteneurs Amazon ECS.

    .\ecs-logs-collector.ps1
Important

Nous vous recommandons de modifier les journaux et de supprimer toutes les données sensibles des fichiers. Vous pouvez rechercher des données connues, ainsi que des variables d'environnement telles que AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY, et AWS_SESSION_TOKEN dans le fichier.

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.