Aller au contenu

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.

Niveau Débutant6 min de lecture— vuesPrometheus

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 et versions

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

Commandes et configuration
docker version
docker compose version

Ré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

ARCHITECTURE TECHNIQUEComprendre la chaîne de bout en bout
01Endpoint /metrics
02Prometheus scrape
03PromQL
04Dashboard RUN
La cible expose /metrics ; Prometheus l'interroge à l'intervalle de scrape, stocke les séries puis les expose à PromQL. Une cible UP confirme la collecte, pas la pertinence métier des métriques.

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.

01

É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.

  1. Installer Docker Engine ou Docker Desktop et le plugin Compose via la documentation Docker. Exécuter ces commandes depuis un terminal Bash local.
  2. 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.
Commandes et configuration
docker version
docker compose version
mkdir -p adn-prometheus-lab
cd adn-prometheus-lab
Ce qui se passe à cette étape
1Préparer
2Préparer Docker et le répertoire du laboratoire
3Contrôler

À 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.

02

ÉTAPE 2 / 5

Écrire les deux fichiers complets

Compose définit les processus ; prometheus.yml définit ce qui est collecté.

  1. Créer compose.yaml avec le premier bloc et prometheus.yml avec le second ; ce sont deux fichiers distincts dans adn-prometheus-lab.
  2. 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.
Commandes et configuration
# 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"]
Ce qui se passe à cette étape
1Préparer
2Écrire les deux fichiers complets
3Contrôler

À 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.

03

ÉTAPE 3 / 5

Valider puis lancer la collecte

Une erreur de configuration doit être détectée avant le démarrage.

  1. Depuis le même répertoire, valider le modèle Compose et la configuration Prometheus avec promtool fourni dans son image.
  2. Lancer les deux conteneurs ; si le téléchargement échoue, vérifier réseau, proxy, architecture et tag avant toute autre étape.
Commandes et configuration
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
Ce qui se passe à cette étape
1Préparer
2Valider puis lancer la collecte
3Contrôler

À 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.

04

ÉTAPE 4 / 5

Prouver la première collecte

Un conteneur en état running ne garantit pas un scrape réussi.

  1. Ouvrir http://localhost:9090 puis Status > Targets : node-lab doit devenir UP après au moins un scrape.
  2. 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.
Commandes et configuration
curl -fsSG http://127.0.0.1:9090/api/v1/query --data-urlencode 'query=up{job="node-lab"}'
Ce qui se passe à cette étape
1Préparer
2Prouver la première collecte
3Contrôler

À 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.

05

ÉTAPE 5 / 5

Constater DOWN, rétablir et nettoyer

Le test négatif distingue une collecte fonctionnelle d’un simple écran accessible.

  1. Arrêter uniquement node. Attendre au moins deux scrapes et relancer la requête précédente : up vaut 0 ; Targets expose l’erreur.
  2. 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é.
Commandes et configuration
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
Ce qui se passe à cette étape
1Préparer
2Constater DOWN, rétablir et nettoyer
3Contrôler

À 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.

Consulter la documentation officielle

05 · RECETTE

Comment vérifier que tout fonctionne ?

Résultat attenduContrôles avant de considérer la procédure terminée
01

Le job node-lab est UP et up{job="node-lab"} vaut 1.

02

L’arrêt de la cible fait passer up à 0, puis son redémarrage rétablit 1.

03

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

Tous les guides Prometheus

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

Pour aller plus loin