GUIDE TECHNIQUE · PROMETHEUS
Installer Prometheus et une première cible
Installer Prometheus et une cible node_exporter dans un laboratoire Docker Compose local, obtenir une première collecte puis prouver une panne et son rétablissement.
L’ESSENTIEL EN BREF
Les étapes clés
Ce guide présente 5 étapes, de « Préparer Docker et le répertoire du laboratoire » à « Constater DOWN, rétablir et nettoyer ».
Avant de commencer : Docker Engine ou Desktop installé et démarré ; plugin Docker Compose v2, Bash, curl et navigateur.
01 · CADRAGE
Périmètre et résultat visé
Résultat attendu : Le job node-lab est UP et up{job="node-lab"} vaut 1.
Public concerné : Ingénieurs DevOps, SRE, administrateurs plateforme et support N2/N3.
Environnement de référence : Docker Compose v2 ; images Prometheus 3.2.1 et node_exporter 1.9.1. Le guide porte sur un laboratoire local, sans stockage durable ni haute disponibilité.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
Docker/Compose v2 et curl ; aucune installation Prometheus préalable nécessaire ; port local 9090 libre.
- Docker Engine ou Desktop installé et démarré ; plugin Docker Compose v2, Bash, curl et navigateur.
- Accès aux images prom/prometheus et prom/node-exporter depuis le moteur Docker ; port local 9090 libre.
- Droits de création de conteneurs et de fichiers dans un répertoire personnel ; aucun serveur Prometheus préalable requis.
Votre environnement de départ
- Environnement
- Docker/Compose v2 et curl ; aucune installation Prometheus préalable nécessaire ; port local 9090 libre.
- Outils
- Navigateur, curl ; Docker Compose pour les laboratoires complets ; promtool fourni par l’image.
- Comptes et droits
- Création de conteneurs pour les parcours Compose ; édition/rechargement de la configuration pour un serveur existant.
- Réseau et accès
- Prometheus vers les endpoints /metrics ; Prometheus vers Alertmanager puis Alertmanager vers le récepteur ; ports locaux selon les fichiers fournis.
Contrôles avant de commencer
Où effectuer le contrôle : Terminal de départ
docker version
docker compose versionRésultat attendu : Les outils répondent et la cible est celle de recette ; le service sera créé dans les étapes suivantes.
03 · VUE D’ENSEMBLE
Comprendre l’architecture et les flux
04 · TUTORIEL
Procédure complète, étape par étape
Suivez les étapes dans l’ordre et contrôlez chaque résultat avant de poursuivre. Renseignez les paramètres adaptés à votre environnement.
ÉTAPE 1 / 5
Préparer Docker et le répertoire du laboratoire
La collecte a besoin d’un serveur et d’une cible distincte dont on contrôle l’état.
- Installer Docker Engine ou Docker Desktop et le plugin Compose via la documentation Docker. Exécuter ces commandes depuis un terminal Bash local.
- Vérifier que le port local 9090 est disponible ; ce laboratoire expose uniquement la console locale. Les versions des images sont indiquées dans compose.yaml.
docker version
docker compose version
mkdir -p adn-prometheus-lab
cd adn-prometheus-labÀ vérifier : Le daemon répond, Compose v2 est disponible et le répertoire de travail est adn-prometheus-lab.
Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.
ÉTAPE 2 / 5
Écrire les deux fichiers complets
Compose définit les processus ; prometheus.yml définit ce qui est collecté.
- Créer compose.yaml avec le premier bloc et prometheus.yml avec le second ; ce sont deux fichiers distincts dans adn-prometheus-lab.
- node:9100 est le nom DNS interne du service Compose, pas localhost sur le poste. Ce conteneur exporter sert de cible de disponibilité ; il ne représente pas la vue complète de l’hôte Linux.
# compose.yaml
services:
prometheus:
image: prom/prometheus:v3.2.1
ports: ["127.0.0.1:9090:9090"]
volumes:
- ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
node:
image: prom/node-exporter:v1.9.1
# prometheus.yml (fichier distinct)
global:
scrape_interval: 5s
scrape_configs:
- job_name: prometheus
static_configs:
- targets: ["localhost:9090"]
- job_name: node-lab
static_configs:
- targets: ["node:9100"]
À vérifier : Les deux fichiers existent ; node-lab pointe sur node:9100 et non sur un service supposé déjà installé.
Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.
ÉTAPE 3 / 5
Valider puis lancer la collecte
Une erreur de configuration doit être détectée avant le démarrage.
- Depuis le même répertoire, valider le modèle Compose et la configuration Prometheus avec promtool fourni dans son image.
- Lancer les deux conteneurs ; si le téléchargement échoue, vérifier réseau, proxy, architecture et tag avant toute autre étape.
docker compose -p adn-prom-lab config -q
docker compose -p adn-prom-lab run --rm --entrypoint promtool prometheus check config /etc/prometheus/prometheus.yml
docker compose -p adn-prom-lab up -d
docker compose -p adn-prom-lab psÀ vérifier : promtool annonce SUCCESS ; les services prometheus et node sont démarrés.
Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.
ÉTAPE 4 / 5
Prouver la première collecte
Un conteneur en état running ne garantit pas un scrape réussi.
- Ouvrir http://localhost:9090 puis Status > Targets : node-lab doit devenir UP après au moins un scrape.
- Dans Query, saisir up{job="node-lab"}. Vérifier une série à 1 et des échantillons récents ; l’API suivante fournit le même contrôle.
curl -fsSG http://127.0.0.1:9090/api/v1/query --data-urlencode 'query=up{job="node-lab"}'À vérifier : La réponse status=success contient une série dont la valeur est 1 pour le job node-lab.
Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.
ÉTAPE 5 / 5
Constater DOWN, rétablir et nettoyer
Le test négatif distingue une collecte fonctionnelle d’un simple écran accessible.
- Arrêter uniquement node. Attendre au moins deux scrapes et relancer la requête précédente : up vaut 0 ; Targets expose l’erreur.
- Redémarrer node, attendre le retour à 1, puis retirer ce projet Compose. down supprime ici les conteneurs et le réseau du laboratoire ; aucun volume persistant n’a été déclaré.
docker compose -p adn-prom-lab stop node
# Observer up{job="node-lab"} = 0, puis :
docker compose -p adn-prom-lab start node
# Observer up = 1 avant le nettoyage :
docker compose -p adn-prom-lab downÀ vérifier : Les transitions 1 → 0 → 1 ont été constatées ; les seules ressources adn-prom-lab sont arrêtées et retirées.
Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.
RÉFÉRENCES TECHNIQUES
Documentation officielle
Retrouvez les fonctionnalités, les paramètres et les matrices de compatibilité de Prometheus.
05 · RECETTE
Comment vérifier que tout fonctionne ?
Le job node-lab est UP et up{job="node-lab"} vaut 1.
L’arrêt de la cible fait passer up à 0, puis son redémarrage rétablit 1.
La configuration est validée par promtool et le laboratoire peut être retiré sans affecter d’autres projets.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
promtool refuse le fichier
Cause probable : Indentation ou clé YAML incorrecte
Que faire : Comparer le fichier complet au bloc fourni et relancer promtool avant démarrage.
node-lab reste DOWN
Cause probable : Le service node ne répond pas à node:9100
Que faire : Vérifier docker compose ps puis les logs des services node et prometheus.
9090 déjà occupé
Cause probable : Un autre service écoute sur ce port
Que faire : Arrêter le laboratoire précédent ou choisir un autre port local en conservant le port interne 9090.
07 · QUESTIONS PRATIQUES
Questions fréquentes
Comment reconnaître une configuration valide ?
Le fichier est accepté par promtool ; le job de recette est identifiable.
Quel contrôle prouve un fonctionnement réel ?
La cible est UP et la série up du job vaut 1 après un scrape réussi.
Que faire en cas d'échec ?
Simuler une indisponibilité dans le laboratoire uniquement, constater l'état DOWN et lire lastScrapeError. Rétablir la cible puis confirmer le retour à UP ; documenter la configuration précédente pour la reprise.
AUTRES TECHNOLOGIES
Guides complémentaires
VOTRE ENVIRONNEMENT
Besoin d’aller plus loin sur votre environnement ?
Échangeons sur votre environnement Prometheus : pratiques, sécurité et exploitation.
Découvrir nos offres d’observabilité
Échanger avec ADN Consulting