Étendre les instrumentations avec l'API

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

Introduction

En plus de l’instrumentation prête à l’emploi, vous pouvez étendre l’agent Java 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.

Dépendances

Ajoutez une dépendance à la bibliothèque opentelemetry-api.

Maven

<dependencies>
  <dependency>
    <groupId>io.opentelemetry</groupId>
    <artifactId>opentelemetry-api</artifactId>
    <version>1.51.0</version>
  </dependency>
</dependencies>

Gradle

dependencies {
    implementation('io.opentelemetry:opentelemetry-api:1.51.0')
}

OpenTelemetry

L’agent Java est un cas particulier où GlobalOpenTelemetry est défini par l' agent. Appelez simplement GlobalOpenTelemetry.get() pour accéder à l’instance OpenTelemetry.

Span

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

Tracer tracer = GlobalOpenTelemetry.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.GlobalOpenTelemetry;
import io.opentelemetry.api.metrics.Meter;

Meter meter = GlobalOpenTelemetry.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)