Aperçu

L’Explorateur de traces vous permet de rechercher tous les spans ingérés ou indexés en utilisant n’importe quelle balise sur n’importe quel span. Les spans trouvés par votre requête changent en fonction de si vous recherchez des spans en direct (tous les spans ingérés dans les 15 dernières minutes, en continu) ou des spans indexés (spans conservés pendant 15 jours par vos filtres personnalisés).

Les applications instrumentées envoient des traces à Datadog en fonction de vos contrôles d’ingestion configurés. Les traces ingérées sont disponibles en tant que traces en direct pour une fenêtre de 15 minutes.

L’Explorateur de traces affiche un indicateur Recherche en direct - Toutes les données ingérées chaque fois que vous êtes en mode Live :

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

• Filtres de rétention personnalisés que vous pouvez créer pour déterminer quels spans indexer. Une fois indexées par un filtre de rétention personnalisé, les traces sont conservées pendant 15 jours.
• Le filtre de rétention intelligent par défaut qui conserve un ensemble diversifié de traces. Lorsqu’elles sont indexées par le filtre de rétention intelligent, les traces sont conservées pendant 30 jours.

L’Explorateur de traces affiche un indicateur Recherche - Données uniquement indexées chaque fois que vous recherchez des spans indexés :

La recherche en direct est la vue par défaut sur la page des traces. Passez de la recherche en direct à la recherche de données indexées en utilisant le sélecteur de temps dans le coin supérieur droit.

Modèles de traces

Les modèles de traces regroupent les spans ayant une structure et des attributs similaires en modèles récurrents, afin que vous puissiez analyser le comportement à travers des milliers de traces à la fois au lieu de les lire individuellement. Utilisez les modèles de traces lorsque une requête renvoie trop de spans à examiner trace par trace, comme pour trouver quelles formes d’erreur sont nouvelles cette semaine ou quels modèles de latence ont changé après un déploiement.

Contrôle du volume des traces

Vous pouvez personnaliser les paramètres de rétention et d’ingestion 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és et indexés peuvent avoir un impact sur votre facture. Pour plus d’informations, consultez APM Billing.

Recherche en direct pendant 15 minutes

Lorsque vous utilisez la recherche en direct, Datadog affiche les spans dès qu’ils sont envoyés par l’Agent Datadog et avant qu’ils ne soient indexés par vos filtres de rétention. Tous les spans ingérés sont disponibles pour les 15 dernières minutes (fenêtre glissante), affichés sans aucun échantillonnage.

Avec la vue en liste, vous pouvez :

• Surveiller si un nouveau déploiement s’est bien déroulé en filtrant sur version_id de tous les tags.
• Voir les informations liées aux pannes en temps réel en recherchant 100 % des traces ingérées pour un org_id ou customer_id particulier associé à un span enfant problématique.
• Vérifiez si un processus a correctement démarré en tapant process_id et en autocomplétant le nouvel ID de processus comme tag sur les spans enfants.
• Surveiller l’impact des tests de charge et de performance sur vos points de terminaison en filtrant sur la durée d’une ressource enfant.
• Exécutez des requêtes de recherche en un clic sur n’importe quel span ou tag directement depuis la vue du panneau de traces.
• Ajoutez, supprimez et triez des colonnes à partir des tags de span pour une vue personnalisée.

Le nombre de spans reçus par seconde est affiché en haut du tableau des traces. Étant donné qu’un flux de milliers de spans par seconde n’est pas lisible par un humain, les flux de spans à haut débit affichent certains spans pour plus de clarté visuelle. Vous pouvez rechercher tous les spans disponibles dans la requête de recherche. Utilisez les fonctionnalités de filtrage de la barre de requête de recherche en direct pour filtrer le flux de spans et le bouton Pause/Play en haut à droite de l’écran pour mettre en pause ou reprendre le flux.

Remarque : Sélectionner un span met le flux en pause et affiche plus de détails sur le span sélectionné dans le panneau latéral des traces.

Visualisez vos spans sous forme de séries temporelles au lieu d’une liste en utilisant la vue des séries temporelles. La vue des séries temporelles de recherche en direct est utile pour tracer des requêtes ou des erreurs qui correspondent à des critères spécifiés, tels que :

• Erreurs pour le ShoppingCart##checkout service et point de terminaison, avec une valeur de panier d’au moins $100, avec la possibilité de visualiser les traces correspondant à ces critères individuellement.

• Surveillez un déploiement canari d’une mise à jour critique d’application en temps réel.

• Comparez la latence à travers les régions géographiques limitées à 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 des tableaux de bord et des moniteurs n’est possible qu’avec des spans conservés.

Filtrage

Une requête valide dans la barre de recherche affiche les traces qui correspondent à vos critères de recherche à travers tous les spans. La syntaxe de recherche est la même dans les vues de recherche en direct que dans les autres vues de traces, mais ici, votre requête est comparée à toutes les traces ingérées à travers n’importe quel span et n’importe quel tag, et pas seulement celles indexées.

Vous pouvez choisir de requêter les spans d’entrée de service, les spans racines, ou tous les spans en changeant la sélection dans la boîte au-dessus du tableau des traces. Utilisez cette fonctionnalité sur des applications à fort trafic pour réduire le nombre de spans affichés et ne visualiser que les spans de point d’entrée des services ou le point d’entrée de la trace. Sélectionner cette case ne filtre que les spans affichés dans la liste ; les autres sont toujours affichés dans le graphique de flammes lorsque vous cliquez sur un span pour voir les détails de la trace.

Vous pouvez également filtrer sur des attributs qui ne sont pas définis comme facettes. Par exemple, pour filtrer sur l’attribut cart.value, il y a deux options :

• Cliquez sur l’attribut cart.value dans le panneau des détails de la trace et ajoutez-le à la requête de recherche :

• Filtrer sur tous les spans avec un attribut cart.value en tapant “cart.value” dans la barre de recherche :

Analyser les anomalies avec des insights intégrés

L’Explorateur de traces combine la détection automatisée des valeurs aberrantes par Watchdog avec l’analyse des TAG pour vous aider à identifier rapidement la cause profonde des problèmes. Lorsque Watchdog détecte des tags qui sont statistiquement sur-représentés dans les erreurs ou les spans à haute latence, ces insights sont affichés à plusieurs endroits :

• Suggestions de recherche : Au fur et à mesure que vous tapez dans la barre de recherche, les tags aberrants apparaissent comme suggestions avec un indicateur montrant qu’ils sont corrélés avec des erreurs ou des problèmes de latence.
• Recommandations de regroupement : Lors de la sélection des attributs à regrouper, les facettes aberrantes sont mises en évidence pour guider votre enquête.
• Barre latérale des facettes : Les tags aberrants sont promus en haut de la liste des facettes dans une section dédiée “OUTLIERS”.
• Métriques RED : Le bouton “Analyser” à côté des graphiques d’erreurs et de latence est mis en évidence lorsque des valeurs aberrantes pertinentes sont détectées.

Recherche des spans indexés avec une rétention de 15 jours

Vous pouvez rechercher des traces conservées de la même manière que vous effectuez une recherche en direct. Pour passer de la recherche de données en direct à la recherche de données conservées, changez le sélecteur de temps pour une période supérieure à 15 minutes. Tous les spans qui sont indexés par les filtres de rétention sont accessibles depuis la recherche. Ces spans sont conservés par Datadog pendant 15 jours après avoir été indexés par un filtre de rétention.

Configuration de la rétention

Vous pouvez personnaliser quels spans sont conservés et à quels taux de rétention. Par défaut, le filtre de rétention intelligent de Datadog est appliqué, ce qui conserve automatiquement les traces présentant une diversité en termes d’erreurs et de latence, ainsi que des ressources à faible débit. Pour en savoir plus sur le filtre de rétention intelligent par défaut et comment créer vos propres filtres supplémentaires, consultez la documentation des filtres de rétention. Allez à la page des filtres de rétention dans l’application Datadog pour créer ou modifier vos propres filtres.

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Rechercher des spansDOCUMENTATION Premiers pas avec les métriques et traces APMCENTRE D'APPRENTISSAGE Diagnostic des bogues d'application avec Datadog APMCENTRE D'APPRENTISSAGE