Collecte des journaux de conteneurs avec Amazon ECS Logs Collector - 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 Amazon ECS Logs Collector

Si vous ne savez pas comment collecter les différents journaux sur vos instances de conteneur, vous pouvez utiliser le collecteur de ECS journaux Amazon. 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 ECS conteneurs Docker et Amazon, ce qui peut être utile en 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 permet également d'activer le mode de débogage pour le démon Docker et l'agent de ECS conteneur Amazon sur les variantes Amazon Linux, telles que Amazon -optimized. ECS AMI Actuellement, le collecteur de ECS logs Amazon 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 ECS logs Amazon 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 ECS logs Amazon pour Linux

  1. Connectez-vous à votre instance de conteneur.

  2. Téléchargez le script Amazon ECS Logs Collector.

    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 ECS conteneur Amazon, 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 ECS conteneurs Amazon.

    [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 ECS logs Amazon pour Windows

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

  2. Téléchargez le script Amazon ECS Logs Collector à 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 ECS conteneur Amazon, 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 ECS conteneurs Amazon.

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