Formations — 1 037 leçons en français

Accueil › Spring Boot › Métriques avec Micrometer et Prometheus

Métriques avec Micrometer et Prometheus

Observabilitéavance

Micrometer est la façade de métriques intégrée à Spring Boot : le code écrit des compteurs, des temporisateurs ou des jauges contre une API unique, et Micrometer les traduit vers un ou plusieurs backends (Prometheus, Datadog, CloudWatch…). C'est le même principe que SLF4J pour les logs.

Spring Boot configure automatiquement un MeterRegistry et l'alimente déjà avec des métriques utiles : requêtes HTTP (http.server.requests, avec les tags method, uri, status, outcome), mémoire et garbage collector de la JVM, CPU, pool de connexions (hikaricp.connections.active…). Ajouter ses propres métriques se fait en injectant le MeterRegistry :

@Service
public class CommandeService {
    private final Counter commandesCreees;

    public CommandeService(MeterRegistry registry) {
        this.commandesCreees = Counter.builder("commandes.creees")
                .tag("canal", "web")
                .register(registry);
    }

    public Commande creer(CreationCommandeDto dto) {
        Commande commande = ...;
        commandesCreees.increment();
        return commande;
    }
}

Avec micrometer-registry-prometheus et management.endpoints.web.exposure.include: prometheus, ces métriques deviennent lisibles sur /actuator/prometheus, au format texte que Prometheus vient périodiquement « scraper ». Grafana se branche ensuite sur Prometheus comme source de données pour visualiser des courbes et des tableaux de bord.

Le point à surveiller en permanence : la cardinalité des tags. Un tag doit décrire une catégorie bornée (méthode HTTP, type de canal, code de statut), jamais un identifiant unique — sous peine de créer une série temporelle par valeur possible, ce qui peut saturer le backend.

Les termes à connaître

Micrometer

Façade de métriques intégrée à Spring Boot, comparable à ce que SLF4J est pour les logs : le code applicatif s'écrit contre une API unique (MeterRegistry), et Micrometer traduit vers le format du backend choisi (Prometheus, Datadog, CloudWatch…) sans changer le code métier.

MeterRegistry

Point d'entrée pour créer et récupérer des métriques (« meters »). Spring Boot en configure automatiquement une instance, injectable dans n'importe quel bean.

Counter

Métrique qui ne fait qu'augmenter (nombre de commandes créées, d'erreurs rencontrées). Se lit en valeur cumulée ; le taux d'évolution (par seconde, par minute) se calcule côté outil de visualisation.

Timer

Mesure à la fois le nombre d'appels et leur durée (avec des percentiles côté backend). C'est le type de métrique derrière http.server.requests, la métrique HTTP fournie automatiquement par Spring Boot.

Gauge

Valeur instantanée qui peut monter ou descendre (taille d'une file, nombre de connexions actives). Contrairement au Counter, un Gauge ne stocke pas de valeur : il la relit via une fonction à chaque interrogation.

Tags et cardinalité

Une métrique peut porter des paires clé/valeur (tag("methode", "POST")). Chaque combinaison unique de tags crée une série temporelle distincte côté backend : un tag à forte cardinalité (identifiant, e-mail, UUID) peut multiplier les séries à l'infini et saturer le système de métriques.

micrometer-registry-prometheus

Dépendance qui ajoute un MeterRegistry au format Prometheus et active l'endpoint /actuator/prometheus, à exposer via management.endpoints.web.exposure.include.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.