View a markdown version of this page

Envoyer les journaux Amazon ECS à un AWS service ou AWS Partner - 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.

Envoyer les journaux Amazon ECS à un AWS service ou AWS Partner

Vous pouvez utiliser FireLens pour qu'Amazon ECS utilise les paramètres de définition des tâches pour acheminer les journaux vers un AWS service ou AWS Partner Network Destination (APN) pour le stockage et l'analyse des journaux. Le AWS Partner Network est une communauté mondiale de partenaires qui s'appuie sur des programmes, une expertise et des ressources pour créer, commercialiser et vendre des offres aux clients. Pour plus d'informations, veuillez consulter AWS Partner. FireLens fonctionne avec Fluentd et Fluent Bit. Nous fournissons l'image AWS pour Fluent Bit ou vous pouvez utiliser votre propre image Fluentd ou Fluent Bit.

Par défaut, Amazon ECS configure la dépendance du conteneur pour que le conteneur Firelens démarre avant tout conteneur qui l’utilise. Le conteneur Firelens s’arrête également une fois que tous les conteneurs qui l’utilisent se sont arrêtés.

Pour utiliser cette fonctionnalité, vous devez créer un rôle IAM pour vos tâches qui fournit les autorisations nécessaires pour utiliser tout AWS les services requis par les tâches. Par exemple, si un conteneur achemine des journaux vers Firehose, la tâche nécessite l’autorisation d’appeler l’API firehose:PutRecordBatch. Pour plus d'informations, consultez Ajout et suppression d'autorisations basées sur l'identité IAM dans le Guide de l'utilisateur IAM.

Votre tâche peut également nécessiter le rôle d’exécution de tâche Amazon ECS dans les conditions suivantes. Pour plus d’informations, consultez Rôle IAM d'exécution de tâche Amazon ECS.

  • Si votre tâche est hébergée sur Fargate et que vous extrayez des images de conteneurs depuis Amazon ECR ou que vous faites référence à des données sensibles depuis AWS Secrets Manager dans la configuration de votre journal, vous devez inclure le rôle IAM d'exécution des tâches.

  • Lorsque vous utilisez un fichier de configuration personnalisé hébergé dans Amazon S3, votre rôle IAM d’exécution de tâche doit inclure l’autorisation s3:GetObject.

Tenez compte des points suivants lors de l'utilisation FireLens pour Amazon ECS :

  • Nous vous recommandons d’ajouter my_service_ au nom du conteneur de journaux afin de pouvoir facilement le distinguer dans la console.

  • Amazon ECS ajoute par défaut une dépendance relative à l’ordre des conteneurs de démarrage entre les conteneurs d’applications et le conteneur FireLens. Lorsque vous spécifiez un ordre de conteneur entre les conteneurs d’applications et le conteneur FireLens, l’ordre de conteneur de départ par défaut est remplacé.

  • FireLens pour Amazon ECS est pris en charge pour les tâches hébergées à la fois sur AWS Fargate sur Linux et Amazon EC2 sur Linux. Les conteneurs Windows ne prennent pas en charge FireLens.

    Pour plus d'informations sur la configuration de la journalisation centralisée pour les conteneurs Windows, consultez la section Journalisation centralisée pour les conteneurs Windows sur Amazon ECS à l'aide de Fluent Bit.

  • Vous pouvez utiliser CloudFormation modèles à configurer FireLens pour Amazon ECS. Pour plus d'informations, voir AWS : :ECS :TaskDefinition FirelensConfiguration dans le AWS CloudFormation Guide de l'utilisateur

  • FireLens écoute sur le port 24224, afin de garantir que le FireLens log router n'est pas accessible en dehors de la tâche, vous ne devez pas autoriser le trafic entrant sur le port 24224 dans le groupe de sécurité utilisé par votre tâche. Pour les tâches utilisant le mode réseau awsvpc, il s'agit du groupe de sécurité associé à la tâche. Pour les tâches utilisant le mode réseau host, il s'agit du groupe de sécurité associé à l'instance Amazon EC2 qui héberge la tâche. Pour les tâches utilisant le mode réseau bridge, ne créez pas de mappages de ports utilisant le port 24224.

  • Pour les tâches qui utilisent le bridge mode réseau, le conteneur avec FireLens la configuration doit démarrer avant que les conteneurs d'applications qui en dépendent ne démarrent. Pour contrôler l'ordre de début de vos conteneurs, utilisez les conditions de dépendance dans la définition de tâche. Pour plus d’informations, consultez Dépendances du conteneur.

    Note

    Si vous utilisez des paramètres de condition de dépendance dans les définitions de conteneurs avec FireLens configuration, assurez-vous que chaque conteneur possède un START ou HEALTHY condition requise.

  • Par défaut, FireLens ajoute le nom de la définition du cluster et de la tâche ainsi que l'Amazon Resource Name (ARN) du cluster en tant que clés de métadonnées à votre stdout/stderr journaux de conteneurs. Voici un exemple du format de métadonnées.

    "ecs_cluster": "cluster-name", "ecs_task_arn": "arn:aws:ecs:region:111122223333:task/cluster-name/f2ad7dba413f45ddb4EXAMPLE", "ecs_task_definition": "task-def-name:revision",

    Si vous ne souhaitez pas que les métadonnées figurent dans vos journaux, définissez enable-ecs-log-metadata sur falsedans la section firelensConfiguration de la définition de tâche.

    "firelensConfiguration":{ "type":"fluentbit", "options":{ "enable-ecs-log-metadata":"false", "config-file-type":"file", "config-file-value":"/extra.conf" }

Vous pouvez configurer le FireLens conteneur à exécuter en tant qu'utilisateur non root. Éléments à prendre en compte :

  • Pour configurer le FireLens conteneur à exécuter en tant qu'utilisateur non root, vous devez spécifier l'utilisateur dans l'un des formats suivants :

    • uid

    • uid:gid

    • uid:group

    Pour plus d'informations sur la spécification d'un utilisateur dans une définition de conteneur, consultez ContainerDefinition dans le Référence de l'API Amazon Elastic Container Service.

    Le FireLens le conteneur reçoit les journaux des applications via un UNIX douille. L'agent Amazon ECS utilise uid pour attribuer la propriété du répertoire des sockets au FireLens contenant.

  • Configuration du FireLens le conteneur à exécuter en tant qu'utilisateur non root est pris en charge sur la version Amazon ECS Agent 1.96.0 et versions ultérieures, et Amazon ECS-optimized Version AMI v20250716 et plus tard.

  • Lorsque vous spécifiez un utilisateur pour FireLens récipient, le uid doit être unique et ne pas être utilisé pour d'autres processus appartenant à d'autres conteneurs de la tâche ou de l'instance de conteneur.

Pour plus d’informations sur l’utilisation de plusieurs fichiers de configuration avec Amazon ECS, y compris les fichiers que vous hébergez ou les fichiers dans Amazon S3, consultez la section Processus d’initialisation pour Fluent Bit sur ECS, support multiconfigurations.

Pour plus d'informations sur les exemples de configurations, voir Exemple de définition de tâche Amazon ECS : acheminer les journaux vers FireLens.

Pour plus d'informations sur la configuration des journaux pour un débit élevé, voir Configuration des journaux Amazon ECS pour un débit élevé.