Tous les produits
Search
Centre de documentation

Simple Log Service:Installer, exécuter, mettre à niveau et désinstaller Logtail

Dernière mise à jour :Aug 25, 2026

Installez le client Logtail sur chaque serveur cible avant d'utiliser un projet Simple Log Service pour collecter les journaux du serveur. Cette rubrique explique comment installer, démarrer, arrêter, mettre à niveau et désinstaller Logtail dans les environnements serveur et conteneur.

Vue d'ensemble

Logtail est utilisé dans l'un des deux scénarios suivants, selon le type de serveur cible :

  • pour les environnements informatiques traditionnels tels que les serveurs physiques et les instances Elastic Compute Service (ECS).

  • pour les charges de travail déployées sur une plateforme de conteneurs Kubernetes.

    Choisissez la solution qui correspond à l'environnement d'exécution de vos serveurs. La procédure et les exigences de configuration diffèrent entre les deux scénarios. Dans un déploiement hybride, effectuez l'installation et la configuration pour chaque environnement séparément.

Serveurs

Installer Logtail

Vous pouvez installer Logtail de deux manières : installation en un clic ou installation manuelle. Simple Log Service prend en charge l'installation en un clic uniquement lorsque vous utilisez des instances ECS et que les instances ainsi que le projet appartiennent au même compte Alibaba Cloud et résident dans la même région. Dans tous les autres cas, installez Logtail manuellement.

Installation en un clic

Simple Log Service peut installer Logtail sur une instance ECS en un seul clic. L'installation s'appuie sur la capacité d'orchestration de CloudOps Orchestration Service (OOS), de sorte que vous n'avez pas besoin de vous connecter à l'instance ECS et d'exécuter manuellement les étapes d'installation. Si vous vous connectez avec un compte Alibaba Cloud, vous disposez par défaut de toutes les autorisations requises et pouvez effectuer les opérations directement.

Si vous vous connectez en tant qu'utilisateur RAM, demandez au propriétaire du compte Alibaba Cloud de vous accorder les autorisations nécessaires pour gérer les ressources OOS. Le propriétaire du compte peut utiliser une politique système ou une politique personnalisée pour créer un utilisateur RAM et lui accorder des autorisations :

  • Politiques système :

    • AliyunOOSFullAccess : accorde des autorisations complètes pour gérer CloudOps Orchestration Service (OOS).

    • AliyunECSFullAccess : accorde des autorisations pour gérer ECS.

  • Politiques personnalisées : si vous avez des exigences strictes en matière de sécurité des données, vous pouvez créer une politique personnalisée pour une autorisation granulaire. La politique suivante accorde des autorisations pour gérer les ressources OOS :

{
    "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": "*"
        }
    ]
}

Pour installer Logtail sur une instance ECS et créer et configurer un groupe de machines simultanément, procédez comme suit :

  1. Connectez-vous à la console Simple Log Service. Cliquez sur le projet qui gère vos ressources de journal pour afficher la liste des LogStores. Cliquez sur l'icône imageimage située avant le nom du LogStore qui stocke les journaux pour le développer, cliquez sur l'icône imageimage qui apparaît après Data Collection, sélectionnez un modèle de journal texte dans la boîte de dialogue, puis cliquez sur Integrate Now.

    Simple Log Service propose plusieurs modèles de journaux texte, tels que les modèles d'expression régulière, de ligne unique et de lignes multiples. Les modèles ne diffèrent que par leurs plug-ins d'analyse des journaux. Toutes les autres configurations sont identiques. Vous pouvez également ajouter ou supprimer des plug-ins d'analyse des journaux dans 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 selon les caractéristiques de vos journaux.

  2. Sur la page Machine Group Configurations, sélectionnez Servers et ECS comme environnement d'installation, puis cliquez sur Create Machine Group.

  3. Dans le panneau Create Machine Group, sélectionnez une ou plusieurs instances ECS qui résident dans la même région que le projet, cliquez sur Install and Create Machine Group, attendez la fin de l'installation, spécifiez le Name du groupe de machines, puis cliquez sur OK.

    Si l'installation échoue ou reste en attente, vérifiez si les instances ECS résident dans la même région que le projet.

  4. Après l'installation, accédez à la page Resources > Machine Groups en cliquant sur l'icône imageimage, cliquez sur le groupe de machines que vous avez créé et vérifiez l'état du Heartbeat dans la section Machine Group Configurations > Machine Group Status. Un état de heartbeat OK indique que le groupe de machines a été créé.

Installation manuelle

Sélectionnez une méthode de téléchargement et d'installation de Logtail en fonction du système d'exploitation et de l'architecture CPU de votre serveur.

Dans l'exemple de code, ${region_id} représente la région où réside le projet Simple Log Service. Remplacez-le par l'ID de région réel en consultant les Régions prises en charge. Par exemple, l'ID ${region_id} pour Chine (Hangzhou) est cn-hangzhou.

Avant d'installer Logtail, tenez compte des éléments suivants :

  • Compatibilité Logtail 2.0 : si votre machine a des spécifications faibles ou exécute un ancien système d'exploitation, Logtail 2.0 peut entraîner des problèmes de compatibilité empêchant le logiciel de fonctionner correctement. Dans ce cas, nous vous recommandons de télécharger la version 1.8.7 depuis https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/1.8.7/logtail.sh et d'exécuter la commande ./logtail.sh install ${region_id} -v 1.8.7 pour l'installer.

Linux

  • Les versions suivantes de serveurs Linux x86-64 (64 bits) sont prises en charge. - Alibaba Cloud Linux 2 et 3

    • Anolis OS 7 et 8 - CentOS Linux 6, 7 et 8 - Debian GNU/Linux 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,0 - Autres systèmes d'exploitation Linux basés sur glibc 2,5 ou ultérieur. Logtail 2.0 ou ultérieur nécessite glibc 2,6 ou ultérieur.

    • Le processeur doit prendre en charge les jeux d'instructions sse4_2 et avx pour Logtail 2.0 ou ultérieur. - Les versions suivantes de serveurs Linux ARM (64 bits) sont prises en charge. - Alibaba Cloud Linux 3.2 pour ARM - Anolis OS 8.2 pour ARM ou ultérieur - 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 CPU minimale requise est ARMv8.2-A pour Logtail 2.0 ou ultérieur.

Serveurs pouvant accéder à Internet (ARM et x86-64)

Pour les serveurs pouvant accéder à Internet, téléchargez Logtail directement :

# Download over an internal network
wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 
# Download over the internet
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;

Sélectionnez une commande d'installation en fonction de vos conditions réseau :

# Install over the internet.
chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
# Install over an internal network. This method applies to on-premises data centers that are connected to an internal network.
chmod +x logtail.sh; ./logtail.sh install ${region_id}

Serveurs ARM hors ligne

Pour les serveurs hors ligne, téléchargez d'abord le script d'installation et le package d'installation sur un serveur pouvant accéder à Internet :

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz

Copiez le script d'installation et le package d'installation sur le serveur sur lequel vous souhaitez installer Logtail, puis sélectionnez une commande d'installation en fonction de vos conditions réseau :

# Install over the internet.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration

Serveurs x86-64 hors ligne

Pour les serveurs hors ligne, téléchargez d'abord le script d'installation et le package d'installation sur un serveur pouvant accéder à Internet :

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz

Copiez le script d'installation et le package d'installation sur le serveur sur lequel vous souhaitez installer Logtail, puis sélectionnez une commande d'installation en fonction de vos conditions réseau :

# Install over the internet.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration

Windows

Remarque

> - Sur Microsoft Windows Server 2008 et Microsoft Windows 7, vous pouvez installer Logtail sur la version x86 ou x86_64. > - Sur les autres systèmes d'exploitation Windows, vous ne pouvez installer Logtail que sur la version x86_64.

Les versions Windows suivantes sont prises en charge : - Microsoft Windows Server 2008, 2012, 2016, 2019, 2022 et 2025 - Microsoft Windows 7 - Microsoft Windows 10 - Microsoft Windows Server Version 1909 - Microsoft Windows Server Version 2004

Téléchargez le package d'installation correspondant à l'architecture de votre serveur et à la région de votre projet :

Architecture

Région du projet

Package d'installation

32 bits

Régions en Chine continentale

Package d'installation Logtail 32 bits : https://logtail-release.oss-cn-hangzhou.aliyuncs.com/win/win32/1.6.1.0/logtail_installer.zip

32 bits

Régions hors de Chine continentale

Package d'installation Logtail 32 bits : https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/win/win32/1.6.1.0/logtail_installer.zip

64 bits

Régions en Chine continentale

Package d'installation Logtail 64 bits : https://logtail-release.oss-cn-hangzhou.aliyuncs.com/win/win64/1.6.1.0/logtail_installer.zip

64 bits

Régions hors de Chine continentale

Package d'installation Logtail 64 bits : https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/win/win64/1.6.1.0/logtail_installer.zip

Extrayez le package d'installation, exécutez Windows PowerShell en tant qu'administrateur et accédez au répertoire logtail_installer, qui correspond au répertoire dans lequel vous avez extrait le package d'installation. Sélectionnez une commande d'installation en fonction de vos conditions réseau :

# Install over the internet.
.\logtail_installer.exe install ${region_id}-internet
# If your servers are in on-premises data centers outside the Chinese mainland or are provided by cloud vendors outside the Chinese mainland, data transfer over the internet may cause high network latency and unstable transfer. We recommend that you use transfer acceleration to transfer data.
.\logtail_installer.exe install ${region_id}-acceleration

Installer Logtail par lots

Vous pouvez installer Logtail par lots de l'une des deux manières suivantes :

  • Orchestration OOS : s'applique aux scénarios ayant des exigences en matière d'autorisations. Cette méthode prend en charge une concurrence élevée et convient aux opérations par lots à grande échelle. Pour plus d'informations, consultez Utiliser OOS pour installer ou mettre à niveau Logtail par lots.

  • ECS Cloud Assistant : simple à utiliser. Vous exécutez une commande pour effectuer une tâche ponctuelle.

    Pour installer Logtail par lots à l'aide d'ECS Cloud Assistant, procédez comme suit :

  1. Console ECS - Cloud Assistant,Dans le coin supérieur gauche de la page, sélectionnez une région et un groupe de ressources.

  2. Dans le panneau Create Command, saisissez la commande d'installation dans le champ Command Content. Cet exemple utilise l'installation via Internet.

    La commande d'installation suivante est utilisée dans cet exemple :

    #!/bin/bash
    region_id='cn-hangzhou'
    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh
    chmod +x logtail.sh
    ./logtail.sh install ${region_id}-internet

    Comment mettre à jour la configuration du groupe de machines après avoir fait passer une instance ECS du réseau classique à un VPC ?.

  3. Dans la section Select Instances, confirmez que l'état de l'agent des instances de destination est Normal. Si l'état est anormal, consultez Installer l'agent Cloud Assistant pour terminer l'installation de Cloud Assistant. Sélectionnez les instances de destination et cliquez sur Execute. L'état d'exécution passe alors à Execution Succeeded. Si l'exécution échoue, consultez Afficher les résultats d'exécution et résoudre les problèmes courants.

Démarrer et arrêter Logtail

Linux

Démarrer Logtail

sudo /etc/init.d/ilogtaild start

Arrêter Logtail

sudo /etc/init.d/ilogtaild stop

Windows

  1. Connectez-vous au serveur cible.

  2. Choisissez Start > Control Panel > Tools > Service.

  3. Dans la boîte de dialogue Service, recherchez le service requis.

    • Pour la version 0.x.x.x, sélectionnez le service LogtailWorker.

    • Pour la version 1.0.0.0 ou ultérieure, sélectionnez le service LogtailDaemon.

  4. Cliquez avec le bouton droit sur le service et sélectionnez l'opération requise, telle que Start, Stop ou Restart.

Vérifier l'état et la version de Logtail

Linux

Vérifier l'état de Logtail sous Linux

Exécutez la commande sudo /etc/init.d/ilogtaild status pour vérifier l'état de Logtail. Si le système renvoie ilogtail is running, Logtail est installé. Si Logtail n'est pas en cours d'exécution, désinstallez-le, puis réinstallez-le.

Vérifier la version de Logtail sous Linux

Logtail stocke ses informations de version dans le champ logtail_version du fichier /usr/local/ilogtail/app_info.json. Exécutez la commande suivante pour afficher les informations de version de Logtail.

cat /usr/local/ilogtail/app_info.json

Le résultat suivant est renvoyé :

{
   "logtail_version" : "0.16.30",
}

Windows

Vérifier l'état de Logtail sous Windows

Vérifiez l'état de Logtail pour déterminer si Logtail est installé sur le serveur cible.

  1. Ouvrez la fenêtre Exécuter, saisissez services.msc et ouvrez la fenêtre Services.

  2. Vérifiez l'état d'exécution du service LogtailDaemon, qui s'applique à Logtail 1.0.0.0 ou ultérieur, ou du service LogtailWorker, qui s'applique à Logtail 0.x.x.x.

    Un état Running indique que Logtail est installé.

Vérifier la version de Logtail sous Windows

Vous pouvez vérifier la version de Logtail dans le champ logtail_version du fichier app_info.json situé dans le chemin d'installation.

Par exemple, le contenu suivant indique que la version de Logtail est 1.0.0.0.

{
    "logtail_version" : "1.0.0.0"
}

Mettre à niveau Logtail

Linux

Avant de mettre à niveau Logtail sur un serveur Linux, tenez compte des éléments suivants :

  • Commande de mise à niveau : pour mettre à niveau Logtail, utilisez la commande upgrade. Si vous utilisez la commande install, une installation par écrasement est effectuée et les configurations d'origine sont perdues.

  • Interruption de service : pendant la mise à niveau, Logtail s'arrête brièvement. Une fois la mise à niveau terminée, Logtail démarre automatiquement et est enregistré comme élément de démarrage. La mise à niveau écrase uniquement les fichiers requis. Les fichiers de configuration et les fichiers de point de contrôle sont conservés, ce qui garantit qu'aucun journal n'est perdu pendant la mise à niveau.

    Dans l'exemple de code, ${region_id} représente la région où réside le projet Simple Log Service. Remplacez-le par l'ID de région réel en consultant les Régions prises en charge. Par exemple, l'ID ${region_id} pour Chine (Hangzhou) est cn-hangzhou.

Sélectionnez une méthode de mise à niveau de Logtail dans le tableau suivant :

Architecture

Méthode de téléchargement

Méthode de mise à niveau

ARM et x86-64

Pour les serveurs pouvant accéder à Internet : wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh;

Une fois le téléchargement terminé, exécutez la commande de mise à niveau suivante : chmod +x logtail.sh; sudo ./logtail.sh upgrade;

ARM

Pour les serveurs hors ligne, téléchargez d'abord le script d'installation et le package d'installation sur un serveur pouvant accéder à Internet : wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz;

Copiez le script d'installation et le package d'installation sur le serveur sur lequel vous souhaitez mettre à niveau Logtail, puis exécutez la commande de mise à niveau suivante : chmod +x logtail.sh; ./logtail.sh upgrade-local;

x86-64

Pour les serveurs hors ligne, téléchargez d'abord le script d'installation et le package d'installation sur un serveur pouvant accéder à Internet : wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz;

Copiez le script d'installation et le package d'installation sur le serveur sur lequel vous souhaitez mettre à niveau Logtail, puis exécutez la commande de mise à niveau suivante : chmod +x logtail.sh; ./logtail.sh upgrade-local;

Les informations suivantes indiquent que la mise à niveau a réussi.

stop successfully
Stop logtail successfully.
Upgrading logtail files ...
Upgrade logtail files successfully.
Starting logtail ...
ilogtail is running
Upgrade logtail successfully.
{
        "UUID" : "XXXXXXXX-XXXX",
        "compiler" : "GCC 9.3.1",
        "hostname" : "xxx",
        "instance_id" : "XXXXXXXX-XXXX_172.16.0.75_1730950372",
        "ip" : "172.16.0.75",
        "logtail_version" : "2.0.8",
        "os" : "Linux; 5.10.134-13.an8.x86_64; #1 SMP Mon Jan 9 10:39:46 CST 2023; x86_64",
        "update_time" : "2024-11-07 11:32:52"
}

Windows

La procédure de mise à niveau est identique à la procédure d'installation. Téléchargez et extrayez le dernier package d'installation, puis effectuez les étapes d'installation.

Important
  • Une mise à niveau équivaut à une désinstallation et une réinstallation automatiques. Le contenu du répertoire d'installation d'origine est supprimé. Sauvegardez vos données avant d'effectuer la mise à niveau.

  • Sur un système d'exploitation Windows 64 bits, pour mettre à niveau un Logtail 32 bits vers un Logtail 64 bits, vous devez d'abord désinstaller le Logtail 32 bits, puis installer le Logtail 64 bits.

Désinstallation de Logtail

Linux

Récupérez l'identifiant ${region_id} de la région où réside votre projet Simple Log Service. Remplacez ${region_id} par la valeur appropriée, puis exécutez la commande suivante pour désinstaller Logtail.

Pour connaître l'identifiant ${region_id} de chaque région, consultez la page Régions prises en charge. Par exemple, l'identifiant ${region_id} de la région Chine (Hangzhou) est cn-hangzhou.

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall

Windows

Exécutez Windows PowerShell ou l'invite de commandes (cmd) en tant qu'administrateur, accédez au répertoire logtail_installer (le dossier dans lequel vous avez extrait le package d'installation), puis exécutez la commande suivante.

.\logtail_installer.exe uninstall

Une fois la désinstallation terminée, le répertoire d'installation de Logtail est supprimé, mais certaines configurations sont conservées dans le répertoire C:\LogtailData. Vous pouvez les supprimer manuellement si nécessaire. Les informations conservées incluent :

  • checkpoint : stocke les informations de point de contrôle de tous les plug-ins Logtail. Ce fichier n'existe que si vous utilisez des plug-ins Logtail.

  • user_config.d : répertoire contenant les configurations de collecte locales. Les fichiers avec l'extension .json sont considérés comme des configurations de collecte. Le format est similaire à /usr/local/ilogtail/user_log_config.json.

  • logtail_check_point : stocke les informations de point de contrôle du composant principal Logtail.

  • users : contient les fichiers d'identifiant utilisateur que vous avez configurés.

Scénarios de conteneurs

Installation du composant Logtail

Si vous utilisez un cluster ACK appartenant au même compte Alibaba Cloud que Simple Log Service, suivez la procédure d'installation pour les clusters ACK. Si vous utilisez un cluster autogéré ou un cluster ACK appartenant à un compte Alibaba Cloud différent de celui de Simple Log Service, suivez la procédure d'installation pour les clusters autogérés.

Clusters ACK

Cette opération s'applique uniquement aux clusters Kubernetes dédiés et aux clusters Kubernetes managés.

Installation du composant Logtail sur un cluster ACK existant

  1. Connectez-vous à la console Container Service

  2. Sur la page Clusters, choisissez More > Operations > Add-ons dans la colonne la plus à droite du cluster cible.

  3. Dans l'onglet Logs and Monitoring, localisez logtail-ds et cliquez sur Install.

    Une fois l'installation terminée, Simple Log Service crée automatiquement un projet nommé k8s-log-${your_k8s_cluster_id}.

Installation du composant Logtail lors de la création d'un cluster ACK

  1. Connectez-vous à la console Container Service

  2. Dans le volet de navigation de gauche, cliquez sur Clusters.

  3. Sur la page Clusters, cliquez sur Create Cluster.

  4. À l'étape de configuration Component Configurations, sélectionnez Enable Log Service.

Remarque

Cette section décrit uniquement les étapes clés pour activer Simple Log Service. Pour plus d'informations sur la création d'un cluster, consultez la rubrique Créer un cluster ACK managé.

Après avoir sélectionné Enable Log Service, un message vous invite à créer un projet. Pour comprendre comment Simple Log Service organise les journaux, reportez-vous à la rubrique Projet. Vous pouvez créer un projet de deux manières :

  • Select Project : permet de sélectionner un projet existant pour gérer les journaux de conteneurs collectés.

  • Create Project : Simple Log Service crée automatiquement un projet pour gérer les journaux de conteneurs collectés. L'identifiant ClusterID correspond à l'identifiant unique du cluster Kubernetes que vous créez.

    Dans la section Log Service, sélectionnez Enable Log Service. Lorsque vous choisissez Create a new project, le système crée automatiquement un projet nommé k8s-log-{ClusterID}.

Une fois l'installation terminée, les ressources Simple Log Service suivantes sont automatiquement créées dans le projet sélectionné.

Type de ressource

Nom de la ressource

Description

Exemple

Groupe de machines

k8s-group-${your_k8s_cluster_id}

Groupe de machines pour logtail-daemonset, principalement utilisé pour la collecte de journaux.

k8s-group-my-cluster-123

Groupe de machines

k8s-group-${your_k8s_cluster_id}-statefulset

Groupe de machines pour logtail-statefulset, principalement utilisé pour la collecte de métriques.

k8s-group-my-cluster-123-statefulset

Groupe de machines

k8s-group-${your_k8s_cluster_id}-singleton

Groupe de machines à instance unique, principalement utilisé pour certaines configurations de collecte à instance unique.

k8s-group-my-cluster-123-singleton

LogStore

config-operation-log

Stocke les journaux d'alibaba-log-controller dans le composant Logtail. Il est recommandé de ne pas créer de configurations de collecte dans ce LogStore. Vous pouvez supprimer ce LogStore ; après sa suppression, les journaux opérationnels d'alibaba-log-controller ne seront plus collectés. Ce LogStore est facturé comme un LogStore standard. Pour plus d'informations, consultez la rubrique Facturation basée sur les données écrites.

config-operation-log

Clusters autogérés

  1. Connectez-vous à votre cluster Kubernetes et sélectionnez une commande en fonction de la région pour télécharger Logtail et ses composants dépendants.

    # Regions in the Chinese mainland
    wget https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh
    # Regions outside the Chinese mainland
    wget https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh
  2. Modifiez le fichier de configuration ./alibaba-cloud-log-all/values.yaml.

    Le fichier de configuration contient les paramètres suivants :

    # ===================== Required content =====================
    # The name of the destination project.
    SlsProjectName: 
    # The region to which the project belongs.
    Region: 
    # The ID of the Alibaba Cloud account to which the project belongs. Enclose the ID in double quotation marks ("").
    AliUid: "11099"
    # The AccessKey ID and AccessKey secret of the Alibaba Cloud account or the RAM user. The AliyunLogFullAccess permission is required.
    AccessKeyID: 
    AccessKeySercret: 
    # The custom cluster ID. The ID can contain only letters, digits, and hyphens (-).
    ClusterID: 
    # ==========================================================
    # Specifies whether to enable the components related to metric collection. Valid values: true and false. Default value: true.
    SlsMonitoring: true
    # The network type. Valid values: Internet and Intranet. Default value: Internet.
    Net: Internet
    # Specifies whether the container runtime is containerd. Valid values: true and false. Default value: false.
    SLS_CONTAINERD_USED: true

    Paramètre

    Description

    SlsProjectName

    Nom du projet vers lequel Logtail transfère les journaux.

    Region

    ID de la région où réside votre projet. Par exemple, l'ID de la région Chine (Hangzhou) est cn-hangzhou.

    AliUid

    ID du compte Alibaba Cloud auquel appartient le projet. L'ID doit être entouré de guillemets doubles (""), par exemple AliUid: "11**99".

    AccessKeyID

    ID AccessKey du compte Alibaba Cloud auquel appartient le projet. Il est recommandé d'utiliser la paire de clés AccessKey d'un utilisateur RAM et d'accorder l'autorisation AliyunLogFullAccess à cet utilisateur.

    AccessKeySercret

    Secret AccessKey du compte Alibaba Cloud auquel appartient le projet. Il est recommandé d'utiliser la paire de clés AccessKey d'un utilisateur RAM et d'accorder l'autorisation AliyunLogFullAccess à cet utilisateur.

    ClusterID

    ID personnalisé du cluster. L'ID ne peut contenir que des lettres, des chiffres et des traits d'union (-). Ce paramètre correspond à ${your_k8s_cluster_id} dans les opérations ultérieures. Ne configurez pas le même ID de cluster pour différents clusters Kubernetes.

    SlsMonitoring

    Indique s'il faut activer la collecte des données de métriques du cluster. Valeurs possibles : true (par défaut) pour activer la collecte, et false pour la désactiver.

    Net

    Type de réseau utilisé par Logtail pour transférer les données. Si votre cluster n'est pas connecté au réseau interne d'Alibaba Cloud, utilisez Internet. Valeurs possibles : Internet (par défaut) pour Internet, et Intranet pour un réseau interne.

    SLS_CONTAINERD_USED

    Indique si le moteur d'exécution de conteneurs est containerd. Valeurs possibles : true si le moteur est containerd, et false (par défaut) sinon. Dans un cluster Kubernetes autogéré utilisant containerd, les journaux risquent de ne pas être collectés par Logtail si ce paramètre n'est pas activé.

  3. Installez Logtail et ses composants dépendants.

    Vous pouvez exécuter la commande echo "$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)" pour déterminer l'architecture OS-architecture de votre hôte. Le script k8s-custom-install.sh prend en charge les combinaisons OS-architecture suivantes : linux-386, linux-amd64, linux-arm, linux-arm64, linux-ppc64le, linux-s390x et darwin-amd64.

    bash k8s-custom-install.sh; kubectl apply -R -f result

    Fichier values.yaml que vous avez modifié.

Type de ressource

Nom de la ressource

Description

Exemple

Groupe de machines

k8s-group-${your_k8s_cluster_id}

Groupe de machines pour logtail-daemonset, principalement utilisé pour la collecte de journaux.

k8s-group-my-cluster-123

Groupe de machines

k8s-group-${your_k8s_cluster_id}-statefulset

Groupe de machines pour logtail-statefulset, principalement utilisé pour la collecte de métriques.

k8s-group-my-cluster-123-statefulset

Groupe de machines

k8s-group-${your_k8s_cluster_id}-singleton

Groupe de machines à instance unique, principalement utilisé pour certaines configurations de collecte à instance unique.

k8s-group-my-cluster-123-singleton

LogStore

config-operation-log

Stocke les journaux d'alibaba-log-controller dans le composant Logtail. Il est recommandé de ne pas créer de configurations de collecte dans ce LogStore. Vous pouvez supprimer ce LogStore ; après sa suppression, les journaux opérationnels d'alibaba-log-controller ne seront plus collectés. Ce LogStore est facturé comme un LogStore standard. Pour plus d'informations, consultez la rubrique Facturation basée sur les données écrites.

S.O.

État, version et adresse IP de Logtail

Exécutez la commande suivante pour vérifier l'état de Logtail.

kubectl get po -n kube-system | grep logtail

Le résultat suivant s'affiche :

NAME            READY     STATUS    RESTARTS   AGE
logtail-ds-gb92k   1/1       Running   0          2h
logtail-ds-wm7lw   1/1       Running   0          4d

Exécutez la commande suivante pour afficher des informations telles que le numéro de version et l'adresse IP de Logtail.

kubectl exec logtail-ds-gb92k -n kube-system cat /usr/local/ilogtail/app_info.json

Le résultat suivant s'affiche :

{
   "hostname" : "logtail-ds-gb92k",
   "instance_id" : "0EBB2B0E-0A3B-11E8-B0CE-0A58AC140402_172.20.4.2_1517810940",
   "ip" : "192.0.2.0",
   "logtail_version" : "0.16.2",
   "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
   "update_time" : "2021-02-05 06:09:01"
}

Mise à niveau et restauration de Logtail

  1. Avant la mise à niveau, sauvegardez les fichiers de description du composant Logtail.

    Si une latence de collecte importante existe déjà avant la mise à niveau, celle-ci peut entraîner la perte d'une petite quantité de données de journal.

    kubectl get ds -n kube-system logtail-ds -o yaml > logtail-ds.yaml
    kubectl get deployment -n kube-system alibaba-log-controller -o yaml > alibaba-log-controller.yaml
    kubectl get crd aliyunlogconfigs.log.alibabacloud.com -o yaml > aliyunlogconfigs-crd.yaml
    kubectl get cm -n kube-system alibaba-log-configuration -o yaml > alibaba-log-configuration.yaml
    kubectl get aliyunlogconfigs --all-namespaces -o yaml > aliyunlogconfigs-cr.yaml
  2. Sélectionnez une méthode de mise à niveau du composant en fonction de votre cluster. Si vous utilisez un cluster ACK appartenant au même compte Alibaba Cloud que Simple Log Service, suivez la procédure de mise à niveau pour les clusters ACK. Si vous utilisez un cluster autogéré ou un cluster ACK appartenant à un compte Alibaba Cloud différent de celui de Simple Log Service, suivez la procédure de mise à niveau pour les clusters autogérés.

Clusters ACK

Dans la plupart des cas, il est recommandé d'utiliser la méthode de mise à niveau automatique. Si vous avez modifié des paramètres, tels que les variables d'environnement, dans le DaemonSet de logtail-ds ou dans le Deployment d'alibaba-log-controller, utilisez la méthode de mise à niveau manuelle pour éviter que vos modifications ne soient réinitialisées.

Mise à niveau automatique

Important

Une mise à niveau automatique réinitialise les configurations que vous avez modifiées manuellement dans logtail-ds et alibaba-log-controller.

  1. Connectez-vous à la console Container Service.

  2. Dans l'onglet Logs and Monitoring, localisez logtail-ds et cliquez sur Upgrade.

  3. Dans la boîte de dialogue Update, cliquez sur OK.

Important

Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version de Logtail, cela signifie que la version de votre cluster Kubernetes est trop ancienne. Mettez d'abord à niveau le cluster Kubernetes ou utilisez la méthode de mise à niveau manuelle.

Après avoir effectué la mise à niveau, vous pouvez vérifier l'état des pods logtail-ds dans la console de gestion Container Service. Si tous les pods logtail-ds sont dans l'état Running, la mise à niveau a réussi.

Mise à niveau manuelle

Important

Une mise à niveau manuelle ne met pas à jour vos configurations selon la dernière version du composant Logtail ; certaines optimisations de fonctionnalités peuvent donc être indisponibles.

Une mise à niveau manuelle concerne logtail-ds et alibaba-log-controller. Dans la plupart des cas, il suffit de mettre à niveau logtail-ds pour bénéficier des capacités de collecte de la nouvelle version de Logtail. Pour obtenir les capacités de collecte fournies par le nouveau CRD Logtail, vous devez mettre à niveau alibaba-log-controller. Les étapes suivantes utilisent logtail-ds comme exemple.

  1. Connectez-vous à la console Container Service

  2. Choisissez Workloads > DaemonSets.

    Remarque

    Pour mettre à niveau alibaba-log-controller, choisissez Workloads > Deployments. Localisez ensuite alibaba-log-controller dans l'espace de noms kube-system et terminez la mise à niveau.

  3. Définissez l'Namespace sur kube-system, puis cliquez sur Edit pour logtail-ds.

  4. Vérifiez si les variables d'environnement suivantes existent.

    Si les variables d'environnement ALIYUN_LOGTAIL_CONFIG, ALIYUN_LOGTAIL_USER_ID et ALIYUN_LOGTAIL_USER_DEFINED_ID n'existent pas, votre version de Logtail est peut-être trop ancienne. Mettez à niveau Logtail.

  5. Pour Image Version, cliquez sur Select Image Version.

  6. Dans la boîte de dialogue Image Version, sélectionnez la dernière version, puis cliquez sur OK.

  7. Sur le côté droit de la page, cliquez sur Update.

    Après avoir effectué la mise à niveau, vous pouvez vérifier l'état des pods logtail-ds dans la console de gestion Container Service. Si tous les pods logtail-ds sont dans l'état Running, la mise à niveau a réussi.

Clusters autogérés

Il est recommandé d'effectuer la mise à niveau en installant la dernière version du composant Logtail. Si vous mettez uniquement à jour le numéro de version de l'image de certains composants, tels que logtail-ds ou alibaba-log-controller, la mise à niveau risque d'échouer.

Pour effectuer la mise à niveau automatique, réinstallez le composant Logtail.

Pour revenir à une version spécifique, procédez comme suit.

Remarque

Les fichiers YAML que vous avez sauvegardés avant la mise à niveau contiennent des informations redondantes. Vous devez supprimer manuellement ces informations avant de pouvoir utiliser les fichiers pour restaurer les configurations Logtail. Vous pouvez utiliser l'outil kubectl-neat pour cette opération. Les champs à supprimer sont metadata.creationTimestamp, metadata.generation, metadata.resourceVersion, metadata.uid et status.

  1. Décidez si vous souhaitez conserver les nouvelles configurations Logtail créées après la mise à niveau, en fonction de vos besoins métier.

    Si vous ne souhaitez pas les conserver, vous pouvez supprimer les nouvelles configurations Logtail créées après la mise à niveau.

  2. Supprimez les informations redondantes des fichiers de sauvegarde.

    cat logtail-ds.yaml | kubectl-neat > neat-logtail-ds.yaml
    cat alibaba-log-controller.yaml | kubectl-neat > neat-alibaba-log-controller.yaml
    cat aliyunlogconfigs-crd.yaml | kubectl-neat > neat-aliyunlogconfigs-crd.yaml
    cat alibaba-log-configuration.yaml | kubectl-neat > neat-alibaba-log-configuration.yaml
    cat aliyunlogconfigs-cr.yaml | kubectl-neat > neat-aliyunlogconfigs-cr.yaml
  3. Appliquez les fichiers de sauvegarde allégés pour restaurer les configurations Logtail.

    kubectl apply -f neat-logtail-ds.yaml
    kubectl apply -f neat-alibaba-log-controller.yaml
    kubectl apply -f neat-aliyunlogconfigs-crd.yaml
    kubectl apply -f neat-alibaba-log-configuration.yaml
    kubectl apply -f neat-aliyunlogconfigs-cr.yaml

Désinstallation du composant Logtail

Sélectionnez une méthode de désinstallation du composant en fonction de votre cluster. Si vous utilisez un cluster ACK appartenant au même compte Alibaba Cloud que Simple Log Service, suivez la procédure de désinstallation pour les clusters ACK. Si vous utilisez un cluster autogéré ou un cluster ACK appartenant à un compte Alibaba Cloud différent de celui de Simple Log Service, suivez la procédure de désinstallation pour les clusters autogérés.

Clusters ACK

  1. Connectez-vous à la console Container Service

  2. Dans l'onglet Logs and Monitoring, localisez logtail-ds et cliquez sur Uninstall.

  3. Suivez les instructions à l'écran pour cliquer sur OK et terminer la désinstallation.

Clusters autogérés

Exécutez la commande kubectl delete -R -f result pour désinstaller les composants installés, tels que logtail-ds et alibaba-log-controller.

Cette commande supprime récursivement toutes les ressources du répertoire result. Utilisez-la avec prudence si le répertoire contient d'autres ressources.

FAQ sur les clusters

Comment plusieurs clusters Kubernetes peuvent-ils partager un même projet Simple Log Service ?

Si vous souhaitez collecter les journaux de conteneurs provenant de plusieurs clusters vers le même projet Simple Log Service, conservez les mêmes paramètres d'installation que ceux utilisés lors de l'installation du composant Simple Log Service pour le premier cluster.

Comment consulter les journaux Logtail ?

Les journaux Logtail sont stockés dans le répertoire /usr/local/ilogtail/ du conteneur Logtail. Les noms de fichiers sont ilogtail.LOG et logtail_plugin.LOG.

La sortie standard du conteneur Logtail n'est pas significative. Ignorez la sortie standard suivante.

start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is running

Comment vérifier l'état des composants Simple Log Service dans un cluster Kubernetes ?

Exécutez les commandes suivantes.

kubectl get deploy alibaba-log-controller -n kube-system
kubectl get ds logtail-ds -n kube-system

alibaba-log-controller ne démarre pas. Que faire ?

Vérifiez si vous avez effectué l'installation de l'une des manières suivantes.

  • Exécutez la commande d'installation sur le nœud maître du cluster Kubernetes.

  • Saisissez votre ID de cluster dans les paramètres de la commande d'installation.

    Si l'installation a échoué pour l'une des raisons précédentes, exécutez la commande kubectl delete -f deploy pour supprimer le modèle d'installation généré, puis exécutez à nouveau la commande d'installation.

Comment vérifier l'état du DaemonSet Logtail-ds dans un cluster Kubernetes ?

Exécutez la commande kubectl get ds -n kube-system pour vérifier l'état du DaemonSet Logtail-ds.

Remarque

Par défaut, le conteneur Logtail réside dans le namespace kube-system.

Comment consulter les journaux opérationnels de Logtail ?

Les journaux opérationnels de Logtail sont stockés dans le répertoire /usr/local/ilogtail/. Le nom de fichier est ilogtail.LOG, et les fichiers archivés sont compressés et stockés sous la forme ilogtail.LOG.x.gz. Par exemple, exécutez la commande suivante pour consulter les journaux.

kubectl exec logtail-ds-gb92k -n kube-system tail /usr/local/ilogtail/ilogtail.LOG

Le résultat suivant est renvoyé :

[2018-02-05 06:09:02.168693] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:104] logtail plugin Resume:start
[2018-02-05 06:09:02.168807] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:106] logtail plugin Resume:success
[2018-02-05 06:09:02.168822] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:369] start add existed check point events, size:0
[2018-02-05 06:09:02.168827] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:511] add existed check point events, size:0 cache size:0 event size:0 success count:0

Comment redémarrer Logtail dans un pod ?

Exécutez la commande suivante pour arrêter Logtail. Dans cette commande, logtail-ds-gb92k correspond au nom du conteneur et kube-system au namespace. Remplacez-les par les valeurs réelles.

kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild stop

Le résultat suivant indique que Logtail est arrêté.

kill process Name: ilogtail pid: 7
kill process Name: ilogtail pid: 9
stop success

Exécutez la commande suivante pour démarrer Logtail. Dans cette commande, logtail-ds-gb92k correspond au nom du conteneur et kube-system au namespace. Remplacez-les par les valeurs réelles.

kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild start

Le résultat suivant indique que Logtail est démarré.

ilogtail is running