Tous les produits
Search
Centre de documentation

Simple Log Service:Installer LoongCollector

Dernière mise à jour :Aug 18, 2026

LoongCollector est l'agent de collecte de journaux pour Simple Log Service (SLS). Pour collecter les journaux depuis des serveurs Linux, vous devez d'abord installer LoongCollector sur ces derniers.

Limitations

Systèmes d'exploitation Linux pris en charge

  • Les systèmes d'exploitation Linux 64 bits (x86-64) suivants sont pris en charge :

    • Alibaba Cloud Linux 2 et 3

    • Anolis OS 7 et 8

    • CentOS 6, 7 et 8

    • Debian 8, 9, 10, 11 et 12

    • Red Hat Enterprise Linux 6, 7, 8 et 9

    • openSUSE 15.1, 15,2 et 42,3

    • SUSE Linux Enterprise Server 11, 12 et 15

    • Ubuntu 14.04, 16,04, 18,04, 20,04, 22,04 et 24,04

    • Autres systèmes d'exploitation Linux basés sur glibc 2.6 ou version ultérieure

    • Le processeur doit prendre en charge les jeux d'instructions SSE4,2 et AVX.

  • Les systèmes d'exploitation Linux ARM 64 bits suivants sont pris en charge :

    • Alibaba Cloud Linux 3.2 pour ARM

    • Anolis OS 8.2 pour ARM ou version ultérieure

    • CentOS 8.4 pour ARM

    • Debian 11.2 et 12,2 pour ARM

    • Ubuntu 20.04, 22,04 et 24,04 pour ARM

    • L'architecture du processeur doit être ARMv8.2-A ou version ultérieure.

Prérequis

Autorisations

La connexion à la console Alibaba Cloud avec un compte root accorde par défaut les autorisations requises.

Si vous êtes un utilisateur RAM, demandez au propriétaire du compte root les stratégies système suivantes afin d'obtenir les autorisations nécessaires pour gérer les ressources SLS, ECS et Operation Orchestration Service (OOS).

  • AliyunLogFullAccess : accorde des autorisations complètes pour gérer SLS.

  • AliyunOOSFullAccess : accorde des autorisations complètes pour gérer OOS. Requis pour utiliser OOS afin d'automatiser l'installation de LoongCollector.

  • AliyunECSFullAccess : accorde des autorisations complètes pour gérer ECS. Requis pour utiliser Cloud Assistant afin d'installer LoongCollector par lot.

Si les stratégies système par défaut ne répondent pas à vos besoins, vous pouvez créer une stratégie personnalisée pour un contrôle d'accès granulaire. Pour plus d'informations, consultez l'exemple suivant.

Remplacez ${projectName} dans le champ Resource par le nom de votre projet.
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ecs:DescribeTagKeys",
        "ecs:DescribeTags",
        "ecs:DescribeInstances",
        "ecs:DescribeInvocationResults",
        "ecs:RunCommand",
        "ecs:DescribeInvocations",
        "ecs:InvokeCommand"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "oos:ListTemplates",
        "oos:StartExecution",
        "oos:ListExecutions",
        "oos:GetExecutionTemplate",
        "oos:ListExecutionLogs",
        "oos:ListTaskExecutions"
      ],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListProject",
        "log:GetAcceleration",
        "log:ListDomains",
        "log:GetLogging",
        "log:ListTagResources"
      ],
      "Resource": [
        "acs:log:*:*:project/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:GetProject"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:ListLogStores",
        "log:GetLogStore",
        "log:GetLogStoreHistogram",
        "log:GetIndex",
        "log:CreateIndex",
        "log:UpdateIndex",
        "log:ListShards",
        "log:GetCursorOrData",
        "log:ListSavedSearch",
        "log:GetLogStoreLogs",
        "log:ListDashboard",
        "log:GetLogStoreContextLogs"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:*"
      ],
      "Resource": [
        "acs:log:*:*:project/${projectName}/logtailconfig/*",
        "acs:log:*:*:project/${projectName}/machinegroup/*"
      ]
    }
  ]
}

Créer un projet

Si vous ne disposez pas de projet disponible, suivez ces étapes pour créer un projet de base. Pour plus de détails sur la configuration de création, consultez Gérer les projets.

Connectez-vous à la console SLS, puis cliquez sur Create Project. Configurez les paramètres suivants et conservez les valeurs par défaut pour les autres paramètres :

  • Region : sélectionnez une région Alibaba Cloud en fonction de la source de vos journaux. Ce paramètre ne peut pas être modifié après la création du projet.

  • Project Name : saisissez un nom pour le projet. Le nom doit être globalement unique dans la région Alibaba Cloud sélectionnée et ne peut pas être modifié après la création.

Créer un Logstore

Si vous ne disposez pas de Logstore disponible, créez-en un de base. Pour plus d'informations sur les détails de configuration, consultez Gérer un Logstore.

  1. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet souhaité.

  2. Dans la section Log Storage, accédez à l'onglet Logstores et cliquez sur l'icône +.

  3. Saisissez un Logstore Name et conservez les valeurs par défaut pour les autres paramètres.

Exigences réseau du serveur

  1. Le serveur sur lequel LoongCollector est installé doit autoriser le trafic sortant sur les ports 80 (HTTP) et 443 (HTTPS) pour le téléchargement des données.

  2. Le serveur doit pouvoir se connecter à l'endpoint SLS. Pour vérifier la connectivité, suivez ces étapes :

    1. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet souhaité.

    2. Cliquez sur l'icône image située à côté du nom du projet pour accéder à la page Project Overview.

    3. Dans la section Endpoint, consultez les informations d'endpoint du projet. Ensuite, remplacez les variables dans la commande suivante et exécutez-la.

      curl https://${project_name}.${endpoint}
    4. Une réponse similaire à {"Error":{"Code":"OLSInvalidMethod","Message":"The script name is invalid : /","RequestId":"5D****09"}} indique que la connexion réseau est normale. Dans le cas contraire, vérifiez les paramètres de votre pare-feu, de votre configuration DNS et de votre groupe de sécurité.

      Cette erreur est attendue car l'URL de la requête ne contient pas les paramètres requis. Ce test vérifie uniquement la connectivité réseau et n'utilise pas une URL de requête complète.

Choisir une méthode d'installation

Méthode d'installation

Scénario

Même compte et même région

Le serveur est une instance ECS dans le même compte et la même région que le projet.

Même compte, région différente

Le serveur est une instance ECS dans le même compte que le projet, mais dans une région différente.

Comptes différents, même région

Le serveur est une instance ECS dans la même région que le projet, mais dans un compte différent.

Autres plateformes cloud ou serveurs sur site

  • Le serveur n'est pas une instance Alibaba Cloud ECS, comme un serveur sur site ou un serveur d'un autre fournisseur cloud.

  • Le serveur est une instance Alibaba Cloud ECS, mais l'instance et le projet appartiennent à des comptes Alibaba Cloud différents et se trouvent dans des régions différentes. Dans ce cas, l'instance ECS est traitée comme un serveur sur site.

Même compte et même région

Si votre instance ECS et votre projet se trouvent dans le même compte et la même région, vous pouvez utiliser l'installation en un clic. SLS utilise OOS pour automatiser l'installation, vous n'avez donc pas besoin de vous connecter manuellement à l'instance.

La fonctionnalité d'installation en un clic est intégrée aux modèles de collecte de données de SLS. SLS propose divers modèles de journaux texte, tels que les modèles mono-ligne, multi-lignes et basés sur des expressions régulières. Ces modèles ne diffèrent que par leurs plug-ins de traitement . Vous pouvez ajouter ou supprimer des plug-ins de traitement au sein d'un modèle. Sélectionnez un modèle en fonction des caractéristiques des journaux que vous souhaitez collecter, ou choisissez n'importe quel modèle de journal texte, puis configurez les plug-ins de traitement selon les caractéristiques de vos journaux.

Procédure

  1. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet souhaité.

  2. Dans le volet de navigation de gauche, choisissez imageLog Storage > Logstores. Cliquez sur l'icône image située à côté du nom du Logstore souhaité.

  3. Cliquez sur l'icône image située à côté de Data Collection, sélectionnez le modèle d'importation de journaux texte Mono-ligne dans la boîte de dialogue contextuelle, puis cliquez sur Integrate Now.

  4. Cliquez sur Create Machine Group. Sélectionnez une ou plusieurs instances ECS qui se trouvent dans la même région que le projet, puis cliquez sur Install and Create Machine Group.

  5. Attendez la fin de l'installation, saisissez un nom, puis cliquez sur OK. Si l'installation échoue, cliquez sur Recreate Installation Task et resélectionnez les instances ECS. Assurez-vous que les instances ECS sélectionnées se trouvent dans la même région que le projet.

  6. Cliquez sur Next. Si l'état du heartbeat est FAIL, cliquez sur Automatic Retry et attendez environ deux minutes jusqu'à ce que l'état passe à OK.

  7. L'installation en un clic est terminée. Cliquez sur Next pour créer une configuration de collecte.

Même compte, région différente

Si le serveur est une instance Alibaba Cloud ECS, et que l'instance et le projet appartiennent au même compte Alibaba Cloud mais se trouvent dans des régions différentes, vous devez télécharger manuellement le package d'installation et utiliser la transmission de données via Internet ou l'accélération de transfert dans la commande d'installation.

Procédure

  1. Téléchargez le package d'installation. Exécutez la commande de téléchargement sur le serveur. Dans l'exemple de code, vous pouvez remplacer ${region_id} par cn-hangzhou. Pour accélérer le téléchargement, remplacez ${region_id} par l'ID de région de la région où réside l'instance ECS.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Sélectionnez une méthode de transmission et exécutez la commande d'installation. Remplacez ${region_id} par l'ID de région de la région où réside le projet.

    • Internet : cette méthode convient à la plupart des scénarios, tels que les déploiements inter-régions et la collecte de données depuis d'autres plateformes cloud ou des serveurs sur site. Cependant, elle est soumise à des limites de bande passante et à une instabilité potentielle.

      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet
    • Accélération de transfert : cette méthode est utilisée pour la transmission de données inter-régions, par exemple d'une région de Chine continentale vers une région hors de Chine continentale. Elle utilise le Content Delivery Network (CDN) pour accélérer la transmission des données et améliorer les performances, ce qui évite une latence élevée et une instabilité sur Internet. Cependant, cette méthode engendre des frais de transfert de données.

      Vous devez activer la fonctionnalité d'accélération de transfert inter-régions pour le projet avant d'exécuter la commande d'installation.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration
  3. Vérifiez l'état de démarrage. Si loongcollector is running est renvoyé, l'agent est démarré.

    sudo /etc/init.d/loongcollectord status
  4. Configurez un groupe de machines. SLS utilise les groupes de machines pour découvrir les identifiants personnalisés et établir des connexions heartbeat avec LoongCollector sur les hôtes.

    1. Sur le serveur, écrivez une chaîne personnalisée telle que user-defined-test-1 dans le fichier d'identifiant personnalisé. Cette chaîne sera utilisée dans une étape ultérieure.

      # Write a custom string to the specified file. If the directory does not exist, create it manually. The file path and name are fixed by SLS and cannot be changed.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet souhaité.

    3. Dans le volet de navigation de gauche, choisissez imageResources > Machine Groups.

    4. Cliquez sur l'icône image située à côté de Machine Groups, puis cliquez sur Create Machine Group.

    5. Configurez les paramètres suivants et cliquez sur OK.

      • Machine Group Name : saisissez un nom pour le groupe de machines. Il doit être unique au sein du projet, comporter entre 3 et 128 caractères, commencer et se terminer par une lettre minuscule ou un chiffre, et contenir uniquement des lettres minuscules, des chiffres, des traits d'union (-) et des underscores (_).

      • Machine Group Identifier: sélectionnez Custom Identifier.

      • Identifiant personnalisé : saisissez l'identifiant qui correspond à la chaîne personnalisée dans le fichier d'identifiant personnalisé sur le serveur. Par exemple, user-defined-test-1.

  5. Après la création du groupe de machines, cliquez sur le groupe de machines cible dans la liste des groupes de machines pour vérifier l'état du Heartbeat. Si l'état est FAIL, attendez environ deux minutes, puis actualisez manuellement. Un état OK signifie que le groupe de machines a été créé avec succès.

  6. Après l'installation, créez une configuration de collecte pour collecter les journaux.

Comptes différents dans la même région

Si votre serveur est une instance Alibaba Cloud ECS, et que l'instance et le projet se trouvent dans la même région mais appartiennent à des comptes Alibaba Cloud différents, vous devez télécharger manuellement le package d'installation. Utilisez la méthode de transmission via le réseau interne dans la commande d'installation et configurez un ID utilisateur.

Suivez ces étapes :

  1. Téléchargez le package d'installation. Exécutez la commande de téléchargement sur le serveur. Dans l'exemple de code, vous pouvez remplacer ${region_id} par cn-hangzhou. Pour accélérer le téléchargement, consultez l'ID de région et remplacez ${region_id} par la région de l'instance ECS.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Exécutez la commande d'installation. Remplacez ${region_id} par l'ID de région du projet.

    Si un délai de connexion se produit, vous avez peut-être utilisé le mauvais ${region_id} . Le réseau interne ne peut pas établir de connexion entre différentes régions. Corrigez l'ID de région et exécutez à nouveau la commande d'installation.
    chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}
  3. Vérifiez l'état de démarrage. Exécutez la commande. Si loongcollector is running est renvoyé, le démarrage a réussi.

    sudo /etc/init.d/loongcollectord status
  4. Configurez l'ID utilisateur. Le fichier d'ID utilisateur contient l'ID du compte root Alibaba Cloud propriétaire du projet. Cet ID indique que le compte dispose de l'autorisation d'accéder aux journaux de ce serveur et de les collecter.

    Vous devez configurer un ID utilisateur uniquement lorsque vous collectez des journaux à partir d'instances ECS appartenant à un autre compte, de serveurs autogérés ou de serveurs d'autres fournisseurs cloud. Si plusieurs comptes collectent des journaux à partir du même serveur, vous pouvez créer plusieurs fichiers d'ID utilisateur sur ce serveur.
    1. Connectez-vous à la console SLS. Placez le pointeur sur votre photo de profil dans le coin supérieur droit. Dans l'onglet qui s'affiche, consultez et copiez l'ID du compte. Assurez-vous de copier l'ID du compte root.

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

      touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # If the /etc/ilogtail/users directory does not exist, create it manually. The user ID file requires only a filename and no file extension.
  5. Configurez un groupe de machines. SLS utilise le groupe de machines pour découvrir l'identifiant personnalisé et établir une connexion heartbeat avec LoongCollector sur l'hôte.

    1. Sur le serveur, écrivez la chaîne personnalisée user-defined-test-1 dans le fichier d'identifiant personnalisé. Cette chaîne est utilisée dans une étape ultérieure.

      # Write a custom string to the specified file. If the directory does not exist, create it manually.
      # The file path and name are fixed by SLS and cannot be changed.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet cible.

    3. Cliquez sur image Resources, puis cliquez sur Machine Groups.

    4. À droite de la liste Machine Groups, cliquez sur l'icône image, puis cliquez sur Create Machine Group. Vous pouvez également cliquer sur l'icône à quatre carrés dans le coin supérieur droit et sélectionner Create Machine Group dans le menu déroulant.

    5. Configurez les paramètres suivants et cliquez sur OK.

      • Définir Machine Group Name : le nom doit être unique au sein du projet. Le nom doit comporter entre 3 et 128 caractères. Il doit commencer et se terminer par une lettre minuscule ou un chiffre, et ne peut contenir que des lettres minuscules, des chiffres, des traits d'union (-) et des underscores (_).

      • Définir Machine Group Identifier: sur Custom Identifier.

      • Identifiant personnalisé : saisissez l'identifiant personnalisé que vous avez configuré. Cet identifiant doit être identique à la chaîne personnalisée dans le fichier d'identifiant personnalisé sur le serveur. Dans cet exemple, l'identifiant est user-defined-test-1.

  6. Après la création du groupe de machines, cliquez sur le groupe de machines cible dans la liste. Dans la section d'état du groupe de machines, vérifiez l'état du Heartbeat. Si l'état est FAIL, attendez environ deux minutes, puis actualisez la page. Si l'état du heartbeat est OK, le groupe de machines a été créé avec succès.

  7. Une fois l'installation terminée, vous devez créer une configuration de collecte pour collecter les journaux.

Autres serveurs cloud ou sur site

Si votre serveur est hébergé sur une autre plateforme cloud ou s'il s'agit d'un serveur sur site, vous devez télécharger manuellement le package d'installation. Utilisez la méthode du réseau public ou de l'accélération de transfert dans la commande d'installation et configurez un ID utilisateur. Une instance ECS Alibaba Cloud est également considérée comme un serveur sur site si l'instance et le projet appartiennent à des comptes Alibaba Cloud différents ou se trouvent dans des régions différentes.

Remarque

Pour connaître les limites d'utilisation des serveurs, consultez les Distributions Linux prises en charge.

Procédure

  1. Téléchargez le package d'installation. Exécutez la commande de téléchargement sur votre serveur. Dans l'exemple de code, vous pouvez remplacer ${region_id} par cn-hangzhou. Pour accélérer le téléchargement du package, consultez l'ID de région et remplacez ${region_id} par l'ID de région de votre instance ECS.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Choisissez une méthode de transfert et exécutez la commande d'installation. Remplacez ${region_id} par l'ID de région de la région où se trouve votre projet.

    • Réseau public : cette méthode fonctionne pour la plupart des scénarios, y compris les transferts interrégionaux et les serveurs sur d'autres clouds ou sur site. Toutefois, elle est soumise à des limites de bande passante et à une instabilité potentielle.

      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-internet
    • Accélération de transfert : utilisez cette option pour les transferts interrégionaux, par exemple de la Chine continentale vers des régions internationales. Elle utilise l'accélération CDN pour améliorer les performances et éviter la latence élevée et l'instabilité du réseau public. Ce trafic engendre des frais supplémentaires.

      Activez la fonctionnalité d'accélération de transfert de journaux interrégionaux pour votre projet avant d'exécuter la commande d'installation.
      chmod +x loongcollector.sh; ./loongcollector.sh install ${region_id}-acceleration
  3. Vérifiez l'état de démarrage. Exécutez la commande. Si le message loongcollector is running s'affiche, le démarrage a réussi.

    sudo /etc/init.d/loongcollectord status
  4. Configurez l'ID utilisateur. Le fichier d'ID utilisateur contient l'ID du compte racine Alibaba Cloud propriétaire du projet. Cet ID vérifie que le compte dispose des autorisations nécessaires pour accéder aux journaux de ce serveur et les collecter.

    Configurez un ID utilisateur uniquement lors de la collecte de journaux depuis une instance ECS n'appartenant pas à votre compte, un serveur sur site ou un serveur d'un autre fournisseur cloud. Si plusieurs comptes collectent des journaux depuis le même serveur, vous pouvez créer plusieurs fichiers d'ID utilisateur sur celui-ci.
    1. Connectez-vous à la console SLS. Placez le curseur sur votre avatar d'utilisateur dans le coin supérieur droit. Dans l'onglet qui s'affiche, consultez et copiez l'ID du compte. Assurez-vous de copier l'ID du compte racine.

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

      touch /etc/ilogtail/users/{Alibaba Cloud Account ID} # If the /etc/ilogtail/users directory does not exist, create it manually. The user ID file only needs a filename and does not require a file extension.
  5. Configurez un groupe de machines. SLS utilise le groupe de machines pour découvrir l'identifiant personnalisé et établir une connexion heartbeat avec LoongCollector sur l'hôte.

    1. Sur le serveur, écrivez la chaîne personnalisée user-defined-test-1 dans le fichier d'identifiant personnalisé. Cette chaîne sera utilisée dans une étape ultérieure.

      # Write the custom string to the specified file. If the directory does not exist, create it manually. The file path and name are fixed by SLS and cannot be customized.
      echo "user-defined-test-1" > /etc/ilogtail/user_defined_id 
    2. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet cible.

    3. Cliquez sur image Resources, puis sur Machine Groups.

    4. À droite de Machine Groups, cliquez sur image, puis sur Create Machine Group.

    5. Configurez les paramètres suivants et cliquez sur OK.

      • Nom du groupe de machines : le nom doit être unique au sein du projet. Il doit comporter entre 3 et 128 caractères, commencer et se terminer par une lettre minuscule ou un chiffre, et contenir uniquement des lettres minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_).

      • Machine Group Identifier: Sélectionnez Custom Identifier.

      • Identifiant personnalisé : saisissez l'identifiant personnalisé configuré. Il doit correspondre à la chaîne personnalisée figurant dans le fichier d'identifiant personnalisé sur le serveur. Dans cet exemple, la valeur est user-defined-test-1.

  6. Une fois le groupe de machines créé, cliquez dessus dans la liste des groupes de machines. Dans le panneau d'état du groupe de machines, vérifiez l'état Heartbeat. Si l'état est FAIL, attendez environ deux minutes et actualisez la page. Un état OK signifie que la création a réussi.

  7. Après l'installation, créez une configuration de collecte pour collecter les journaux.

Installation de LoongCollector par lots

  • La fonction d'installation automatique permet de sélectionner plusieurs instances ECS lorsque les instances et le projet se trouvent dans le même compte et la même région.

  • Dans les autres scénarios, utilisez ECS Cloud Assistant pour exécuter des commandes en tant que tâches temporaires. Cela vous permet d'exécuter les commandes d'installation de LoongCollector par lots sur les instances ECS.

    Pour les commandes de téléchargement et d'installation, reportez-vous aux scénarios d'installation décrits précédemment. Pour savoir comment utiliser ECS Cloud Assistant, consultez la rubrique Créer et exécuter des commandes.

Mise à niveau et restauration

Important

LoongCollector s'arrête pendant une mise à niveau et redémarre automatiquement une fois celle-ci terminée. La mise à niveau écrase uniquement les fichiers nécessaires. Les fichiers de configuration et les fichiers de point de contrôle sont conservés afin de garantir qu'aucun journal n'est perdu pendant la mise à niveau.

Mise à niveau de LoongCollector ou migration de Logtail vers LoongCollector

  1. Exécutez la commande de téléchargement sur le serveur pour obtenir le dernier package d'installation. Dans l'exemple de code, remplacez ${region_id} par un ID de région tel que cn-hangzhou. Pour accélérer le téléchargement du package, consultez les Régions et remplacez ${region_id} par la région où se trouve votre instance ECS.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Exécutez la commande de mise à niveau. Utilisez la commande upgrade pour effectuer la mise à niveau. Si vous utilisez la commande install , une installation par écrasement est effectuée et votre configuration d'origine sera perdue.

    chmod +x loongcollector.sh; sudo ./loongcollector.sh upgrade;
  3. Si les informations suivantes s'affichent, la mise à niveau a réussi.

    Upgrade loongcollector files successfully.
    Starting loongcollector ...
    Upgrade loongcollector successfully.

Restauration de LoongCollector vers Logtail

Remarque

Téléchargez à nouveau le script logtail.sh. N'utilisez pas la version précédente du script.

  1. Exécutez la commande de téléchargement sur le serveur pour obtenir le package d'installation. Dans l'exemple de code, remplacez ${region_id} par un ID de région tel que cn-hangzhou. Pour accélérer le téléchargement du package, consultez les Régions et remplacez ${region_id} par la région où se trouve votre instance ECS.

    wget https://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 
  2. Exécutez la commande de restauration. Pour spécifier une version, telle que 1.8.7, reportez-vous à la ligne commentée et remplacez le numéro de version selon vos besoins.

    chmod +x logtail.sh; sudo ./logtail.sh upgrade;
    #chmod +x logtail.sh; sudo ./logtail.sh upgrade -v 1.8.7;

Installation d'une version spécifique

Utilisez le paramètre -v pour installer une version spécifique. Reportez-vous aux commandes suivantes et remplacez le numéro de version selon vos besoins.

  • LoongCollector

    chmod +x loongcollector.sh; sudo ./loongcollector.sh install ${region_id} -v 3.2.6;
  • Logtail

    chmod +x logtail.sh; sudo ./logtail.sh install ${region_id} -v 1.8.7;

Désinstallation de LoongCollector

  1. Dans l'exemple de code, remplacez ${region_id} par un ID de région tel que cn-hangzhou. Pour accélérer l'exécution, consultez les Régions et remplacez ${region_id} par la région où se trouve votre instance ECS.

    wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh -O loongcollector.sh;
  2. Exécutez la commande de désinstallation.

    chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall;

Foire aux questions

Installation de LoongCollector sur un serveur sans connexion Internet

  1. Sur le serveur où vous souhaitez installer LoongCollector, exécutez uname -m pour vérifier l'architecture du système. Ensuite, sur un serveur disposant d'un accès Internet, exécutez la commande de téléchargement correspondante. Remplacez ${region_id} par l'ID de région de votre projet.

    • Architecture ARM :

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;
    • Architecture x86-64 :

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;
  2. Copiez le script d'installation et le package téléchargés sur le serveur où vous souhaitez installer LoongCollector. Ensuite, exécutez la commande suivante. Remplacez ${region_id} par l'ID de région de votre projet.

    chmod +x loongcollector.sh; ./loongcollector.sh install-local ${region_id}-internet
  3. Exécutez la commande d'état. Si la sortie est loongcollector is running, LoongCollector a démarré avec succès.

    sudo /etc/init.d/loongcollectord status
  4. Étant donné que le serveur ne peut pas accéder à Internet, vous devez également établir une connexion en configurant un proxy.

Mise à niveau de LoongCollector sur un serveur sans connexion Internet

  1. Sur le serveur où vous souhaitez mettre à niveau LoongCollector, exécutez uname -m pour vérifier l'architecture du système. Ensuite, sur un serveur disposant d'un accès Internet, exécutez la commande correspondante. Remplacez ${region_id} par la région de votre projet.

    • Architecture ARM :

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/aarch64/main/loongcollector-linux64.tar.gz;
    • Architecture x86-64 :

      wget https://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/loongcollector.sh;wget http://aliyun-observability-release-${region_id}.oss-${region_id}.aliyuncs.com/loongcollector/linux64/latest/x86_64/main/loongcollector-linux64.tar.gz;
  2. Copiez le script d'installation et le package sur le serveur où vous souhaitez mettre à niveau LoongCollector. Ensuite, exécutez la commande suivante :

    chmod +x loongcollector.sh;./loongcollector.sh upgrade-local;

L'installation en un clic échoue

L'installation automatique est prise en charge uniquement lorsque l'instance ECS et le projet se trouvent dans le même compte et la même région. Si ce n'est pas votre cas, utilisez une autre méthode d'installation. Si votre configuration répond à cette exigence, vérifiez que vous avez satisfait aux exigences en matière d'autorisations et de réseau. Pour plus d'informations, consultez les Prérequis.

Résolution d'un heartbeat manquant ou défaillant

Si l'état du heartbeat est FAIL, cela peut être dû au temps nécessaire à l'établissement de la connexion initiale. Attendez environ deux minutes, puis actualisez l'état. Si l'état est toujours FAIL, suivez ces étapes pour résoudre le problème :

  • Confirmez la relation entre le serveur et le projet SLS. La procédure d'installation varie en fonction de cette relation.

    • Si vous avez utilisé la mauvaise procédure, exécutez la commande chmod +x loongcollector.sh; sudo ./loongcollector.sh uninstall; sur le serveur pour désinstaller. Ensuite, répétez l'installation en utilisant la procédure correcte.

  • Si vous avez utilisé la procédure correcte mais que l'état du heartbeat est toujours FAIL, vérifiez le serveur sur lequel LoongCollector est installé. Vérifiez que la valeur region dans le fichier /usr/local/ilogtail/ilogtail_config.json correspond à l'ID de région de votre projet SLS.

    • S'ils ne correspondent pas, remplacez ${region_id} dans la commande d'installation par l'ID de région correct et exécutez à nouveau la commande. LoongCollector mettra à jour le fichier.

      Cette action écrase l'installation existante et supprime vos configurations d'origine. Utilisez cette méthode avec prudence sur les serveurs déjà configurés pour la collecte.
    • Si les informations sont correctes, ou si l'état du heartbeat est toujours FAIL après la réinstallation, passez à l'étape suivante.

  • Si votre procédure implique un scénario intercomptes nécessitant un fichier d'ID utilisateur, vérifiez les points suivants :

    • L'ID utilisateur doit être l'ID du compte racine. Si ce n'est pas le cas, modifiez-le.

    • L'ID du compte racine doit appartenir au compte propriétaire du projet SLS, et non au compte propriétaire du serveur ECS.

  • Vérifiez l'identifiant personnalisé configuré pour le groupe de machines dans la console SLS. Assurez-vous qu'il correspond au contenu du fichier d'identifiant personnalisé sur le serveur. S'ils ne correspondent pas, modifiez soit la configuration de la console, soit le fichier pour les rendre identiques.

  • Si l'état du heartbeat est toujours FAIL, vérifiez que vous avez satisfait aux exigences réseau. Pour plus d'informations, consultez les Prérequis.

Références connexes

Régions

  1. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet cible.

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

  3. Dans la section Informations de base, consultez le nom de la région du projet actuel. Consultez le tableau ci-dessous pour connaître l'ID de région correspondant.

    Une région représente l'emplacement géographique d'un centre de données physique pour les ressources cloud. Un ID de région est l'identifiant unique d'une région de service cloud.

Tableau de correspondance entre les régions et les ID de région

Nom de la région

ID de région

Chine (Qingdao)

cn-qingdao

Chine (Pékin)

cn-beijing

Chine (Zhangjiakou)

cn-zhangjiakou

Chine (Hohhot)

cn-huhehaote

Chine (Ulanqab)

cn-wulanchabu

Chine (Hangzhou)

cn-hangzhou

Chine (Shanghai)

cn-shanghai

Chine (Nanjing) - Région locale - Mise hors service

cn-nanjing

Chine (Fuzhou) - Région locale - Mise hors service

cn-fuzhou

Chine (Shenzhen)

cn-shenzhen

Chine (Heyuan)

cn-heyuan

Chine (Guangzhou)

cn-guangzhou

Philippines (Manille)

ap-southeast-6

Corée du Sud (Séoul)

ap-northeast-2

Malaisie (Kuala Lumpur)

ap-southeast-3

Japon (Tokyo)

ap-northeast-1

Thaïlande (Bangkok)

ap-southeast-7

Chine (Chengdu)

cn-chengdu

Singapour

ap-southeast-1

Indonésie (Jakarta)

ap-southeast-5

Chine (Hong Kong)

cn-hongkong

Allemagne (Francfort)

eu-central-1

États-Unis (Virginie)

us-east-1

États-Unis (Silicon Valley)

us-west-1

Royaume-Uni (Londres)

eu-west-1

Émirats arabes unis (Dubaï)

me-east-1

Arabie saoudite (Riyad)

me-central-1

Types de transfert réseau de LoongCollector

Un endpoint est le nom de domaine d'accès pour SLS. Il s'agit de l'URL utilisée pour accéder à un projet et à ses données de journaux. L'endpoint est spécifique à la région où se trouve le projet. SLS fournit des endpoints privés, des endpoints publics et des endpoints d'accélération de transfert. Consultez les endpoints comme suit :

  1. Connectez-vous à la console SLS. Dans la liste des projets, cliquez sur le projet cible.

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

  3. Dans la section Points de terminaison d'accès, consultez les informations sur l'endpoint pour le projet actuel. Différentes méthodes de transfert réseau correspondent à différents endpoints. Le choix de la bonne méthode de transfert réseau permet de garantir une transmission des données de journaux plus rapide et plus stable.

Type de réseau

Type d'endpoint correspondant

Description

Scénarios

Réseau interne Alibaba Cloud

Endpoint privé

Le réseau interne Alibaba Cloud est un réseau partagé gigabit. Le transfert des données de journaux via le réseau interne est plus rapide et plus stable que via Internet public. Le réseau interne comprend le VPC et le réseau classique.

L'instance ECS et le projet SLS se trouvent dans la même région, ou vous avez connecté votre serveur sur site au réseau interne.

Remarque

Créez un projet SLS dans la même région que votre instance ECS. Cela vous permet de collecter les journaux de l'instance ECS via le réseau interne Alibaba Cloud sans consommer de bande passante publique.

Internet public

Endpoint public

Lorsque vous transférez des données de journaux via Internet public, la vitesse et la stabilité de la collecte des données peuvent être affectées par les limites de bande passante, les fluctuations du réseau, la latence et la perte de paquets.

Transférez les données via Internet public dans les deux cas suivants.

  • L'instance ECS et le projet SLS se trouvent dans des régions différentes.

  • Le serveur est hébergé par un autre fournisseur cloud ou dans votre centre de données sur site.

Accélération de transfert

Endpoint d'accélération de transfert

L'utilisation des nœuds périphériques CDN d'Alibaba Cloud pour accélérer la collecte des journaux offre des avantages significatifs en termes de latence réseau et de stabilité par rapport à la collecte via Internet public, mais le trafic engendre des frais supplémentaires.

Si votre serveur d'application et votre projet SLS se trouvent respectivement dans des régions chinoises et internationales, le transfert de données via Internet public peut entraîner une latence élevée et une instabilité. Utilisez l'accélération de transfert pour transférer les données dans ce cas. Pour plus d'informations, consultez la rubrique Accélération de transfert.