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 :
-
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

située avant le nom du LogStore qui stocke les journaux pour le développer, cliquez sur l'icône 
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.
Sur la page Machine Group Configurations, sélectionnez Servers et ECS comme environnement d'installation, puis cliquez sur Create Machine Group.
-
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.
Après l'installation, accédez à la page Resources > Machine Groups en cliquant sur l'icône

, 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.shet d'exécuter la commande./logtail.sh install ${region_id} -v 1.8.7pour 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
> - 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 : |
|
32 bits |
Régions hors de Chine continentale |
Package d'installation Logtail 32 bits : |
|
64 bits |
Régions en Chine continentale |
Package d'installation Logtail 64 bits : |
|
64 bits |
Régions hors de Chine continentale |
Package d'installation Logtail 64 bits : |
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 :
Console ECS - Cloud Assistant,Dans le coin supérieur gauche de la page, sélectionnez une région et un groupe de ressources.
-
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 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
Connectez-vous au serveur cible.
Choisissez Start > Control Panel > Tools > Service.
-
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.
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.
Ouvrez la fenêtre Exécuter, saisissez
services.mscet ouvrez la fenêtre Services.-
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 commandeinstall, 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) estcn-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 : |
Une fois le téléchargement terminé, exécutez la commande de mise à niveau suivante : |
|
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 : |
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 : |
|
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 : |
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 : |
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.
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
Connectez-vous à la console Container Service
Sur la page Clusters, choisissez More > Operations > Add-ons dans la colonne la plus à droite du cluster cible.
-
Dans l'onglet Logs and Monitoring, localisez
logtail-dset 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
Connectez-vous à la console Container Service
Dans le volet de navigation de gauche, cliquez sur Clusters.
Sur la page Clusters, cliquez sur Create Cluster.
À l'étape de configuration Component Configurations, sélectionnez Enable Log Service.
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
ClusterIDcorrespond à 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 |
k8s-group-my-cluster-123 |
|
Groupe de machines |
k8s-group-${your_k8s_cluster_id}-statefulset |
Groupe de machines pour |
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
-
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 -
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: trueParamètre
Description
SlsProjectNameNom du projet vers lequel Logtail transfère les journaux.
RegionID de la région où réside votre projet. Par exemple, l'ID de la région Chine (Hangzhou) est
cn-hangzhou.AliUidID du compte Alibaba Cloud auquel appartient le projet. L'ID doit être entouré de guillemets doubles (""), par exemple
AliUid: "11**99".AccessKeyIDID 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.
AccessKeySercretSecret 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.
ClusterIDID 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.SlsMonitoringIndique s'il faut activer la collecte des données de métriques du cluster. Valeurs possibles :
true(par défaut) pour activer la collecte, etfalsepour la désactiver.NetType 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, etIntranetpour un réseau interne.SLS_CONTAINERD_USEDIndique si le moteur d'exécution de conteneurs est containerd. Valeurs possibles :
truesi le moteur est containerd, etfalse(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é. -
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'architectureOS-architecturede votre hôte. Le scriptk8s-custom-install.shprend en charge les combinaisonsOS-architecturesuivantes : linux-386, linux-amd64, linux-arm, linux-arm64, linux-ppc64le, linux-s390x et darwin-amd64.bash k8s-custom-install.sh; kubectl apply -R -f resultFichier
values.yamlque 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 |
k8s-group-my-cluster-123 |
|
Groupe de machines |
k8s-group-${your_k8s_cluster_id}-statefulset |
Groupe de machines pour |
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
-
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 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
Une mise à niveau automatique réinitialise les configurations que vous avez modifiées manuellement dans logtail-ds et alibaba-log-controller.
Connectez-vous à la console Container Service.
Dans l'onglet Logs and Monitoring, localisez
logtail-dset cliquez sur Upgrade.Dans la boîte de dialogue Update, cliquez sur OK.
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
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.
Connectez-vous à la console Container Service
-
Choisissez Workloads > DaemonSets.
RemarquePour 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.
Définissez l'Namespace sur kube-system, puis cliquez sur Edit pour
logtail-ds.-
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.
Pour Image Version, cliquez sur Select Image Version.
Dans la boîte de dialogue Image Version, sélectionnez la dernière version, puis cliquez sur OK.
-
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-dsdans la console de gestion Container Service. Si tous les podslogtail-dssont 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.
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.
-
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.
-
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 -
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
Connectez-vous à la console Container Service
Dans l'onglet Logs and Monitoring, localisez
logtail-dset cliquez sur Uninstall.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 deploypour 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.
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