ACK Edge s'intègre à Simple Log Service pour collecter les journaux des conteneurs dans les clusters edge. Cette rubrique explique comment activer l'agent de collecte, configurer la collecte par charge de travail et vérifier la visibilité des journaux dans Simple Log Service.
Types de journaux collectés : sortie standard des conteneurs (stdout/stderr) et fichiers texte stockés dans les conteneurs.
Prérequis
Avant de commencer, assurez-vous de disposer des éléments suivants :
Un cluster ACK Edge (voir Créer un cluster ACK Edge)
Un projet Simple Log Service existant, ou les autorisations nécessaires pour en créer un automatiquement lors de la configuration du cluster
Paramètres de collecte par défaut
| Paramètre | Valeur par défaut |
|---|---|
| Mode de collecte | Mode simple (ligne par ligne) |
| Période de rétention des journaux | 180 jours |
| Création de Logstore | Créé automatiquement dans le projet associé au cluster s'il n'existe pas déjà |
Étape 1 : Activer le composant Logtail
Activez l'agent de collecte de journaux Logtail lors de la création d'un cluster, ou ajoutez-le à un cluster existant.
Activer Logtail lors de la création d'un cluster
Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.
Sur la page Clusters, cliquez sur Create Kubernetes Cluster. Cette section ne couvre que les étapes liées aux journaux. Pour la procédure complète de création de cluster, consultez Créer un cluster ACK Edge.
-
À l'étape Component Configurations, sélectionnez Enable Log Service. Après avoir choisi Enable Log Service, associez un projet pour gérer les journaux collectés. Pour plus d'informations sur l'organisation des journaux par Simple Log Service, voir Projects. Deux options s'offrent à vous :
Cliquez sur Select Project pour utiliser un projet existant.
Cliquez sur Create Project pour créer automatiquement un projet nommé
k8s-log-{ClusterID}, où{ClusterID}correspond à l'ID unique du nouveau cluster.
Cliquez sur Create Cluster en bas à droite. Dans la boîte de dialogue qui s'affiche, cliquez sur OK. Une fois le cluster créé, il apparaît sur la page Clusters avec Logtail activé.
Activer Logtail sur un cluster existant
Le nom du composant de journalisation dépend de la version du cluster :
Version ultérieure à 1.18.8-aliyunedge.1 : logtail-ds
Version 1.18.8-aliyunedge.1 ou antérieure : alibaba-log-controller et logtail-ds-docker
Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.
Sur la page Clusters, cliquez sur le nom du cluster à gérer. Dans le volet de navigation de gauche, cliquez sur Add-ons.
Sur la page Add-ons, accédez à l'onglet Logs and Monitoring et repérez le composant logtail-ds.
Cliquez sur Install. Dans la boîte de dialogue Install logtail-ds, cliquez sur OK. Si une version antérieure du composant de journalisation est déjà installée, cliquez plutôt sur Upgrade.
Étape 2 : Configurer la collecte de journaux pour une application
Il est impossible de modifier une configuration de collecte de journaux après sa création. Pour changer une configuration existante, utilisez plutôt une CRD — voir Utiliser une CRD pour collecter les journaux de conteneurs en mode DaemonSet.
Configurez la collecte de journaux lors de la création d'une nouvelle charge de travail applicative.
Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.
Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, choisissez Workloads > Deployments.
Sur la page Deployments, sélectionnez un namespace dans la liste déroulante Namespace, puis cliquez sur Create from Image en haut à droite.
Sous l'onglet Basic Information, définissez les champs Name, Replicas et Type. Cliquez sur Next pour accéder à la page Container. Cette section traite uniquement des paramètres liés aux journaux. Pour tous les autres paramètres applicatifs, voir Créer une charge de travail sans état (Deployment).
-
Dans la section Log, configurez les éléments suivants :
-
Collection Configuration : Cliquez sur Collection Configuration. Chaque configuration associe un Logstore à un chemin d'accès aux journaux dans le conteneur. Par défaut, les journaux sont collectés en mode simple (ligne par ligne). Pour le mode multiligne ou d'autres méthodes de collecte avancées, consultez Collecter les journaux texte des conteneurs en mode DaemonSet via la console et Collecter la sortie standard des conteneurs en mode DaemonSet via la console.
Logstore : Nom du Logstore où seront stockés les journaux collectés. Si le Logstore n'existe pas, ACK le crée automatiquement dans le projet Simple Log Service associé au cluster.
Log Path in Container : Chemin d'accès aux journaux à collecter. Par exemple,
/usr/local/tomcat/logs/catalina.*.logpermet de collecter les journaux texte de Tomcat. Définissez ce champ surstdoutpour collecter la sortie standard (stdout) et les erreurs standard (stderr).
Custom Tag : Cliquez sur Custom Tag pour ajouter des paires clé-valeur aux journaux collectés. Les tags personnalisés permettent d'étiqueter les données de journalisation à l'aide de métadonnées de conteneur, comme un numéro de version.
-
Cliquez sur Next en haut à droite pour continuer. Pour les étapes de configuration suivantes, voir Créer une charge de travail sans état (Deployment).
Étape 3 : Consulter les journaux
Une fois la configuration terminée, les journaux sont collectés et stockés dans Simple Log Service. L'exemple suivant montre comment afficher les journaux d'une application Tomcat créée via la console.
Connectez-vous à la console Simple Log Service.
Dans la section Projects, sélectionnez le projet associé à votre cluster. Le nom de projet par défaut est
k8s-log-{ClusterID}. Cliquez ensuite sur l'onglet Logstores.Repérez le Logstore spécifié dans la configuration de collecte. Placez le pointeur sur la partie droite du nom du Logstore, cliquez sur l'icône
, puis sélectionnez Search & Analysis. La page de requête de journaux affiche les journaux de sortie standard ainsi que les journaux texte situés dans les conteneurs de l'application. Les tags personnalisés apparaissent sous forme de champs supplémentaires dans les journaux.
Étapes suivantes
En cas de problème :
FAQ relative aux Logstores — aborde la modification de la période de rétention des journaux, la désactivation de la collecte de journaux et d'autres opérations similaires
Pour collecter d'autres types de journaux :
Collecter les journaux texte des conteneurs Kubernetes à l'aide d'un sidecar
Collecter la sortie standard des conteneurs Kubernetes en mode DaemonSet (hérité)
Pour étendre ou gérer votre configuration :
Gérer les règles d'alerte — ajoutez des règles d'alerte basées sur les journaux pour surveiller l'état du cluster
Utiliser Logtail pour collecter les journaux de conteneurs entre différents comptes Alibaba Cloud