Étendre les instrumentations avec l'API
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
Pour les cas d’usage les plus courants, utilisez l’annotation @WithSpan
au
lieu de l’instrumentation manuelle. Consultez Annotations pour
plus d’informations.
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.
Feedback
Cette page est-elle utile?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!