Utilisation de Grafana

Guide d'utilisation de l'interface Grafana pour visualiser les logs.

Accès

URL : https://grafana.monitoring.lyroh.com

Explorer les Logs

1. Ouvrir l'Explore

Cliquez sur l'icône Explore (boussole) dans le menu latéral
Sélectionnez la datasource Loki

2. Construire une requête

Mode Builder (recommandé pour débuter) :

Cliquez sur Label browser
Sélectionnez les labels : app, env, host
Ajoutez des filtres de ligne

Mode Code :

{app="nestjs-backend", env="prod"} |= "error"

3. Ajuster la plage temporelle

Utilisez le sélecteur en haut à droite
Raccourcis : Last 15 minutes, Last 1 hour, Last 24 hours

Dashboards

Dashboard par défaut

Le dashboard Logs Overview est pré-configuré avec :

Distribution des logs par application
Distribution par serveur
Distribution par environnement
Timeline du volume de logs
Heatmap des erreurs
Explorateur de logs filtrable

Variables du Dashboard

Variable	Description	Exemple
`$app`	Filtrer par application	`nestjs-backend`
`$env`	Filtrer par environnement	`prod`
`$host`	Filtrer par serveur	`app-server-1`
`$search`	Recherche texte libre	`error`

Créer un nouveau Dashboard

Dashboards > New dashboard
Add visualization
Sélectionnez Loki comme datasource
Entrez votre requête LogQL
Choisissez le type de visualisation :
Logs : Affichage brut des logs
Time series : Graphiques temporels
Stat : Valeur unique
Table : Tableau de données

Types de Visualisations

Logs Panel

Idéal pour explorer les logs bruts.

{app="nestjs-backend", env="prod"}

Options utiles : - Show time : Afficher les timestamps - Show labels : Afficher les labels - Wrap lines : Retour à la ligne automatique - Deduplication : Regrouper les logs identiques

Time Series

Pour visualiser le volume de logs dans le temps.

sum by (app) (count_over_time({env="prod"} [$__interval]))

Stat Panel

Pour afficher une métrique unique.

# Nombre d'erreurs dans la dernière heure
count_over_time({env="prod"} |~ "error" [1h])

Pie Chart

Distribution par label.

sum by (app) (count_over_time({env="prod"} [1h]))

Fonctionnalités Utiles

Live Tail

Suivre les logs en temps réel :

Ouvrez Explore
Cliquez sur Live en haut à droite
Les nouveaux logs apparaissent automatiquement

Contexte des Logs

Voir les logs autour d'une entrée spécifique :

Cliquez sur une ligne de log
Cliquez sur Show context
Naviguez avant/après dans le temps

Copier un Lien

Partager une vue spécifique :

Configurez votre requête et plage temporelle
Cliquez sur Copy shortened URL
Partagez le lien

Annotations

Marquer des événements sur les graphiques :

Dashboard settings > Annotations
Ajoutez une annotation basée sur une requête Loki
Exemple : Marquer les déploiements

Raccourcis Clavier

Raccourci	Action
`Ctrl + Enter`	Exécuter la requête
`Escape`	Fermer les popups
`d`	Dashboard
`e`	Explore
`g h`	Aller à Home

Bonnes Pratiques

Sauvegardez vos requêtes fréquentes dans des dashboards
Utilisez les variables pour des dashboards réutilisables
Définissez des rafraîchissements automatiques appropriés (30s - 5m)
Organisez les dashboards en dossiers par équipe ou application