Managed Service for OpenTelemetry:Prise en main

Prérequis

• Créer un compte Alibaba CloudCréez un compte Alibaba Cloud.

• Activez Managed Service for OpenTelemetry

• Obtenir un endpoint

  New console

  1. Connectez-vous à la console Managed Service for OpenTelemetry. Dans le volet de navigation de gauche, cliquez sur Integration Center.

  2. Sur la page Integration Center, cliquez sur la carte OpenTelemetry dans la section Open Source Frameworks.

  3. Dans le panneau OpenTelemetry, cliquez sur l'onglet Start Integration, puis sélectionnez la région vers laquelle vous souhaitez transmettre les données.

     Remarque

     Lors du premier accès à une région, les ressources y sont automatiquement initialisées.

  4. Configurez les paramètres Connection Type et Export Protocol, puis copiez un endpoint.

     • Connection Type : si votre service est déployé sur Alibaba Cloud et réside dans la région sélectionnée, nous vous recommandons de définir ce paramètre sur Alibaba Cloud VPC Network. Dans le cas contraire, choisissez Public Network.

     • Export Protocol : définissez ce paramètre sur HTTP (recommandé) ou gRPC selon le protocole pris en charge par le client.

     

  Old console

  1. Connectez-vous à la console Managed Service for OpenTelemetry.

  2. Dans le volet de navigation de gauche, cliquez sur Cluster Configurations. Sur la page qui s'affiche, cliquez sur l'onglet Access point information.

  3. Dans la barre de navigation supérieure, sélectionnez la région vers laquelle vous souhaitez transmettre les données. Dans la section Cluster Information, activez l'option Show Token.

  4. Définissez le paramètre Client sur OpenTelemetry.

     Dans la colonne Related Information du tableau, copiez un endpoint.

     Remarque

     Si votre application est déployée dans un environnement de production Alibaba Cloud, utilisez un endpoint VPC. Sinon, utilisez un endpoint public.

Vue d'ensemble

La page des détails de trace de l'ancienne console affiche la trace complète d'une requête HTTP 404. La chronologie de gauche présente cinq spans hiérarchiques : GET / (404, 11,1ms), ResourceHttpRequestHandler.handleRequest (85μs), ResponseFacade.sendError (19μs), BasicErrorController.errorHtml (4,92ms) et Render error** (4,34ms). La section supérieure indique le TraceID, l'heure de début, la durée totale ainsi qu'un indicateur d'erreur rouge. Le panneau Span Details, situé à droite, affiche le nom de l'application java-agent-usage-0.0.1-SNAPSHOT, le nom de l'interface BasicErrorController.errorHtml, le spanId, le parentSpanId, ainsi que des attributs tels que ali.trace.component_type=98, ali.trace.flag=x-trace et thread.name=http-nio-8081-exec-1.

Ce guide prend pour exemple l'utilisation de l'agent Java OpenTelemetry avec une application Java :

1. Télécharger une application de démonstration : téléchargez la démo pour tester Managed Service for OpenTelemetry, ou instrumentez votre propre application.

2. Instrumenter votre application avec l'agent Java OpenTelemetry : téléchargez l'agent Java OpenTelemetry pour bénéficier d'une instrumentation automatique non intrusive couvrant des centaines de frameworks Java. Modifiez les paramètres de démarrage de la JVM afin de transmettre les traces.

3. Consulter les données de surveillance : visualisez les données de télémétrie dans la console Managed Service for OpenTelemetry ou la .

Étape 1 : Télécharger l'application de démonstration

Utilisez l'application de démonstration fournie ou votre propre application Java.

Téléchargez le code de démonstration : Démo Agent Java OpenTelemetry.

Étape 2 : Instrumenter l'application

L'agent Java OpenTelemetry offre une instrumentation automatique non intrusive pour des centaines de frameworks Java, répertoriés dans la section Bibliothèques et versions prises en charge.

1. Téléchargez l'agent Java OpenTelemetry.

   Dans la section Assets de la dernière version, téléchargez le fichier opentelemetry-javaagent.jar.

2. Modifiez les paramètres de la machine virtuelle dans votre commande de démarrage Java afin de transmettre les traces.

   -javaagent:/{user.workspace}/opentelemetry-javaagent.jar    // Replace {user.workspace} with the actual path where you downloaded the file.
   -Dotel.resource.attributes=service.name=<appName>     // Replace <appName> with your application name.
   -Dotel.exporter.otlp.headers=Authentication=<token>    // Use the token from the endpoint information obtained in the prerequisites.
   -Dotel.exporter.otlp.endpoint=<endpoint>  // Use the endpoint from the endpoint information obtained in the prerequisites.

   Par exemple, si votre commande de démarrage est la suivante :

   java -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

   Pour vous connecter à Managed Service for OpenTelemetry, mettez à jour la commande comme suit :

   java -Dotel.resource.attributes=service.name=java-agent-usage-0.0.1-SNAPSHOT -Dotel.exporter.otlp.headers=Authentication=ggxw4l****@7323a5caae30263_ggxw4l****@53df7ad2afe**** -Dotel.exporter.otlp.endpoint=http://tracing-analysis-dc-hz.aliyuncs.com:8090 -javaagent:/{user.workspace}/opentelemetry-javaagent.jar -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

Étape 3 : Consulter les données de surveillance

1. Accédez à l'application de démonstration via localhost:8081/user/async. L'agent collecte et envoie les données de télémétrie à Managed Service for OpenTelemetry.

2. Sur la page des détails de l'application, cliquez sur l'onglet Trace Analysis pour consulter les graphiques relatifs au nombre d'appels, aux erreurs et à la latence moyenne. La liste des traces affiche des informations telles que le TraceID, le nom de l'interface, le nom de l'application, la latence, le statut, l'heure de début et l'adresse de l'hôte. Utilisez les fonctionnalités Slow Trace Analysis et Error Trace Analysis pour identifier les facteurs responsables des appels lents.

   Sur la console Managed Service for OpenTelemetry, accédez à la page Applications et sélectionnez votre application pour consulter les traces.

Étapes suivantes

Managed Service for OpenTelemetry prend en charge Java, Go, Python, JavaScript, .NET, C++, et bien d'autres langages. Les clients compatibles incluent OpenTelemetry, Jaeger, Zipkin et SkyWalking.