Tous les produits
Search

Ce produit

    Simple Log Service:Dépannage des problèmes de pulsation

    Centre de documentation

    Simple Log Service:Dépannage des problèmes de pulsation

    Dernière mise à jour :Sep 10, 2026

    La pulsation d'un groupe de machines surveille la communication entre un serveur et Simple Log Service (SLS). Si la pulsation est anormale, le serveur ne peut pas envoyer de données à SLS.

    Causes des problèmes de pulsation

    LoongCollector utilise les éléments de configuration suivants pour identifier le projet de destination et signaler les pulsations. Pour résoudre les problèmes de pulsation, vérifiez ces éléments et contrôlez la connectivité réseau.

    • Le compte Alibaba Cloud propriétaire du projet SLS : ce compte doit disposer des autorisations nécessaires pour accéder aux journaux du serveur et les collecter.

    • La région et le type de connexion du projet : l'endpoint SLS est généré dynamiquement en fonction de la région et du type de connexion. Assurez-vous que le serveur peut se connecter à cet endpoint. Types de connexions réseau et endpoints.

    • Identifiant personnalisé ou adresse IP : LoongCollector établit une pulsation en associant le serveur à un groupe de machines via une adresse IP ou un identifiant personnalisé.

    Processus d'établissement de la pulsation

    image

    1. LoongCollector lit sa configuration pour récupérer les ID de compte Alibaba Cloud, l'endpoint (généré à partir de la région et du type de connexion), ainsi que l'adresse IP ou l'identifiant personnalisé du serveur.

    2. LoongCollector signale une pulsation à un projet dans la région spécifiée.

    3. Les projets qui répondent aux critères comparent l'adresse IP ou l'identifiant personnalisé figurant dans leurs groupes de machines avec les informations signalées.

    4. Si les informations correspondent, une pulsation est établie et le statut du groupe de machines concerné passe à OK.

    Scénarios courants de problèmes de pulsation

    La pulsation d'un nouveau serveur est FAIL

    L'établissement de la connexion initiale peut prendre un certain temps. Attendez environ deux minutes, puis actualisez le statut. Si la pulsation reste FAIL :

    1. Vérifiez que vous avez sélectionné le scénario d'installation de LoongCollector approprié. En cas d'erreur, désinstallez puis réinstallez LoongCollector.

      Méthode d'installation

      Scénario applicable

      Même compte et même région

      S'applique lorsque le serveur est une instance ECS située dans le même compte et la même région que le projet.

      Même compte mais régions différentes

      S'applique lorsque le serveur est une instance ECS située dans le même compte mais dans une région différente de celle du projet.

      Comptes différents mais même région

      S'applique lorsque le serveur est une instance ECS située dans la même région que le projet, mais sous un compte différent.

      Autres clouds ou serveurs sur site

      • S'applique lorsque le serveur n'est pas une instance ECS (sur site ou chez un autre fournisseur cloud).

      • S'applique également lorsque l'instance ECS et le projet se trouvent dans des comptes différents et des régions différentes. Dans ce cas, traitez le serveur comme s'il était sur site.

    2. Sur le serveur, exécutez sudo /etc/init.d/loongcollectord status pour vérifier l'état de LoongCollector. Si la sortie est loongcollector is running, le service a démarré. Sinon, démarrez-le :

      Si vous utilisez Logtail, exécutez sudo /etc/init.d/ilogtaild status pour vérifier son état et sudo /etc/init.d/ilogtaild start pour le démarrer.
      sudo /etc/init.d/loongcollectord start

    3. Dans un scénario inter-comptes, configurez un fichier d'ID utilisateur pour accorder au compte du projet les autorisations d'accès au serveur et de collecte des journaux.

      Vérifier le fichier d'ID utilisateur

      1. Vérifiez que le fichier /etc/ilogtail/users/{Alibaba Cloud account ID} existe. Créez-le s'il est manquant.

        1. Connectez-vous à la console Simple Log Service. Survolez l'image de profil dans le coin supérieur droit et copiez l'ID du compte principal.

        2. Sur le serveur où LoongCollector est installé, créez un fichier d'ID utilisateur. Utilisez l'ID du compte principal comme nom de fichier.

          touch /etc/ilogtail/users/{Alibaba Cloud account ID} # Use the main account ID as the filename. No file extension is needed.

      2. Vérifiez que le nom de fichier respecte les exigences suivantes :

        • L'{Alibaba Cloud account ID} doit correspondre à l'ID du compte principal.

        • L'{Alibaba Cloud account ID} doit correspondre à l'ID du compte Alibaba Cloud propriétaire du projet SLS, et non à celui du compte propriétaire du serveur.

    4. Vérifiez la région et le type de connexion, et confirmez que le serveur peut atteindre l'endpoint. Contrôlez si la valeur region dans /usr/local/ilogtail/ilogtail_config.json correspond à l'ID de région du projet SLS. Si ce n'est pas le cas, modifiez la configuration :

      Tester la connectivité de l'endpoint et modifier la configuration du serveur

      1. Connectez-vous à la console Simple Log Service. Dans la liste des projets, cliquez sur le projet de destination.

      2. Cliquez sur l'icône image située à droite du nom du projet pour ouvrir la page de présentation du projet.

      3. Dans la section Endpoint, consultez l'endpoint du projet actuel. Remplacez ${project_name} par le nom de votre projet et ${endpoint} par l'endpoint public, puis exécutez la commande suivante sur le serveur :

        curl https://${project_name}.${endpoint}

      4. Une réponse telle que {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} indique que la connexion réseau fonctionne. Dans le cas contraire, vérifiez si la destination est bloquée et contrôlez les paramètres DNS, du groupe de sécurité et des ports (port 80 pour HTTP, port 443 pour HTTPS).

        Cette erreur est attendue et confirme la connectivité réseau. Elle survient car la commande de test n'inclut pas les paramètres requis pour une requête API valide.

      5. Modifiez les paramètres suivants dans le fichier /usr/local/ilogtail/ilogtail_config.json :

        • config_servers : le chemin d'accès pour la récupération des configurations de collecte. Définissez-le sur "http://logtail.${endpoint}", où ${endpoint} représente l'endpoint public.

        • data_servers :

          • region : la région pour la transmission des données. Définissez-la sur "${region_id}", où ${region_id} correspond à l'ID de région du projet SLS.

          • endpoint_list : le chemin d'accès pour la transmission des données. Définissez-le sur "${endpoint}", où ${endpoint} représente l'endpoint public.

      6. Enregistrez les modifications et redémarrez LoongCollector.

        Si vous utilisez Logtail, la commande de redémarrage est : sudo /etc/init.d/ilogtaild restart 
        sudo /etc/init.d/loongcollectord restart

    5. Vérifiez l'identifiant personnalisé ou l'adresse IP :

      1. Connectez-vous à la console Simple Log Service. Dans la liste des projets, cliquez sur le projet de destination.

      2. Dans le volet de navigation de gauche, choisissez image Resources > Machine Groups. Sur la page Machine Groups, cliquez sur le groupe de machines cible.

      3. Sur la page Machine Group Configurations, vérifiez l'Machine Group Identifier et effectuez l'action correspondante :

        Identifiant personnalisé

        1. Vérifiez que /etc/ilogtail/user_defined_id existe sur le serveur. Créez-le s'il est manquant.

        2. Écrivez une chaîne personnalisée dans ce fichier en tant qu'identifiant personnalisé. Cet exemple utilise user-defined-test-1.

          # Write a custom string to the specified file.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

        3. Dans la console, définissez la valeur de Custom Identifier sur la chaîne personnalisée. Dans cet exemple, la valeur est user-defined-test-1.

        Adresse IP

        Ajoutez la valeur ip issue de /usr/local/ilogtail/app_info.json sur le serveur au champ IP Address dans la console.

        Logique de récupération de l'adresse IP : si un mappage nom d'hôte-adresse IP est configuré dans le fichier /etc/hosts du serveur, l'adresse IP mappée est utilisée. Si aucun mappage n'est configuré, l'adresse IP de la première carte réseau (NIC) est utilisée. Si le paramètre working_ip est défini dans le fichier /usr/local/ilogtail/ilogtail_config.json, sa valeur est utilisée comme adresse IP du serveur. Assurez-vous qu'une adresse IP peut être récupérée par au moins l'une de ces méthodes. Sinon, le champ ip sera vide et aucune pulsation ne pourra être établie.

    La pulsation passe de OK à FAIL

    Une pulsation précédemment réussie confirme que votre configuration initiale était correcte. Si le groupe de machines utilise un identifiant personnalisé, les paramètres sont statiques et le problème est probablement lié au réseau — vérifiez la connectivité vers l'endpoint SLS. Si le groupe de machines utilise une adresse IP, un statut FAIL indique généralement un changement ou un conflit d'adresse IP.

    1. Redémarrez LoongCollector sur le serveur pour récupérer la dernière adresse IP.

      Si vous utilisez Logtail, la commande de redémarrage est : sudo /etc/init.d/ilogtaild restart 
      sudo /etc/init.d/loongcollectord restart

    2. Consultez le champ ip dans /usr/local/ilogtail/app_info.json sur le serveur.

      Logique de récupération de l'adresse IP : si un mappage nom d'hôte-adresse IP est configuré dans le fichier /etc/hosts du serveur, l'adresse IP mappée est utilisée. Si aucun mappage n'est configuré, l'adresse IP de la première carte réseau (NIC) est utilisée. Si le paramètre working_ip est défini dans le fichier /usr/local/ilogtail/ilogtail_config.json, sa valeur est utilisée comme adresse IP du serveur.

    3. Connectez-vous à la console Simple Log Service. Dans la liste des projets, cliquez sur le projet de destination.

    4. Dans le volet de navigation de gauche, choisissez image Resources > Machine Groups. Sur la page Machine Groups, cliquez sur le groupe de machines cible.

    5. Sur la page Machine Group Configurations, vérifiez si le champ IP Address contient la valeur du champ ip du fichier /usr/local/ilogtail/app_info.json. Si ce n'est pas le cas, ajoutez la valeur du champ ip au champ IP Address.

    6. Si l'adresse IP correspond mais que la pulsation reste FAIL, l'adresse IP peut être instable ou entrer en conflit. Envisagez de passer à un identifiant personnalisé.

    Échec de la pulsation après modification du type d'identifiant

    Si des conflits ou des changements d'adresse IP rendent les groupes de machines basés sur l'IP inadaptés, passez à un identifiant personnalisé. Ce changement n'affecte ni la connectivité réseau, ni les informations de compte, ni les paramètres de région. Assurez-vous que l'identifiant personnalisé est correctement configuré :

    1. Confirmez que /etc/ilogtail/user_defined_id existe. Créez-le s'il est manquant.

    2. Écrivez une chaîne personnalisée dans ce fichier en tant qu'identifiant personnalisé. Cet exemple utilise user-defined-test-1.

      # Write a custom string to the specified file.
echo "user-defined-test-1" > /etc/ilogtail/user_defined_id

    3. Connectez-vous à la console Simple Log Service. Dans la liste des projets, cliquez sur le projet de destination.

    4. Dans le volet de navigation de gauche, choisissez image Resources > Machine Groups. Sur la page Machine Groups, cliquez sur le groupe de machines cible.

    5. Sur la page Machine Group Configurations, confirmez les paramètres suivants. S'ils sont incorrects, cliquez sur Modify dans le coin supérieur droit pour les mettre à jour.

      • Machine Group Identifier : Custom Identifier.

      • Custom identifier : la chaîne personnalisée. Dans cet exemple, la valeur est user-defined-test-1.

    FAQ

    Pourquoi la pulsation est-elle FAIL alors que la configuration est correcte ?

    Si les configurations sont correctes et que le réseau fonctionne, la pulsation peut tout de même être FAIL pour les raisons suivantes :

    • L'intervalle de pulsation est limité car aucune configuration de collecte n'a été appliquée dans la région depuis longtemps.

      • Pour réduire la charge du service, l'agent diminue la fréquence de ses demandes de configuration lorsqu'une région ne renvoie aucune configuration. L'intervalle peut augmenter jusqu'à 12 minutes. Si cela dépasse le seuil de délai d'expiration de la pulsation, le statut passe à FAIL.

      • Solution : ignorez le statut FAIL et appliquez une configuration de collecte au groupe de machines. La pulsation sera rétablie lors de la prochaine demande. Pour la restaurer immédiatement, redémarrez l'agent.

    • La configuration en cours d'exécution ne correspond pas au fichier ilogtail_config.json actuel.

      • Exemple : l'agent démarre avec une configuration non par défaut, puis ilogtail_config.json est modifié sans redémarrer l'agent.

      • Comment vérifier :

        • La solution la plus simple consiste à redémarrer l'agent. Il chargera automatiquement la dernière configuration.

        • Vérifiez les journaux : si vous souhaitez éviter d'interrompre la collecte, consultez /usr/local/ilogtail/ilogtail.LOG. Depuis le début du fichier, recherchez load logtail config file. L'entrée correspondante affiche la configuration active. Vérifiez qu'elle correspond à votre fichier local.

    **Comment résoudre l'erreur fetch ecs token fail Timeout was reached signalée par LoongCollector ?**

    Cette erreur se produit lorsque LoongCollector ne peut pas accéder au service de métadonnées ECS à l'adresse 100.100.100.200.

    Sur l'instance ECS, exécutez la commande suivante pour tester la connectivité au service de métadonnées :

    curl http://100.100.100.200/latest/meta-data/instance-id

    Si la commande ne parvient pas à se connecter, vérifiez si la configuration du groupe de sécurité ECS autorise l'accès au service de métadonnées ECS.

    Comment dépanner les délais d'expiration lorsqu'une instance ECS accède à un endpoint interne SLS dans la même région ?

    Commencez par confirmer que l'instance ECS et le projet Simple Log Service se trouvent dans la même région. Testez ensuite la résolution DNS et la connectivité aux endpoints internes OSS et SLS :

    curl -v http://${oss_internal_endpoint}
curl -v http://${sls_project_name}.${sls_internal_endpoint}

    Remplacez ${oss_internal_endpoint}, ${sls_project_name} et ${sls_internal_endpoint} par les valeurs d'endpoint internes correspondant à votre région et à votre projet.

    Vérifiez si le pare-feu iptables ou un logiciel de sécurité tel que Tailscale bloque les plages de réseau interne Alibaba Cloud, y compris 100.64.0.0/10 et 100.115.0.0/16. Si une règle bloque l'une de ces plages, ajoutez-la à la liste d'autorisation. Vérifiez également que la configuration DNS pointe vers les serveurs DNS internes Alibaba Cloud 100.100.2.136 et 100.100.2.138.

    Comment résoudre une adresse IP incorrecte signalée par LoongCollector lorsque NodeLocalDNS est utilisé dans un cluster ACK ?

    NodeLocalDNS peut amener LoongCollector à sélectionner une adresse IP provenant d'une interface réseau virtuelle. Dans /usr/local/ilogtail/ilogtail_config.json, ajoutez ou mettez à jour le paramètre working_ip avec l'adresse IP physique correcte du nœud. Redémarrez LoongCollector pour appliquer la configuration :

    sudo /etc/init.d/loongcollectord restart

    Si vous utilisez le collecteur de données Logtail, redémarrez-le à la place :

    sudo /etc/init.d/ilogtaild restart

    **Comment résoudre l'erreur ClientNotRunning lors de l'installation automatique de Logtail lorsque aliyun.service n'est pas en cours d'exécution ?**

    L'installation automatique de Logtail nécessite le service Cloud Assistant. Sur l'instance ECS, exécutez la commande suivante pour activer et démarrer le service :

    systemctl enable aliyun.service --now

    Une fois le service démarré, répétez l'installation automatique du composant de collecte dans Simple Log Service.

    **Comment résoudre l'erreur daemon not found, but found orphaned workers lorsque LoongCollector ne parvient pas à démarrer ?**

    Cette erreur peut indiquer des processus de composants anormaux ou des ressources serveur insuffisantes. Vérifiez les données de surveillance de la mémoire et du CPU du serveur pour déterminer si l'utilisation des ressources est trop élevée. Utilisez ensuite Component Management pour mettre à niveau le composant LoongCollector vers la dernière version disponible.

    Si le problème persiste après la mise à niveau, désinstallez le composant LoongCollector et réinstallez-le. Dans le machine group, vérifiez que la pulsation d'un groupe de machines est normale et confirmez que sa configuration de collecte est correcte.