Application Real-Time Monitoring Service:Trace Explorer

Légendes des statuts de span

Le diagramme en barres de la section supérieure utilise un code couleur pour les codes d'état HTTP : 2XX (vert), 3XX (jaune), 4XX (orange) et 5XX (rouge). Ces codes proviennent du champ attributes.http.status_code ou attributes.http.response.status_code. Si une span contient les deux champs, le code d'état HTTP est prioritaire sur l'indicateur d'état de la span.

Actions disponibles

• Cliquez sur un ID de trace ou sur Details dans la colonne Actions pour afficher les détails de la trace et la topologie. Consultez la section Détails de la trace.

• Cliquez sur Logs dans la colonne Actions pour afficher les journaux associés à la trace. Consultez la rubrique Analyse des journaux.

• Cliquez sur l'icône pour développer toutes les spans sous un ID de trace. Par défaut, seules les spans racines sont affichées par ID de trace.

• Cliquez sur l'icône dans le coin supérieur droit pour afficher ou masquer les colonnes de la liste.

• Survolez une trace et cliquez sur l'icône pour ajouter ses valeurs de paramètre comme condition de filtre.

Paramètres d'agrégation

Exemple d'agrégation

Prenons l'exemple d'une trace où la span A appelle les spans B et C :

Comment lire ce tableau :

• Répartition des requêtes : la span A compte 10 requêtes (100 %). Seules 4 de ces requêtes appellent la span B (40 %) et une seule appelle la span C (10 %). Les requêtes restantes ignorent les spans B et C en raison d'une logique conditionnelle ou d'exceptions.

• Fréquence des spans : la span A est appelée une fois par requête (multiplicateur = 1,00). La span B compte 8 spans pour 4 requêtes, donc chaque requête appelle la span B deux fois en moyenne (multiplicateur = 2,00).

• Répartition du temps propre : le temps propre de la span A est de 5,00 ms (25 % de la durée moyenne de 20 ms), ce qui signifie que 75 % du temps est consacré aux spans enfants. Les spans B et C affichent 100 % de temps propre car elles n'ont pas d'enfants.

• Répartition des exceptions : la span A présente 2 exceptions sur 10 requêtes (20 %). La span B présente 2 exceptions sur 4 requêtes (50 %). Étant donné que le multiplicateur de requête de la span B est de 2,00, une répartition probable est la suivante : 2 des 4 requêtes rencontrent une exception lors du premier appel, tandis que le second appel réussit.

Analyse des traces lentes

ARMS analyse les 1 000 traces ayant la durée la plus longue et met en évidence les cinq dimensions les plus corrélées avec la lenteur.

Analyse des traces échouées

ARMS échantillonne aléatoirement 1 000 traces échouées et met en évidence les cinq dimensions les plus corrélées avec les échecs.

Étiquettes de composant (1)

Les étiquettes représentent les types d'appel et le nombre de spans. Les types d'appel sont déterminés par le champ attributes.component.name. Cliquez sur une étiquette pour afficher ou masquer les spans associées.

Diagramme en barres de la trace (2)

Le diagramme en barres horizontal offre une vue d'ensemble de la trace et de la répartition de ses spans. Utilisez-le pour identifier rapidement où le temps est consommé dans la trace.

• Chaque barre représente une span. Seules les spans dont la durée dépasse 1 % de la durée totale de la trace sont affichées.

• Les couleurs distinguent les différentes applications. Dans la figure précédente, le bleu représente l'application opentelemetry-demo-adservice.

• Une ligne noire dans chaque barre représente le temps propre : la durée totale de la span moins le temps passé dans les spans enfants. Par exemple, si la span A prend 10 ms et que sa span enfant B prend 8 ms, le temps propre de la span A est de 2 ms.

• La chronologie affiche la plage de temps complète de la trace.

Focus et filtrage des spans (3)

Chaque ligne représente une span avec sa hiérarchie parent-enfant. Les spans parentes affichent un nombre indiquant le nombre de leurs spans enfants. Opérations disponibles :

• Réduire/Développer : cliquez sur l'icône pour réduire ou développer une span et ses enfants.

• Focus : sélectionnez une span et cliquez sur l'icône pour afficher uniquement cette span et ses spans descendantes.

• Annuler le focus : cliquez sur l'icône pour quitter le mode focus.

• Filtrer : saisissez un nom de span, un nom d'application ou un attribut dans la zone de recherche pour filtrer la trace afin de ne conserver que les spans correspondantes et leur chemin vers la span d'entrée. Effacez la zone de recherche et cliquez sur l'icône de recherche pour supprimer le filtre.

• Zoom : cliquez sur l'icône pour zoomer et masquer le diagramme en barres. Cliquez sur l'icône pour le restaurer.

Détails de la span (4)

Le panneau des détails de la span affiche les attributs, les métriques, les journaux et les données d'exception pour la span sélectionnée.

• Additional Information : affiche les attributs de la span, les ressources, les détails et les événements, regroupés par type. Pour les descriptions des champs, consultez la rubrique Paramètres Trace Explorer.

• Metrics : affiche les métriques liées à la span.

  • Pour les applications Java surveillées par ARMS : métriques JVM et hôte.

  • Pour les traces provenant d'agents open source : métriques de la méthode RED (taux, erreurs, durée).

• Logs : affiche les journaux métier liés à la trace. Si un Logstore Simple Log Service (SLS) est configuré pour l'application, interrogez les journaux métier par ID de trace dans le Logstore.

• Exceptions : affiche les informations d'exception pour la span, le cas échéant.

• Event Config : configurez des événements d'interaction pour un ou plusieurs attributs de trace afin d'accéder à des détails de trace supplémentaires ou aux journaux et métriques associés. Consultez la rubrique Configurer un événement d'interaction personnalisé pour une trace.

Pourquoi les instructions SQL sont-elles tronquées dans les traces ?

ARMS limite par défaut les instructions SQL à 1 024 caractères. Pour augmenter cette limite, accédez à l'onglet Custom Configurations de votre application et modifiez Maximum retention length for SQL collection dans la section Database call configuration.

Éléments de configuration des appels de base de données dans l'onglet Custom Configurations :

• Slow SQL Threshold : par défaut 500 ms. Les requêtes SQL dépassant ce seuil sont marquées comme SQL lentes.

• Maximum Retention Length for SQL Collection : par défaut 1 024 caractères. Les instructions SQL dépassant cette longueur sont tronquées.

• Display Variable Binding Values in SQL : lorsqu'il est activé, capture les valeurs de liaison des paramètres PrepareStatement. Pris en charge uniquement pour MySQL.

• Display Constant Values in SQL : activez cette option pour afficher les valeurs constantes dans les instructions SQL.

• Record MySQL Query Return Value Size : activez cette option pour enregistrer la taille des valeurs de retour des requêtes MySQL.

Après la configuration, cliquez sur Save, ou sur Save and Batch Copy to Other Applications pour synchroniser la configuration avec d'autres applications.

Pourquoi des spans Nacos avec des durées de 30 secondes apparaissent-elles après la mise à niveau vers l'agent ARMS V4.x ?

L'agent ARMS 4.x instrumente les requêtes HTTP de sondage long que Nacos utilise pour les mises à jour de configuration et la découverte de services. Ces spans ne sont pas capturées dans la version 3.x. Pour plus de détails, consultez l'annonce Annonce de la mise à niveau de l'agent ARMS V4.x.

Pour exclure ces spans, ajoutez une règle de filtre dans la section Interface call configuration de l'onglet Custom Configurations de votre application.

Dans la section Interface Call Configuration de l'onglet Custom Configurations, saisissez les chemins d'interface que vous souhaitez exclure dans la zone de texte Invalid Interface Call Filter pour supprimer ces spans. La section inclut également Slow Call Threshold (par défaut 500 ms), Exception Allowlist, HTTP Status Code Allowlist et plusieurs commutateurs d'enregistrement de métriques.