Notre API de trace est utilisée pour envoyer des données de tracing distribué à New Relic : soit dans notre propre format générique, soit dans le format de données Zipkin . Cette API permet également de transmettre à New Relic les données trace provenant de certaines de nos intégrations et exportateurs.
Vous souhaitez tester l'API de trace ? Assurez-vous d'avoir créé un compte New Relic gratuit. Aucune carte de crédit requise.
Pour ignorer une partie du contenu d'introduction et démarrer rapidement, accédez à Commencer à générer des rapports de données.
Qu'est-ce que l'API de trace ?
L'API de trace est l'un des moyens par lesquels New Relic collecte les données de tracing distribué. Nous disposons de quelques outils de tracing qui rapportent des données via cette API (Infinite Tracing, notre intégrationopen source et nos SDK de télémétrie), ou vous pouvez utiliser l'API directement pour créer votre propre implémentation de tracing.
Raisons d'utiliser l'API trace :
- Vous disposez de votre propre outil de tracing distribué personnalisé et souhaitez voir ces données dans New Relic sans modifier votre instrumentation.
- Vous disposez d'un outil qui émettre des données de tracing mais qui nécessite un backend pour le stockage trace .
- Vous souhaitez signaler le tracing distribué des données à New Relic sans utiliser nos solutions installées.
- Vous utilisez Zipkin et souhaitez voir ces données de trace dans New Relic sans modifier votre instrumentation.
Vous souhaitez comprendre comment les données de trace sont liées aux autres données New Relic ? En savoir plus sur nos types de données.
Exigences
Pour plus de détails sur les données que vous pouvez envoyer et sur la manière dont elles sont traitées, consultez Règles et limites.
Considérations relatives à l'échantillonnage
Lorsque vous utilisez l'API de trace, vous avez la possibilité d'activer l'Infinite Tracing. L'utilisation ou non d'Infinite Tracing a des implications sur la manière dont vous configurez l'échantillonnage :
- Use your own sampling (no Infinite Tracing): Si vous n'utilisez pas Infinite Tracing, il est supposé que vous souhaitez utiliser votre propre implémentation d'échantillonnage pour échantillonner le tracing avant de nous l'envoyer. (Si vos données de trace dépassent nos limites de données, nous procédons à un échantillonnage.)
- Use Infinite Tracing: Si vous souhaitez utiliser Infinite Tracing, une approche typique consiste à nous envoyer 100 % de vos données de trace et à vous fier à l'échantillonnage d'Infinite Tracing. (Lorsque vous suivez les instructions de démarrage des rapports de données ci-dessous, vous aurez la possibilité d'activer l'Infinite Tracing.)
Commencer à signaler des données
L'API de trace accepte les données trace dans ces deux formats JSON :
zipkin: le format de données de trace Zipkin JSON v2 (découvrez ce qu'est Zipkin). Commencez à envoyer des données Zipkin.newrelic: notre format général. Si vous n'avez pas de données au format Zipkin, utilisez ceci. Commencez à envoyer des données au format New Relic.
Vous rencontrez des difficultés pour obtenir des données à signaler ? Voir dépannage.
Rechercher des données
Vous pouvez trouver les données envoyées via l'API de trace, ou depuis l'intégration qui utilise cette API, à ces emplacements :
- Dans notre UI de tracing distribué.
- En interrogeant : Pour plus de détails sur la manière d'interroger et de créer des graphiques personnalisés, consultez requête tracing distributor data.
Prochaines étapes
Voici quelques étapes supplémentaires à prendre en compte :
- Apprenez-en davantage sur le fonctionnement du tracing distribué et sur la structure des données.
- Décorez les données de travée avec l'attribut personnalisé.
- Utilisez notre API NerdGraph basée sur GraphQL pour interroger par programmation vos données trace .