Bibliothèque de client Azure Monitor OpenTelemetry Exporter pour Java - version 1.0.0-beta.12

Article
10/23/2023

Cette bibliothèque cliente prend en charge l’exportation des données OpenTelemetry vers Azure Monitor. Ce package suppose que votre application est déjà instrumentée avec le Kit de développement logiciel (SDK) OpenTelemetry suivant la spécification OpenTelemetry.

| Code source Package (Maven) | Documentation de référence sur les | APIDocumentation | produitÉchantillons

Prise en main

Prérequis

Pour plus d’informations, consultez présentation d’Application Insights.

Inclure le package

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-monitor-opentelemetry-exporter</artifactId>
  <version>1.0.0-beta.8</version>
</dependency>

Authentification

Obtenir la clé d’instrumentation à partir du portail

Pour exporter des données de télémétrie vers Azure Monitor, vous aurez besoin de la clé d’instrumentation de votre ressource Application Insights. Pour obtenir votre clé d’instrumentation, accédez au Portail Azure et recherchez votre ressource. Dans la page de vue d’ensemble de votre ressource, vous trouverez la clé d’instrumentation dans le coin supérieur droit.

Création d’un générateur d’exportation pour Azure Monitor

AzureMonitorExporterBuilder azureMonitorExporterBuilder = new AzureMonitorExporterBuilder()
    .connectionString("{connection-string}");

Exportation de données d’étendue

L’exemple suivant montre comment exporter des données de trace vers Azure Monitor via le AzureMonitorTraceExporter

Configurer le Kit de développement logiciel (SDK) OpenTelemetry pour qu’il fonctionne avec l’exportateur Azure Monitor

// Create Azure Monitor exporter and initialize OpenTelemetry SDK
// This should be done just once when application starts up
AutoConfiguredOpenTelemetrySdkBuilder sdkBuilder = AutoConfiguredOpenTelemetrySdk.builder();

new AzureMonitorExporterBuilder()
    .connectionString("{connection-string}")
    .build(sdkBuilder);

OpenTelemetry openTelemetry = sdkBuilder.build().getOpenTelemetrySdk();

Tracer tracer = openTelemetry.getTracer("Sample");

Créer des étendues

// Make service calls by adding new parent spans
ConfigurationClient client = new ConfigurationClientBuilder()
    .connectionString("{app-config-connection-string}")
    .buildClient();

Span span = tracer.spanBuilder("user-parent-span").startSpan();
final Scope scope = span.makeCurrent();
try {
    // Thread bound (sync) calls will automatically pick up the parent span and you don't need to pass it explicitly.
    client.setConfigurationSetting("hello", "text", "World");
} finally {
    span.end();
    scope.close();
}

Concepts clés

Voici quelques concepts clés pour l’exportateur Azure Monitor :

OpenTelemetry : OpenTelemetry est un ensemble de bibliothèques utilisées pour collecter et exporter des données de télémétrie (métriques, journaux et traces) à des fins d’analyse afin de comprendre les performances et le comportement de votre logiciel.
Instrumentation : la possibilité d’appeler l’API OpenTelemetry directement par n’importe quelle application est facilitée par l’instrumentation. Une bibliothèque qui active l’observabilité OpenTelemetry pour une autre bibliothèque est appelée bibliothèque d’instrumentation.
Trace : la trace fait référence au suivi distribué. Il peut être considéré comme un graphe acyclique dirigé (DAG) de Spans, où les arêtes entre les étendues sont définies comme une relation parent/enfant.
Fournisseur de traceur : fournit un à utiliser par la bibliothèque d’instrumentation Tracer donnée.
Processeur d’étendues : un processeur d’étendue autorise les crochets pour les appels de méthode de début et de fin du Span SDK. Suivez le lien pour plus d’informations.
Échantillonnage : L’échantillonnage est un mécanisme permettant de contrôler le bruit et la surcharge introduits par OpenTelemetry en réduisant le nombre d’échantillons de traces collectées et envoyées au back-end.

Pour plus d’informations sur le projet OpenTelemetry, consultez les spécifications OpenTelemetry.

Exemples

Vous trouverez d’autres exemples dans les exemples.

Dépannage

Activation de la journalisation

Les sdk Azure pour Java offrent une histoire de journalisation cohérente pour vous aider à résoudre les erreurs d’application et à accélérer leur résolution. Les journaux produits capturent le flux d’une application avant d’atteindre l’état terminal pour faciliter la localisation du problème racine. Consultez le wiki de journalisation pour obtenir des conseils sur l’activation de la journalisation.

Étapes suivantes

En savoir plus sur Open Telemetry

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) spécifiant que vous avez le droit de nous accorder les droits d’utiliser votre contribution, et que vous nous les accordez.

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat CLA.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.

Impressions

Share via