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). 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’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 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_ID, AWS_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’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
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_ID, AWS_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.