Surveiller les traces dans l'explorateur de trace

Vous pouvez surveiller les traces et les intervalles chargés dans l'explorateur de trace à l'aide des sources de données du service de surveillance de la performance des applications.

Les traces sont utilisées pour suivre le temps passé par une application à traiter une demande et le statut de la demande. Chaque trace est constituée d'une ou de plusieurs intervalles. La liste des traces de l'explorateur de trace est une liste des intervalles racines, qui sont le début d'une transaction. Par exemple, une trace de chargement de page peut être constituée d'intervalles d'appel AJAX, d'intervalles de mise à jour de page, etc. À leur tour, les intervalles ont des dimensions, qui sont des paires clé-valeur attachées à l'intervalle pour fournir des informations supplémentaires et un contexte sur l'opération effectuée dans l'intervalle. Dans l'explorateur de trace, vous pouvez utiliser des dimensions pour interroger et filtrer les traces et les intervalles.

Pour surveiller les traces :

  1. Connectez-vous à la console Oracle Cloud Infrastructure.
  2. Ouvrez le menu de navigation, cliquez sur Observabilité et gestion. Sous Surveillance de la performance des applications, cliquez sur Explorateur de trace.
  3. Dans le coin supérieur droit de la page Explorateur de trace, sélectionnez un compartiment et un domaine APM. Facultativement, vous pouvez modifier la période par défaut (60 dernières minutes) pour voir toutes les traces avec des intervalles qui ont commencé pendant la période sélectionnée.

L'explorateur de trace affiche les données de trace déterminées par une interrogation prête à l'emploi. Cette page comporte les principaux composants suivants, qui vous permettent d'exécuter ou de modifier des interrogations prêtes à l'emploi et de personnaliser la vue pour afficher les données de trace relatives à la zone d'application que vous souhaitez surveiller.

  • Graphiques, qui est fermé par défaut à gauche, affiche les mini-graphiques que vous sélectionnez dans une interrogation incluant timeseries.

    Lorsque le panneau Graphiques est ouvert, si vous exécutez une interrogation qui inclut timeseries, ou cliquez sur le bouton de prélèvement rapide Trace Services, qui contient déjà timeseries dans l'interrogation, vous pouvez cliquer sur les mini-graphiques du tableau pour les ajouter au panneau Graphiques, comme le montre l'image ci-dessous. Vous pouvez ajouter plusieurs graphiques à afficher dans le panneau, ce qui vous permet de mieux visualiser les graphiques et de les comparer en un coup d'oeil.

  • Attributs, à gauche, liste les dimensions (avec valeurs de chaîne) et les mesures (avec valeurs numériques) disponibles pour les traces et les intervalles, que vous pouvez ajouter à une interrogation. Les attributs sont les suivants :
    • Attributs prêts à l'emploi disponibles dans Application Performance Monitoring et configurés par des sources de données, telles que le nom du service et le nom de l'opération. Quel que soit le domaine APM sélectionné, le même jeu d'attributs prêts à l'emploi est disponible dans la liste Attributs.
    • Attributs personnalisés que vous pouvez ajouter selon vos besoins lors de la configuration des sources de données. Le jeu d'attributs personnalisés sont propres au domaine APM sélectionné.

    Si vous pointez la souris sur une dimension, un lien est affiché et vous pouvez cliquer dessus pour voir les valeurs de la dimension dans la boîte de dialogue Valeurs de la dimension <nom>. Notez qu'un lien n'est pas affiché pour les mesures (valeurs numériques), par exemple ApdexScore. De plus, selon que la dimension est listée dans l'onglet Traces ou Intervalles dans Attributs, les valeurs de dimension diffèrent. Si vous cliquez sur une dimension répertoriée dans l'onglet Traces, seules les valeurs des traces (intervalles racines) sont affichées dans la boîte de dialogue Valeurs de la dimension <nom> et si vous cliquez sur la même dimension dans l'onglet Intervalles, les valeurs de tous les intervalles sont affichées. La boîte de dialogue Valeurs de la dimension <nom> comporte également les boutons Copier, Ajouter à l'interrogation et Ajouter au filtre global, sur lesquels vous pouvez cliquer pour copier une valeur de dimension ou l'insérer dans une interrogation ou un filtre global.

    Pour plus d'informations sur les sujets suivants :

  • Comparer les intervalles, à gauche, affiche une liste des intervalles sélectionnés pour la comparaison.

    Vous pouvez ajouter jusqu'à 4 intervalles à la liste. Pour plus d'informations, voir Comparer les intervalles.

  • La barre d'interrogation contient des boutons de sélection rapide fournis avec des interrogations prêtes à l'emploi, une icône Actions (Icône Actions) à droite de la barre d'interrogation, Exécuter pour exécuter une interrogation et un menu déroulant pour Voir les interrogations en arrière-plan.

    Boutons de prélèvement rapide : Par défaut, les boutons de prélèvement rapide tels que Traces, Services et Opérations sont fournis avec des interrogations prêtes à l'emploi basées sur certaines recherches de données de trace probables. Les interrogations de l'explorateur de trace suivent une syntaxe SQL simplifiée qui comprend des clauses et des dimensions pour filtrer, catégoriser et afficher les données de trace, et qui vous permet de filtrer d'énormes quantités de données de trace pour voir les informations qui vous intéressent.

    Par exemple, voici l'interrogation prête à l'emploi dans le prélèvement rapide Traces, qui utilise des clauses et des dimensions prêtes à l'emploi pour afficher des informations relatives aux traces :

    show (traces) TraceStatus as Status,
        TraceFirstSpanStartTime as "Start Time",
        ServiceName as Service,
        OperationName as Operation,
        TraceDuration as Duration,
        span_summary() as Spans,
        ErrorCount as "Span Errors"
      where (ApmrumPageUpdateType <> 'Click' or ApmrumPageUpdateType is omitted)

    Cette interrogation affiche une liste de 100 traces, avec les colonnes suivantes pour la période sélectionnée :

    • Service : Opération : Affiche l'intervalle racine de la trace, à savoir le service et l'opération où la demande commence. Comme l'indique la clause where dans l'interrogation, les intervalles racines dans lesquels l'opération d'activité de l'utilisateur (ApmrumPageUpdateType) est Click, ou dans lesquels la valeur n'est pas définie, ne sont pas affichés.
    • Statut : Affiche le statut de la trace :
      • Fin : Indique que l'intervalle racine est disponible dans l'explorateur de trace, mais les informations relatives aux erreurs ne le sont pas.
      • Non terminée : Indique que l'intervalle racine n'est pas disponible dans l'explorateur de trace. La trace est donc incomplète.
      • Réussite : Indique que l'intervalle racine est disponible dans l'explorateur de trace et que le code et le type d'erreur indiquent la réussite (HTTP 200).
      • Erreur : Indique que l'intervalle racine comporte des erreurs.
    • Heure de début : Affiche l'heure à laquelle l'intervalle racine a commencé.

      La liste des traces est triée en fonction de la colonne Heure de début. Toutefois, vous pouvez trier la liste sur n'importe laquelle des colonnes disponibles. Par exemple, vous pouvez trier la liste de suivi par Durée pour voir en haut de la liste les traces qui ont pris le plus de temps.

    • Durée : Affiche le temps écoulé entre le début du premier intervalle et la fin du dernier. Le graphique à barres de la colonne Durée permet d'identifier la trace qui en cours d'exécution depuis le plus longtemps.
    • Intervalles : Affiche le nombre total d'intervalles dans la trace. Si vous pointez la souris sur le graphique à barres dans la colonne Intervalles, une répartition du nombre d'intervalles dans chaque service est affichée dans la trace ainsi que le nombre d'erreurs, le cas échéant.
    • Erreurs d'intervalle : Affiche le nombre d'intervalles comportant des erreurs.

    Custom query bar: From Query Bars in Administration, under Resources, or from Manage using the Actions icon (Icône Actions) at the right of the Query Bar, you can create a custom query bar, where you can add your own quick pick buttons with custom queries.

    À partir de l'icône Actions (Icône Actions) à droite de la barre d'interrogation, vous pouvez ouvrir d'autres barres d'interrogation disponibles à partir du panneau Ouvrir la barre d'interrogation en tant que barre d'interrogation courante. Vous pouvez également enregistrer la barre d'interrogation courante comme valeur par défaut.

    Interrogations en arrière-plan : Vous pouvez créer des interrogations et les exécuter en arrière-plan. Cela est utile lorsque vous avez des interrogations qui peuvent prendre un certain temps pour être exécutées. Pour plus d'informations, voir Configurer une interrogation en arrière-plan.

  • Le filtre global vous permet d'ajouter un filtre pour les résultats de votre interrogation qui restera actif au fur et à mesure que vous travaillez dans l'explorateur de trace, ce qui vous permet de conserver certains critères fixes pendant que l'interrogation change au fur et à mesure que vous, par exemple, passez d'un prélèvement rapide à un autre. Le filtre global, formé en tant que clause where, ne s'affiche pas dans la zone d'interrogation, mais fonctionne à côté de l'interrogation et peut être activé ou désactivé à l'aide du commutateur à droite de la barre.

    À l'aide de l'icône Actions (Icône Actions) à droite de la barre de filtres globaux, tout comme les interrogations, vous pouvez enregistrer le filtre courant et ouvrir le panneau Ouvrir le filtre global, où vous pouvez rechercher, modifier rapidement et ouvrir les filtres enregistrés. Vous pouvez modifier, gérer et supprimer les filtres enregistrés à partir de Filtres globaux dans Administration, sous Ressources.

Vous pouvez également cliquer sur l'icône Actions (Icône Actions) pour chaque trace ou intervalle et effectuer les actions suivantes :

  • Afficher les détails de la trace ou Afficher les détails de l'intervalle
  • Afficher la topologie de trace
  • Afficher les traces ou Afficher les intervalles

Note that the Show Trace Topology option is displayed in the Actions menu only if the query supports the Topology view. The Show Trace Details or Show Span Details options are displayed when a list of traces or spans is displayed and the Show Traces or Show Spans options are displayed for results of aggregate queries that have the group by clause.