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 n'êtes pas sûr de savoir comment collecter les différents journaux de vos instances de conteneur, vous pouvez utiliser le collecteur de ECS journaux d'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 de Docker et de l'agent de ECS conteneur Amazon, ce qui peut être utile pour résoudre les AWS Support cas de support. 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 ECS conteneur Amazon sur les variantes d'Amazon Linux, telles que la version optimisée pour Amazon. ECS AMI Actuellement, le collecteur de ECS journaux 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 journaux Amazon pour Linux

  1. Connectez-vous à votre instance de conteneur.

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

    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 avec afin d'obtenir de l'aide AWS Support pour un diagnostic.

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

  1. Connectez-vous à votre instance de conteneur. Pour plus d'informations, consultez Connect to your Windows instance RDP in the Amazon EC2 User Guide.

  2. Téléchargez le script de collecteur de ECS journaux Amazon à 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 pour un diagnostic.