Consultation des logs

Apres avoir installe Kubetail, vous pouvez lancer le dashboard web avec kubetail serve ou diffuser les logs dans votre terminal avec kubetail logs.

Dashboard web (GUI)

Le dashboard web fournit une interface basee sur le navigateur pour parcourir et filtrer les logs de vos workloads Kubernetes. Lancez-le avec kubetail serve; il s’ouvrira automatiquement a http://localhost:7500. Depuis le dashboard, vous pouvez selectionner des workloads et des pods, afficher leur sortie de logs en temps reel et changer de contexte de cluster sans quitter le navigateur. Pour une presentation complete des fonctionnalites du dashboard, consultez le guide Dashboard web (GUI).

Terminal

La commande kubetail logs vous permet de recuperer et de diffuser des logs directement dans votre terminal. Vous pouvez cibler des pods individuels, des Deployments ou tout autre type de workload, et combiner plusieurs sources issues de differents namespaces dans une seule commande:

kubetail logs frontend:deployments/web backend:deployments/api

Tailing

Par defaut, kubetail logs renvoie les 10 derniers enregistrements. Utilisez --head pour lire depuis le debut, --all pour tout renvoyer, ou --follow pour diffuser en continu les nouveaux enregistrements:

# Diffuser les nouveaux enregistrements d'un Deployment
kubetail logs deployments/web --follow

# Renvoyer les 50 premiers enregistrements
kubetail logs deployments/web --head=50

# Renvoyer tous les enregistrements et continuer a suivre
kubetail logs deployments/web --all --follow

Choisir les colonnes

Le tableau de sortie inclut par defaut les colonnes timestamp et dot. Vous pouvez personnaliser l’affichage avec --columns, --add-columns ou --remove-columns. Les colonnes disponibles sont: timestamp, dot, node, region, zone, os, arch, namespace, pod, container.

# Ajouter les colonnes namespace et pod aux colonnes par defaut
kubetail logs deployments/web --add-columns pod,container

# N'afficher que les messages de log bruts, sans metadonnees
kubetail logs deployments/web --raw

Filtrer par plage de temps

Utilisez --since et --until (inclusifs) ou --after et --before (exclusifs) pour limiter les logs a une plage temporelle precise. Les horodatages ISO 8601 comme les durees sont acceptes:

# Enregistrements des 30 dernieres minutes
kubetail logs deployments/web --since PT30M --all

# Enregistrements entre deux horodatages
kubetail logs deployments/web --since 2024-01-01T00:00:00Z --until 2024-01-02T00:00:00Z --all

Filtrer par source

Utilisez --node, --zone, --region, --os et --arch pour restreindre les pods qui contribuent a la sortie. Chaque indicateur accepte une liste de valeurs separees par des virgules:

# Afficher uniquement les logs des pods executés sur un noeud specifique
kubetail logs deployments/web --node=ip-10-0-1-42

# Afficher uniquement les logs des pods situes dans une zone de disponibilite specifique
kubetail logs deployments/web --zone=us-east-1a

# Combiner les filtres
kubetail logs deployments/web --region=us-east-1 --arch=amd64

Filtrer par contenu

Utilisez --grep avec une expression reguliere pour filtrer les lignes de log:

kubetail logs deployments/web --grep "ERROR" --force --all

Remarque: l’indicateur --force est requis avec --grep, car le filtrage s’effectue cote client et pourrait donc telecharger plus de donnees que prevu.

Suivi du cycle de vie des conteneurs

Kubetail surveille en temps reel les evenements de pods Kubernetes. Lorsqu’un nouveau pod ou conteneur demarre, lors d’un rolling update, d’un redemarrage apres crash ou d’un scale-out, ses logs sont automatiquement ajoutes au flux actif. Vous n’avez pas besoin de redemarrer le flux pour voir ces changements.

Fonctionnalites avancees

Pour activer des fonctionnalites avancees qui ne sont pas disponibles dans l’API Kubernetes, par exemple la taille des fichiers de log, les horodatages du dernier evenement ou la recherche, vous pouvez installer les services en cluster de Kubetail afin d’obtenir un acces de plus bas niveau a vos fichiers de log sur disque, connus sous le nom de Kubetail API.

La Kubetail API se compose d’une instance de Kubetail Cluster API executee comme un Deployment, ainsi que d’un Kubetail Cluster Agent par noeud execute comme un DaemonSet. Le Cluster Agent est un petit programme base sur Rust qui lit directement les fichiers de log des conteneurs depuis le systeme de fichiers du noeud, puis les diffuse vers l’API a la demande. C’est particulierement utile pour filtrer les logs a grande echelle avec grep, car l’agent peut eliminer des lignes avant de les envoyer au client.

Vous pouvez gerer l’installation de la Kubetail API avec la commande kubetail cluster:

# Installer la Kubetail API dans votre cluster
kubetail cluster install

# Mettre a niveau vers la version la plus recente
kubetail cluster upgrade

# Supprimer la Kubetail API du cluster
kubetail cluster uninstall

Une fois la Kubetail API installee, Kubetail activera automatiquement les fonctionnalites avancees dans l’interface.

La commande kubetail cluster utilise Helm en interne, vous pouvez donc personnaliser l’installation avec Helm par la suite si vous le souhaitez. Si vous preferez gerer l’installation directement avec Helm, consultez la reference du chart Helm.