Étendre les instrumentations avec l'API

Utilisez l’API OpenTelemetry en combinaison avec le Spring Boot starter pour étendre la télémétrie générée automatiquement avec des spans et des métriques personnalisés

Introduction

En plus de l’instrumentation prête à l’emploi, vous pouvez étendre le Spring Boot starter avec une instrumentation manuelle personnalisée en utilisant l’API OpenTelemetry. Cela vous permet de créer des spans et des métriques pour votre propre code sans faire trop de changements de code.

Les dépendances requises sont déjà incluses dans le starter Spring Boot.

OpenTelemetry

Le Spring Boot starter est un cas particulier où OpenTelemetry est disponible en tant que Beans Spring Boot. Injectez simplement OpenTelemetry dans vos composants Spring.

Span

import io.opentelemetry.api.OpenTelemetry;
import io.opentelemetry.api.trace.Tracer;

@Controller
public class MyController {
  private final Tracer tracer;

  public MyController(OpenTelemetry openTelemetry) {
    this.tracer = openTelemetry.getTracer("application");
  }
}

Utilisez le Tracer pour créer un span comme expliqué dans la section Span.

Un exemple complet peut être trouvé dans le dépôt d’exemples.

Meter

import io.opentelemetry.api.OpenTelemetry;
import io.opentelemetry.api.metrics.Meter;

@Controller
public class MyController {
  private final Meter meter;

  public MyController(OpenTelemetry openTelemetry) {
    this.meter = openTelemetry.getMeter("application");
  }
}

Utilisez le Meter pour créer un compteur, une jauge ou un histogramme comme expliqué dans la section Meter.

Un exemple complet peut être trouvé dans le dépôt d’exemples.


Dernière modification August 4, 2025: [fr] Translation of Zero Code Java docs (#7389) (a409f82a)