Trace Explorer

Parcours d'une trace

Présentation

Le Trace Explorer vous permet d’effectuer des recherches parmi toutes les spans ingérées ou indexées en appliquant n’importe quel tag sur n’importe quelle span. Les spans renvoyées par votre requête dépendent du type de recherche effectué. Une recherche en mode Live renvoie toutes les spans ingérées au cours des 15 dernières minutes avec mise à jour en temps réel, tandis qu’une recherche parmi les spans indexées renvoie les spans conservées pendant 15 jours par vos filtres personnalisés.

Les applications instrumentées envoient 100 % de leurs traces à Datadog en vue de leur ingestion. Ces traces sont alors disponibles en tant que traces Live pendant une période mobile de 15 minutes.

Le Trace Explorer affiche un indicateur Live Search - All ingested data lorsque vous êtes en mode Live :

Indicateur Live Search

Toutes les traces ingérées passent ensuite par :

Le Trace Explorer affiche un indicateur Search - Only Indexed Data lorsque vous recherchez des spans indexées :

Indicateur Only Indexed

Le mode Live Search est sélectionné par défaut sur la page Traces. Utilisez le sélecteur d’intervalle en haut à droite pour passer du mode Live Search au mode Indexed Data Search.

Contrôle du volume des traces

Vous pouvez personnaliser les paramètres d’ingestion et de rétention afin d’envoyer et de conserver uniquement les données qui vous intéressent.

Ingestion

Contrôlez l’ensemble de votre volume avec les options de configuration de l’Agent Datadog ou définissez des règles d’ingestion précises pour chaque service instrumenté avec la solution APM Datadog.

Indexation

Après avoir instrumenté vos services et ingéré des traces, définissez des filtres de rétention basés sur des tags dans l’application Datadog pour que Datadog conserve uniquement les spans qui vous intéressent.

Remarque : les spans ingérées et indexées peuvent augmenter vos coûts. Pour en savoir plus, consultez la page Tarification d’APM.

Live Search pendant 15 minutes

Parcours d'une trace

En mode Live Search, Datadog affiche les spans dès qu’elles ont été envoyées par l’Agent Datadog et avant qu’elles aient été indexées par vos filtres de rétention. Toutes les spans ingérées sont affichées pour les 15 dernières minutes (période mobile) sans aucun échantillonnage.

Utilisez le mode Live Search avec vue sous forme de Liste pour :

  • Surveiller le bon déroulement d’un nouveau déploiement en recherchant l’attribut version_id de tous les tags.
  • Visualiser des informations sur les pannes en temps réel en recherchant un org_id ou customer_id spécifique associé à une span enfant problématique parmi 100 % des spans ingérées.
  • Vérifier si un processus a correctement démarré en saisissant process_id et en complétant automatiquement le nouvel identifiant de processus en tant que tag sur les spans enfant.
  • Surveiller l’impact des tests de charge sur vos endpoints en filtrant les métriques en fonction de la durée d’une ressource enfant.
  • Appliquer des requêtes de recherche en un seul clic sur n’importe quel tag ou span directement à partir du volet des traces.
  • Ajouter, supprimer et trier des colonnes à partir des tags de span pour obtenir un affichage personnalisé.

Le nombre de spans reçues par seconde est affiché en haut du tableau des traces. Étant donné qu’un flux de milliers de spans par seconde est difficilement lisible, seule une partie des spans est affichée en cas de volume élevé. Vous pouvez néanmoins effectuer des recherches parmi l’ensemble des spans disponibles. Utilisez les fonctions de filtrage de la barre de requête Live Search pour filtrer le flux de spans et le bouton Pause/Play en haut à droite pour interrompre ou relancer le flux.

Interrompre ou lancer le Live Stream

Remarque : lorsque vous sélectionnez une span, le flux s’interrompt et les détails de la span sélectionnée s’affichent dans le volet latéral de la trace.

Utilisez le bouton Timeseries pour visualiser vos spans sous forme de série temporelle et non sous forme de liste. Cette vue est utile pour représenter graphiquement les requêtes et les erreurs qui correspondent aux critères spécifiés, comme :

  • Les erreurs pour le service et l’endpoint ShoppingCart##checkout avec un panier d’au moins $100. Vous pouvez également consulter chacune des traces correspondant à ces critères.

  • Surveiller le déploiement Canary de n’importe quelle mise à jour d’application critique en temps réel.

  • Comparer la latence d’une région géographique à une autre pour la dernière version de votre application iOS.

En plus de visualiser les requêtes qui correspondent à vos recherches sous forme de série temporelle, vous pouvez consulter les clients, zones de disponibilités ou autres éléments les plus affectés sous forme de Top List pendant une panne ou une enquête.

Remarque : l’exportation vers un dashboard ou un monitor est uniquement possible avec les spans conservées.

Filtrage

Définissez une requête valide dans la barre de recherche pour afficher les traces qui correspondent à vos critères de recherche pour toutes les spans. La syntaxe de recherche en mode Live Search est la même que celle dans les autres vues. Toutefois, en mode Live Search, la recherche se fait parmi toutes les traces ingérées, pour tous les tags et toutes les spans, et non pas uniquement parmi celles qui ont été indexées.

Vous pouvez choisir d’interroger les spans de point d’entrée des services, les spans racines ou toutes les spans en modifiant l’option sélectionnée au-dessus du tableau des traces. Utilisez cette fonction sur les applications qui génèrent beaucoup de trafic pour réduire le nombre de spans affichées et ne visualiser que les spans de point d’entrée des services ou de la trace. Lorsque vous cochez cette case, seules les spans affichées dans la liste sont filtrées. Les autres spans continuent à être représentées dans le flamegraph lorsque vous cliquez sur une span pour afficher les détails de la trace.

Vous pouvez également rechercher des attributs qui ne sont pas définis en tant que facettes. Par exemple, pour rechercher l’attribut cart.value, deux options sont possibles :

  • Cliquez sur l’attribut cart.value dans le volet des traces et ajoutez-le à la requête de recherche :

  • Recherchez toutes les spans associées à l’attribut cart.value en saisissant « cart.value » dans la barre de requête de recherche :

Recherche de spans indexées avec rétention de 15 jours

Parcours d'une trace

La recherche de traces conservées se fait de la même façon qu’en mode Live Search. Pour passer du mode Live aux données conservées, modifiez le sélecteur d’intervalle pour choisir une durée supérieure à 15 minutes. Toutes les spans indexées par des filtres de rétention sont accessibles via la recherche. Ces spans sont conservées par Datadog pendant 15 jours après avoir été indexées par un filtre de rétention.

Toutes les spans indexées par des filtres de rétention personnalisés et le filtre de rétention intelligent peuvent être recherchées lorsque la vue sous forme de Liste est activée. Toutefois, si vous filtrez vos spans en fonction d’un tag qui figure uniquement dans des spans non indexées par un filtre de rétention, votre recherche n’affichera aucun résultat, ce qui n’est pas le cas en mode Live Search.

Toutes les spans indexées par des filtres de rétention personnalisés (et non par un filtre de rétention intelligent) peuvent être recherchées via l’analyse de traces.

Lorsque la vue sous forme de Série temporelle est activée, exportez votre requête vers un dashboard, un monitor ou un notebook pour effectuer une analyse plus poussée ou pour recevoir automatiquement une alerte lorsqu’un nombre agrégé de spans dépasse un certain seuil.

Configuration de la rétention

Vous pouvez personnaliser les spans qui sont conservées et leurs taux de rétention. Par défaut, le filtre de rétention intelligent de Datadog est appliqué. Il conserve automatiquement les traces associées à une variété d’erreurs et de latences ainsi que les traces liées à des ressources avec un trafic faible. Pour en savoir plus sur le filtre de rétention intelligent par défaut et découvrir comment créer vos propres filtres, consultez la documentation sur les filtres de rétention. Accédez à la page Retention Filters dans l’application Datadog pour créer ou modifier vos propres filtres.