Prometheus et Grafana

Conserver un historique des mesures et explorer les tableaux de bord.

1. Préparer la stack

Depuis le clone v1.3.3 :

cd examples/monitoring

Dans ce tag, l’exemple monitoring référence encore l’agent 0.0.57. Avant de lancer, modifiez uniquement son image dans compose.yaml pour utiliser la version documentée :

image: decryptus/monit-docker:1.3.3

2. Démarrer et se connecter

sh start.sh

Le script prépare un mot de passe Grafana dans .env puis attend les services. Consultez ce fichier localement sans le partager. Ouvrez Grafana sur localhost:3000 avec le compte admin, puis Prometheus sur localhost:9090. Ces adresses concernent la machine hôte ; depuis un poste distant, utilisez un tunnel SSH.

Cette stack contient son propre agent, Prometheus et Grafana. Elle n’inclut pas l’interface légère du guide précédent et n’envoie pas de notification par défaut. Évitez deux stacks concurrentes sur les mêmes ports.

3. Vérifier les mesures

Dans Prometheus, vérifiez la cible de l’agent et essayez ces expressions :

monit_docker_ready
monit_docker_container_memory_usage_percent
monit_docker_container_cpu_usage_percent

Une cible « UP » indique que la récupération HTTP fonctionne ; contrôlez aussi monit_docker_ready. Les séries de conteneurs sont masquées si la collecte devient invalide ou périmée. Les compteurs de l’agent repartent au redémarrage.

Captures Prometheus et Grafana

Ces trois captures montrent le tableau de bord d’exemple dans Grafana 12.2.0, avec des données synthétiques pour six conteneurs fictifs. Ce sont des aperçus du rendu, pas des mesures de production ni des benchmarks. Cliquez pour agrandir ; les flèches permettent de naviguer et Échap de fermer.

4. Conserver les données

L’exemple conserve quinze jours de métriques dans un volume nommé. docker compose down arrête la stack en préservant ses volumes. L’option --volumes supprimerait les données : ne l’utilisez pas pour un simple arrêt.

Continuez avec Alertmanager et les notifications pour transformer les règles Prometheus en messages.

Le contrat API HTTP et métriques détaille les réponses, les erreurs, la fraîcheur et les exports, avec des exemples curl.

Par défaut, /metrics reste ouvert. Pour exiger une authentification, ajoutez serve --metrics-token-file FICHIER et configurez Prometheus avec le jeton Bearer correspondant. Utilisez --status-token-file pour la lecture du statut.