Simple Log Service:Dépannage des problèmes de groupes de machines Logtail

Exemples d'installation de groupe de machines

Liste de contrôle pour le dépannage

1. Étape 1 : Vérifiez que Logtail est en cours d'exécution: vérifiez si le processus Logtail est actif sur le serveur.

2. Étape 2 : Vérifiez que l'adresse IP du groupe de machines correspond à l'adresse IP obtenue par Logtail: une inadéquation entre l'adresse IP du groupe de machines et celle figurant dans le fichier app_info.json de Logtail peut entraîner des échecs de battement de cœur.

3. Étape 3 : Vérifiez l'exactitude des paramètres de démarrage de Logtail: vérifiez si la région du projet configurée dans le fichier ilogtail_config.json est correcte.

4. Étape 4 : Vérifiez la connectivité réseau: assurez-vous que le serveur peut se connecter aux endpoints du projet.

5. Étape 5 : Vérifiez l'heure système sur le serveur Logtail: si l'heure système diffère considérablement de l'heure réelle, corrigez-la.

6. Étape 6 : Vérifiez l'identifiant utilisateur pour la collecte inter-comptes: cette étape est requise si le serveur n'est pas une instance ECS ou si l'instance et le projet appartiennent à des comptes Alibaba Cloud différents.

7. Étape 7 : Vérifiez l'identifiant personnalisé pour un groupe de machines basé sur un identifiant personnalisé: si vous utilisez un groupe de machines basé sur un identifiant personnalisé, assurez-vous que cet identifiant est configuré sur le serveur.

8. Étape 8 : Redémarrez Logtail: après avoir effectué des modifications, redémarrez Logtail pour les appliquer.

Étapes suivantes

Afficher les erreurs de collecte Logtail: si le statut du battement de cœur est OK mais que les journaux ne sont toujours pas collectés, consultez les messages d'erreur de Logtail pour poursuivre le dépannage.

Étape 1 : Vérifiez le statut de Logtail

1. Obtenez la valeur du champ ip à partir du fichier app_info.json.

   Le tableau suivant répertorie les chemins d'accès par défaut à ce fichier sur différents systèmes d'exploitation.

   Système d'exploitation	Logtail	Chemin d'accès app_info.json
   Linux	Logtail (64 bits)	/usr/local/ilogtail/app_info.json
   Windows (64 bits)	Logtail (64 bits)	C:\Program Files\Alibaba\Logtail\app_info.json
   	Logtail (32 bits)	C:\Program Files (x86)\Alibaba\Logtail\app_info.json
   Windows (32 bits)	Logtail (32 bits)	C:\Program Files\Alibaba\Logtail\app_info.json

   Logtail enregistre l'adresse IP collectée dans le champ ip du fichier app_info.json.

   {
     "UUID" : "",
     "hostname" : "iZ8vbdlzf******azuhZ",
     "instance_id" : "E9633380-***********-00163E1AA597_172.16.2.200_166****11",
     "ip" : "172.**.**.200",
     "logtail_version" : "1.3.1",
     "os" : "Linux; 4.19.91-26.1.al7.x86_64; #1 SMP Tue Jul 26 17:52:28 CST 2022; x86_64",
     "update_time" : "2022-12-27 05:38:33"
   }

2. Vérifiez que le groupe de machines utilise l'adresse IP obtenue par Logtail.

   Simple Log Service propose deux types de groupes de machines : les groupes de machines basés sur l'adresse IP et les groupes de machines basés sur un identifiant personnalisé. Pour plus d'informations, consultez la rubrique Groupes de machines.

   • Groupe de machines basé sur l'adresse IP : vérifiez si la liste IP Address contient l'adresse IP que vous avez obtenue à l'étape précédente.

     Si l'adresse IP n'est pas incluse, confirmez d'abord l'adresse IP correcte du serveur. Si l'adresse figurant dans la liste IP Address est incorrecte, mettez-la à jour dans les paramètres du groupe de machines. Si l'adresse IP obtenue par Logtail à l'étape précédente est erronée, modifiez le paramètre working_ip comme décrit dans la rubrique Définir les paramètres de démarrage de Logtail et redémarrez Logtail. Après avoir effectué la correction, surveillez le battement de cœur de la machine. Si le statut devient normal, le problème est résolu.

   • Groupe de machines basé sur un identifiant personnalisé : dans la liste Machine Group Status, recherchez l'adresse IP que vous avez obtenue à l'étape précédente. Si le statut Heartbeat est OK, le problème est résolu.

Le fichier ilogtail_config.json contient les paramètres de démarrage de Logtail.

1. Connectez-vous au serveur sur lequel Logtail est installé.

2. Localisez le fichier ilogtail_config.json.

   Le tableau suivant répertorie les chemins d'accès par défaut à ce fichier selon le système d'exploitation.

   Système d'exploitation	Logtail	Chemin d'accès à ilogtail_config.json
   Linux	Logtail (64 bits)	/usr/local/ilogtail/ilogtail_config.json
   Windows (64 bits)	Logtail (64 bits)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json
   	Logtail (32 bits)	C:\Program Files (x86)\Alibaba\Logtail\ilogtail_config.json
   Windows (32 bits)	Logtail (32 bits)	C:\Program Files\Alibaba\Logtail\ilogtail_config.json

   1. Ouvrez le fichier ilogtail_config.json et vérifiez que les paramètres de configuration sont corrects.

      {
        "config_server_address" : "http://logtail.<config_region>.log.aliyuncs.com",
        "data_server_list" :
        [
          {
            "cluster" : "<project_region>",
            "endpoint" : "<endpoint>"
          }
        ],
        ...
      }

      • Les paramètres de démarrage du fichier ilogtail_config.json sont corrects s'ils correspondent aux descriptions suivantes.

      • Si les paramètres de démarrage sont incorrects, modifiez le fichier ilogtail_config.json en vous basant sur le tableau ci-dessous, puis redémarrez Logtail. Pour plus d'informations, consultez la section Redémarrer Logtail.

        Pour obtenir la liste des régions de projet, consultez la rubrique Régions prises en charge.

        Scénario	Type de réseau	<config_region>	<endpoint>
        Le serveur est une instance ECS située dans la même région que le projet.	Réseau interne Alibaba Cloud	<project_region>-intranet	<project_region>-intranet.log.aliyuncs.com
        Autres scénarios	Internet	<project_region>	<project_region>.log.aliyuncs.com
        	accélération de transfert		log-global.aliyuncs.com

Pour garantir le succès du téléchargement des données, le serveur Logtail doit pouvoir se connecter aux adresses suivantes.

1. L'adresse spécifiée par le champ config_server_address dans le fichier ilogtail_config.json, ainsi que sa version HTTPS.

2. http://<project-name>.<endpoint>.

   • Vous pouvez identifier le nom du projet et la région comme illustré dans la figure suivante.

     

   • <endpoint> correspond à l'adresse spécifiée par le paramètre data_server_list.endpoint dans le fichier ilogtail_config.json.

3. http://ali-<project-region>-sls-admin.<endpoint>, où <endpoint> est l'adresse indiquée dans le champ data_server_list.endpoint du fichier ilogtail_config.json.

Suivez les étapes ci-dessous pour vérifier et résoudre les problèmes réseau :

Linux

1. Connectez-vous au serveur sur lequel Logtail est installé.

2. Exécutez la commande date pour afficher l'heure système.

   Wed Dec 28 06:59:26 UTC 2022

   Si l'heure système présente un écart significatif par rapport à l'heure réelle, appliquez l'une des mesures suivantes.

   • Ajustez l'heure système pour qu'elle corresponde à l'heure correcte.

   • S'il n'est pas possible de modifier l'heure système, ajustez les paramètres de démarrage de Logtail en ajoutant l'élément de configuration "enable_log_time_auto_adjust": true au fichier ilogtail_config.json. Après avoir modifié le fichier, redémarrez Logtail. Pour plus d'informations, consultez la section Redémarrer Logtail. Pour connaître le chemin d'accès au fichier ilogtail_config.json, reportez-vous à la section Étape 3 : Vérifier si les paramètres de démarrage de Logtail sont corrects.

Windows

1. Connectez-vous au serveur sur lequel Logtail est installé.

2. Vérifiez l'heure affichée dans la barre des tâches, en bas à droite du bureau.

   • Ajustez l'heure système pour qu'elle corresponde à l'heure correcte.

   • S'il n'est pas possible de modifier l'heure système, ajustez les paramètres de démarrage de Logtail. Ajoutez la configuration "enable_log_time_auto_adjust": true au fichier ilogtail_config.json. Après la modification, vous devez redémarrer Logtail. Pour plus d'informations, consultez la section Redémarrer Logtail. Pour connaître le chemin d'accès au fichier ilogtail_config.json, reportez-vous à la section Étape 3 : Vérifier les paramètres de démarrage.

Étape 6 : Vérifier l'identifiant utilisateur

Vérifiez la présence du fichier d'identifiant utilisateur dans le répertoire spécifié afin de valider sa configuration. Ce fichier autorise le compte du projet à accéder au serveur.

• Si le fichier d'identifiant utilisateur est absent du chemin spécifié ou s'il est mal configuré, appliquez la procédure suivante pour résoudre le problème :

  • Pour les systèmes Linux : exécutez la commande cd /etc/ilogtail/users/ && touch <uid> afin de créer le fichier d'identifiant utilisateur. Dans cette commande, <uid> représente l'ID du compte Alibaba Cloud auquel appartient le projet.

  • Sous Windows, accédez au répertoire C:\LogtailData\users\ et créez un fichier vide nommé <uid>, où <uid> correspond à l'ID du compte Alibaba Cloud du projet.

• Si un fichier portant le nom de l'ID du compte Alibaba Cloud du projet existe déjà dans le chemin indiqué, l'identifiant utilisateur est correctement configuré.

Étape 7 : Vérifier l'identifiant personnalisé

Lorsque vous utilisez un groupe de machines basé sur un identifiant personnalisé, examinez le fichier user_defined_id dans le répertoire prévu à cet effet pour déterminer si un identifiant personnalisé est configuré sur le serveur.

• Si le résultat est vide, vérifiez l'existence du fichier user_defined_id ou la présence d'un identifiant défini par l'utilisateur dans ce fichier.

  Remarque

  Les chemins d'accès au fichier user_defined_id sont les suivants :

  • Linux : /etc/ilogtail/user_defined_id

  • Windows : C:\LogtailData\user_defined_id

  • Si le fichier user_defined_id n'existe pas, créez-le et saisissez l'identifiant personnalisé associé au groupe de machines. Pour plus de détails, reportez-vous à la section Configurer un identifiant personnalisé.

  • Si le fichier user_defined_id existe mais ne contient pas l'identifiant personnalisé attendu, ajoutez l'identifiant personnalisé du groupe de machines dans ce fichier. Consultez la rubrique Configurer un identifiant personnalisé pour obtenir la marche à suivre.

  • Si le fichier user_defined_id contient déjà l'identifiant personnalisé que vous avez défini pour le groupe de machines, la configuration est correcte.

Étape 8 : Redémarrer Logtail

Après avoir effectué ces modifications, vous devez redémarrer Logtail.

FAQ