Surveillance des traces dans l'explorateur de traces
Vous pouvez surveiller les traces et les étendues téléchargées à l'aide de sources de données Application Performance Monitoring dans l'explorateur de traces.
Les traces permettent de suivre le temps qu'une application consacre au traitement d'une demande et le statut de cette dernière. Chaque trace se compose d'étendues et la liste des traces dans l'explorateur de traces correspond à la liste des étendues racine (début d'une transaction). Par exemple, une trace de téléchargement de page peut être constituée d'étendues d'appel AJAX, d'étendues de mise à jour de page, etc. Les étendues, quant à elles, contiennent des dimensions, à savoir des paires clé-valeur associées à l'étendue qui fournissent des informations et du contexte supplémentaires sur l'opération effectuée dans cette dernière. Dans l'explorateur de traces, vous pouvez utiliser des dimensions pour interroger et filtrer les traces et les étendues.
Pour surveiller les traces, procédez comme suit :
- Connectez-vous à la console Oracle Cloud Infrastructure.
- Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Surveillance des performances des applications, cliquez sur Explorateur de traces.
- En haut à droite de la page Explorateur de traces, sélectionnez un compartiment et un domaine APM. Vous pouvez éventuellement modifier la période par défaut (60 dernières minutes) pour afficher toutes les traces avec des étendues qui ont commencé au cours de la période sélectionnée.
Les données de trace affichées dans l'explorateur de traces sont déterminées par une requête prête à l'emploi. Cette page comporte les principaux composants suivants, qui vous permettent d'exécuter ou de modifier des requêtes prêtes à l'emploi, et de personnaliser la vue pour afficher les données de trace relatives à la zone d'application à surveiller.
- Graphiques, qui est fermé par défaut sur la gauche, affiche les graphiques sparkline que vous sélectionnez dans une requête, y compris
timeseries
.Lorsque le panneau Graphiques est ouvert, si vous exécutez une requête qui inclut
timeseries
, ou cliquez sur le bouton de sélection rapide Trace des services, qui contient déjàtimeseries
dans la requête, vous pouvez cliquer sur les graphiques sparkline du tableau pour les ajouter au panneau Graphiques, comme indiqué dans 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 d'un seul coup d'oeil. - Attributs, à gauche, répertorie les dimensions (avec valeurs de chaîne) et les mesures (avec valeurs numériques) disponibles pour les traces et les étendues, que vous pouvez ajouter à une requête. 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 de service et le nom d'opération. Quel que soit le domaine APM sélectionné, le même ensemble d'attributs prêts à l'emploi est disponible dans la liste Attributs.
- Attributs personnalisés pouvant être ajoutés en fonction de vos besoins lors de la configuration des sources de données. L'ensemble d'attributs personnalisés est propre au domaine APM sélectionné.
Si vous placez le pointeur de la souris sur une dimension, un lien apparaît et vous pouvez cliquer dessus pour afficher les valeurs de la dimension dans la boîte de dialogue Dimension <Nom> Valeurs. Aucun lien n'est affiché pour les mesures (valeurs numériques), telles que
ApdexScore
. En outre, selon que la dimension est répertoriée dans l'onglet Traces ou dans l'onglet Etendues 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 (étendues racine) sont affichées dans la boîte de dialogue Dimension <Nom> Valeurs. Si vous cliquez sur la même dimension dans l'onglet Etendues, les valeurs de toutes les étendues sont affichées. La boîte de dialogue Dimension <Nom> Valeurs comporte également les boutons Copier, Ajouter à la requête et Ajouter au filtre global, sur lesquels vous pouvez cliquer pour copier une valeur de dimension ou l'insérer dans une requête ou un filtre global.Pour plus d'informations sur les sujets suivants, reportez-vous aux rubriques indiquées :
- Dimensions de trace et d'étendue. Reportez-vous à la section A propos des attributs de trace et d'étendue.
- Requêtes. Reportez-vous à Utilisation des requêtes dans l'explorateur de traces
- Comparer les étendues, à gauche, affiche la liste des étendues sélectionnées pour comparaison entre elles.
Vous pouvez ajouter jusqu'à 4 étendues à la liste. Pour plus d'informations, reportez-vous à Comparaison des étendues.
-
Barre de requête contient des boutons de sélection rapide fournis avec des requêtes prêtes à l'emploi, une icône Actions (
) à droite de la barre de requête, Exécuter pour exécuter une requête et un menu déroulant pour Visualiser les requêtes en arrière-plan.
Boutons de sélection rapide : par défaut, les boutons de sélection rapide tels que Traces, Services et Opérations sont fournis avec des requêtes prêtes à l'emploi basées sur certaines recherches de données de trace probables. Les requêtes de l'explorateur de traces suivent une syntaxe simplifiée de type SQL. Elles incluent des clauses et des dimensions pour filtrer, catégoriser et afficher les données de trace, et vous permettent de filtrer de grandes quantités de données de trace et d'afficher les informations qui vous intéressent.
Par exemple, voici la requête prête à l'emploi de la sélection rapide Traces, qui utilise des clauses et des dimensions prêtes à l'emploi pour afficher les 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)
En fonction de cette requête, une liste de 100 traces est affichée avec les colonnes suivantes pour la période sélectionnée :
- Service : opération : affiche l'étendue racine de la trace, à savoir le service et l'opération dans lesquels la demande démarre. Comme indiqué par la clause
where
de la requête, les étendues racine dans lesquelles l'opération d'activité utilisateur (ApmrumPageUpdateType
) estCliquer
ou n'a pas de valeur définie ne sont pas affichées. - Statut : affiche le statut de la trace :
- Terminé : indique que l'étendue racine est disponible dans l'explorateur de traces, mais que les informations relatives aux erreurs ne le sont pas.
- Incomplet : indique que l'étendue racine n'est pas disponible dans l'explorateur de traces. La trace est donc incomplète.
- Succès : indique que l'étendue racine est disponible dans l'explorateur de traces, et que le code et le type d'erreur indiquent que l'opération a réussi (HTTP 200).
- Erreur : indique que l'étendue racine contient des erreurs.
- Heure de début : affiche l'heure à laquelle l'étendue racine a démarré.
La liste des traces est triée en fonction de la colonne Heure de début. Vous pouvez toutefois la trier en fonction de n'importe quelle autre colonne disponible. Par exemple, vous pouvez trier la liste des traces par durée pour visualiser les traces ayant pris le plus de temps en haut de la liste.
- Durée : affiche la durée entre le début de la première étendue et la fin de la dernière. Le graphique à barres de la colonne Durée permet d'identifier la trace dont l'exécution a duré le plus longtemps.
- Etendues : affiche le nombre total d'étendues dans la trace. Passez le curseur de la souris sur le graphique à barres de la colonne Etendues pour afficher la répartition du nombre d'étendues par service dans la trace et le nombre d'erreurs, le cas échéant.
- Erreurs d'étendue : affiche le nombre d'étendues avec des erreurs.
Custom query bar: From Query Bars in Administration, under Resources, or from Manage using the Actions icon (
) 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.
A partir de l'icône Actions (
) à droite de la barre de requête, vous pouvez ouvrir d'autres barres de requête disponibles à partir du panneau Ouvrir la barre de requête pour en faire la barre de requête en cours. Vous pouvez également enregistrer la barre de requête en cours comme valeur par défaut.
Requêtes d'arrière-plan : vous pouvez créer des requêtes et les exécuter en arrière-plan. Cela est utile lorsque vous avez des requêtes qui peuvent prendre un certain temps pour être exécutées. Pour plus d'informations, reportez-vous à Configuration d'une requête en arrière-plan.
- Service : opération : affiche l'étendue racine de la trace, à savoir le service et l'opération dans lesquels la demande démarre. Comme indiqué par la clause
-
Le filtre global vous permet d'ajouter un filtre pour vos résultats de requête qui restera actif pendant que vous travaillez dans l'explorateur de traces, ce qui vous permet de conserver certains critères fixes pendant que la requête change au fur et à mesure que vous passez par les prélèvements rapides, par exemple. Le filtre global, formé en tant que clause
where
, ne s'affiche pas dans la zone de requête, mais fonctionne avec la requête et peut être activé ou désactivé à l'aide du commutateur situé à droite de la barre.A l'aide de l'icône Actions (
) à droite de la barre de filtre globale, de même que les requêtes, vous pouvez enregistrer le filtre en cours et ouvrir le panneau Ouvrir le filtre global, dans lequel vous pouvez rechercher, modifier rapidement et ouvrir les filtres enregistrés. Vous pouvez modifier, gérer et supprimer les filtres enregistrés dans Filtres globaux dans Administration, sous Ressources.
Vous pouvez également cliquer sur l'icône Actions () pour chaque trace ou plage et effectuer les opérations suivantes :
- Afficher les détails de trace ou Afficher les détails de l'étendue
- Show Trace Topology
- Afficher les traces ou Afficher les intervalles
Notez que l'option Afficher la topologie de trace apparaît dans le menu Actions uniquement si la requête prend en charge la vue Topologie. Les options Afficher les détails de la trace ou Afficher les détails de l'étendue sont affichées lorsqu'une liste de traces ou d'étapes est affichée et que les options Afficher les traces ou Afficher les intervalles sont affichées pour les résultats des requêtes agrégées comportant la clause group by
.