:Collecte de la sortie standard des conteneurs Docker (ancienne version)

Présentation

Après avoir installé Docker sur un hôte, utilisez Logtail pour collecter les journaux de sortie standard (stdout) et d'erreur standard (stderr) provenant des conteneurs d'applications déployés dans l'environnement Docker. Les données de journal collectées sont envoyées vers un logstore pour faciliter leur interrogation et leur analyse.

Prérequis

• Un projet et un logstore ont été créés. Pour plus d'informations, consultez les rubriques Gérer les projets et Gérer les Logstores.

• L'hôte doit avoir installé et utiliser Docker et Docker Compose et pouvoir générer continuellement des journaux de sortie standard.

  Remarque

  Logtail collecte uniquement les journaux incrémentiels. Si un fichier journal n'est pas mis à jour après l'application d'une configuration Logtail, Logtail ne collecte pas les journaux de ce fichier. Pour plus d'informations, consultez la rubrique Lire les journaux.

Étape 1 : Installer un conteneur Logtail et créer un groupe de machines

1. Téléchargez l'image Logtail.

   Connectez-vous à l'hôte. Selon la région de votre projet Simple Log Service, obtenez l'identifiant ${region_id} correspondant. Remplacez ensuite l'espace réservé ${region_id} dans la commande suivante et exécutez-la pour télécharger l'image Logtail.

   Important

   • Pour connaître l'identifiant ${region_id} de chaque région, consultez la rubrique Régions et zones. Par exemple, l'identifiant ${region_id} pour la région Chine (Hangzhou) est cn-hangzhou.

   #Pull the Logtail image:
   docker pull registry.${region_id}.aliyuncs.com/log-service/logtail:v2.1.11.0-aliyun
   #If your server is in an Alibaba Cloud VPC, run the following command to pull the Logtail image:
   docker pull registry-vpc.${region_id}.aliyuncs.com/log-service/logtail:v2.1.11.0-aliyun

2. Démarrez le conteneur Logtail.

   1. Descriptions des paramètres

      Paramètre	Description
      ${region_id}	Obtenez l'identifiant ${region_id} correspondant à la région de votre projet Simple Log Service. Pour connaître l'identifiant ${region_id} de chaque région, consultez la rubrique Régions disponibles. Pour sélectionner un type de réseau, consultez la rubrique Types de réseaux Logtail, paramètres de démarrage et configuration. Par exemple, si un projet se trouve dans la région Chine (Hangzhou), l'identifiant ${region_id} est cn-hangzhou pour l'accès via le réseau interne Alibaba Cloud et cn-hangzhou-internet pour l'accès via le réseau public.
      ${aliyun_account_id}	ID du compte Alibaba Cloud auquel appartient Simple Log Service. Pour savoir comment obtenir cet ID, consultez la rubrique Obtenir l'ID d'un compte Alibaba Cloud.
      ${user_defined_id}	Spécifie l'identifiant personnalisé du groupe de machines, par exemple user-defined-docker-1. L'identifiant doit être unique dans la région où se trouve le projet.

   2. En vous basant sur les descriptions des paramètres, remplacez les espaces réservés ${region_id}, ${aliyun_account_id} et ${user_defined_id} dans le modèle de commande. Exécutez ensuite la commande pour démarrer le conteneur Logtail.

      # Start the Logtail container. Replace ${region_id}, ${aliyun_account_id}, and ${user_defined_id}.
      docker run -d \
          -v /:/logtail_host:ro \
          -v /var/run/docker.sock:/var/run/docker.sock \
          --env ALIYUN_LOGTAIL_CONFIG=/etc/ilogtail/conf/${region_id}/ilogtail_config.json \
          --env ALIYUN_LOGTAIL_USER_ID=${aliyun_account_id} \
          --env ALIYUN_LOGTAIL_USER_DEFINED_ID=${user_defined_id} \
          registry.${region_id}.aliyuncs.com/log-service/logtail:v2.1.11.0-aliyun

      Important

      Personnalisez les paramètres de démarrage du conteneur Logtail uniquement si les conditions suivantes sont remplies.

      • Au démarrage, configurez les variables d'environnement ALIYUN_LOGTAIL_CONFIG, ALIYUN_LOGTAIL_USER_ID et ALIYUN_LOGTAIL_USER_DEFINED_ID.

      • Montez le répertoire /var/run de l'hôte vers le répertoire /var/run du conteneur Logtail.

      • Montez le répertoire racine de l'hôte vers le répertoire /logtail_host du conteneur Logtail.

      • Si le message d'erreur The parameter is invalid : uuid=none apparaît dans le journal Logtail (/usr/local/ilogtail/ilogtail.LOG), créez un fichier product_uuid sur l'hôte. Saisissez ensuite un UUID valide, tel que 169E98C9-ABC0-4A92-B1D2-AA6239C0D261, dans ce fichier et montez-le vers le répertoire /sys/class/dmi/id/product_uuid du conteneur Logtail.

   3. Exécutez la commande docker ps pour vérifier si le conteneur a démarré avec succès.

3. Créez un groupe de machines avec un identifiant personnalisé.

   1. Connectez-vous à la console Simple Log Service. Dans la section Projects, cliquez sur le projet souhaité.

   2. Dans le volet de navigation de gauche, choisissez Resources > Machine Groups. Dans la liste Machine Groups, choisissez > Create Machine Group.

   3. Sur la page Create Machine Group, saisissez un Name. Sélectionnez Custom Identifier comme identifiant du groupe de machines. Dans le champ Custom Identifier, saisissez la valeur du paramètre ${user_defined_id} de l'étape 1, par exemple user-defined-docker-1.

      Paramètre	Description
      Machine Group Topic	Facultatif. Le topic sert à identifier les journaux générés par différents serveurs.

4. Vérifiez l'état du groupe de machines.

   Dans la liste des groupes de machines, cliquez sur le groupe cible. Sur la page de configuration du groupe de machines, consultez la configuration du groupe et l'état du serveur.

   Si l'état Heartbeat est OK, la configuration a réussi. Si l'état est FAIL, attendez une minute puis cliquez sur Refresh. Si l'état Heartbeat reste FAIL, vérifiez les points suivants :

   1. Le conteneur Logtail et le projet se trouvent-ils dans la même région ?

   2. Le groupe de sécurité de l'hôte autorise-t-il le trafic sortant de Logtail ? Le port par défaut est 80.

   Pour plus d'informations sur le dépannage de ce problème, consultez la rubrique Résoudre les problèmes de collecte de journaux de conteneurs.

Étape 2 : Créer une configuration Logtail

1. Sous l'onglet Log Storage > Logstores, cliquez sur le logstore souhaité.

2. Dans la barre de menu des Logstores, cliquez sur Logtail Configurations, puis sur Add Logtail Configuration.

3. Sur la page Quick Data Import, cliquez sur Docker Stdout and Stderr - Old Version.

4. Comme vous avez créé un groupe de machines à l'étape 1, cliquez sur Use Existing Machine Groups.

5. À l'étape Machine Group Configurations, sélectionnez le groupe de machines créé à l'étape 1, cliquez sur > pour l'ajouter aux groupes de machines appliqués, puis cliquez sur Next.

6. À l'étape Logtail Configuration, saisissez un Configuration Name, puis cliquez sur Next.

7. À l'étape Query and Analysis Configurations, cliquez sur Refresh pour prévisualiser les journaux collectés. Si aucun journal ne s'affiche, assurez-vous que le conteneur génère continuellement des journaux de sortie standard. Par défaut, la sortie standard est stockée dans /var/lib/docker/containers/<Container ID>/<Container ID>-json.log. Si vous ne parvenez toujours pas à prévisualiser les journaux, consultez la rubrique Résoudre les erreurs de collecte de journaux de conteneurs.

Étape 3 : Afficher les résultats

Par défaut, chaque journal de sortie standard Docker collecté contient les champs suivants :

Références

• Pour savoir comment afficher l'état d'exécution de Logtail, consultez la rubrique Afficher l'état de Logtail.

• Pour en savoir plus sur l'utilisation de Docker, consultez la rubrique Installer et utiliser Docker et Docker Compose.

• Pour collecter des journaux texte à partir de conteneurs Docker, consultez la rubrique Collecter les journaux des conteneurs Docker (sortie standard et fichiers).

• Pour collecter des journaux texte depuis l'hôte, consultez la rubrique Collecter les journaux texte de l'hôte. Par défaut, le répertoire racine de l'hôte est monté sur le répertoire /logtail_host du conteneur Logtail.

• Une fois les journaux chargés dans un logstore, vous devez créer des index avant de pouvoir interroger et analyser les journaux. Pour plus d'informations, consultez les rubriques Créer des index et Guide de démarrage rapide pour l'interrogation et l'analyse des journaux.

• Si une exception se produit lors de la collecte des journaux de conteneurs Docker avec Logtail, consultez la rubrique Résoudre les problèmes de collecte de journaux de conteneurs.