GUIDE TECHNIQUE · PROMETHEUS
Écrire des requêtes PromQL
Construire des requêtes rate, sum et histogram_quantile sur des séries connues. Cette procédure décrit une méthode reproductible, les vérifications et les précautions avant production.
L’ESSENTIEL EN BREF
Les étapes clés
Ce guide présente 4 étapes, de « Définir le périmètre et les résultats attendus » à « Valider le diagnostic et la reprise ».
Avant de commencer : Plateforme de recette autorisée, isolée de la production et disposant d'un jeu de données fictives.
01 · CADRAGE
Périmètre et résultat visé
Résultat attendu : Les données, statuts ou artefacts correspondent à la cible et à la fenêtre de recette.
Public concerné : Ingénieurs DevOps, SRE, administrateurs plateforme et support N2/N3.
Utiliser une version stable supportée de prometheus ; contrôler la documentation officielle, les fonctionnalités disponibles et la configuration locale.
Contrôlez les versions, les droits et les options disponibles dans votre environnement avant de suivre la procédure.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
- Plateforme de recette autorisée, isolée de la production et disposant d'un jeu de données fictives.
- Comptes à droits minimaux, connectivité TLS et compatibilité entre outils vérifiées.
- Critères de réussite, validation technique et retour arrière documentés.
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 / 4
Définir le périmètre et les résultats attendus
Un laboratoire bien borné protège les environnements réels et permet un diagnostic rapide.
- Identifier la cible de recette, les droits de l'utilisateur et les versions installées.
- Définir les mesures à observer, leurs unités et la fenêtre temporelle ; préparer un état initial.
- Documenter l'absence de données personnelles et les paramètres non sensibles.
sum(rate(http_requests_total[5m]))
histogram_quantile(0.95,sum by(le)(rate(http_request_duration_seconds_bucket[5m])))À vérifier : Les prérequis et la cible sont validés avant tout changement.
Point de vigilance : Ne jamais utiliser de jeton ou mot de passe réel dans un exemple.
ÉTAPE 2 / 4
Configurer les composants
Une configuration explicite permet de reproduire l'expérience et de comparer les résultats.
- Installer ou sélectionner les composants du périmètre de laboratoire selon le chemin officiel.
- Configurer uniquement les options nécessaires à construire des requêtes rate, sum et histogram_quantile sur des séries connues.
- Vérifier syntaxe, droits, ports et règles de sécurité avant exécution.
sum(rate(http_requests_total[5m]))
histogram_quantile(0.95,sum by(le)(rate(http_request_duration_seconds_bucket[5m])))À vérifier : La configuration est acceptée sans modifier la production.
Point de vigilance : Vérifier le format et la compatibilité des commandes avec les versions installées.
ÉTAPE 3 / 4
Exécuter et contrôler
La présence d'une configuration ne prouve pas son fonctionnement effectif.
- Exécuter la commande ou action dans la console de recette et noter la cible exacte.
- Lire les statuts, logs et métriques produits puis comparer au résultat attendu.
- Tester au moins un cas non nominal : cible absente, condition non satisfaite ou autorisation refusée.
sum(rate(http_requests_total[5m]))
histogram_quantile(0.95,sum by(le)(rate(http_request_duration_seconds_bucket[5m])))À vérifier : L'exécution produit des résultats observables, horodatés et correctement attribués.
Point de vigilance : Ne jamais contourner TLS, la protection d'une branche ou les restrictions RBAC.
ÉTAPE 4 / 4
Valider le diagnostic et la reprise
Un guide doit rester exploitable par une équipe RUN après le premier succès.
- Faire rejouer la procédure par un second opérateur de recette.
- Consigner les symptômes d'échec, l'escalade et les options de récupération.
- Confirmer la suppression du jeu de test sans supprimer de données partagées.
sum(rate(http_requests_total[5m]))
histogram_quantile(0.95,sum by(le)(rate(http_request_duration_seconds_bucket[5m])))À vérifier : Une recette positive et une recette négative sont traçables.
Point de vigilance : La mise en production reste une opération distincte soumise à gouvernance.
RÉFÉRENCES TECHNIQUES
Documentation officielle
Retrouvez les prérequis, les fonctionnalités et les versions prises en charge par Prometheus. Vérifiez les commandes sur un environnement de test avant leur utilisation en production.
05 · RECETTE
Comment vérifier que tout fonctionne ?
Les données, statuts ou artefacts correspondent à la cible et à la fenêtre de recette.
La configuration est reproductible et les erreurs sont diagnostiquées sans augmentation de privilèges.
Le résultat est exploitable par un opérateur sans divulguer de secrets.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
Aucun résultat
Cause probable : Cible, filtre temporel ou configuration incorrecte
Que faire : Vérifier le point de collecte, les permissions et les logs de chaque composant.
Erreur d'autorisation
Cause probable : Compte ou rôle insuffisant
Que faire : Examiner le rôle exact et les règles d'accès sans utiliser un administrateur global.
Comportement inattendu
Cause probable : Versions, paramètres ou unités incohérents
Que faire : Comparer les valeurs à la documentation officielle de la version installée.
07 · QUESTIONS PRATIQUES
Questions fréquentes
Est-ce prêt pour la production ?
Non : valider les capacités, la sécurité, les changements et les engagements RUN sur un périmètre cible.
Comment confirmer un succès ?
Observer et conserver les preuves non sensibles après chaque étape de la procédure.
Comment réduire le risque ?
Limiter droits, périmètre et secrets, puis prévoir les étapes de retour arrière.
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.
Échanger avec ADN Consulting