Application Real-Time Monitoring Service:Prise en main

Prérequis

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

• Activez Managed Service for OpenTelemetry

• Obtenir un endpoint

  1. Connectez-vous à la console ARMS. 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 Server-side Applications.

  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.

     

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 ou la console ARMS.

É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.

   Connectez-vous à la console ARMS. Dans le volet de navigation de gauche, choisissez Application Monitoring > Applications. Sur la page Applications, cliquez sur le nom de l'application. Sur la page qui s'affiche, consultez les données de trace.

   Remarque

   Si l'icône apparaît dans la colonne Language, l'application est connectée à Application Monitoring. Si un tiret (-) s'affiche, l'application est connectée à Managed Service for OpenTelemetry.

É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.