Le tracing distribué vous permet de voir l'intégralité du parcours de vos requests à travers un systèmes distribués. Pour l'agent .NET, nous proposons deux types de tracing distribué (pour plus de détails, voir Comment fonctionne l'échantillonnage de portée) :
Standard (échantillonnage en tête) : avant l'arrivée de toute trace, nous déterminons un pourcentage défini de traces à accepter et analyser. Cela vous donne un point de départ solide pour voir comment le traçage peut vous aider. Il est activé par défaut dans les agents .NET 9.0.0.0 et versions ultérieures. Par défaut, l'agent .NET échantillonne 10 traces par minute, avec une limite maximale de 2 000 spans par minute.
Infinite Tracing (échantillonnage basé sur la queue) : Notre service basé sur le cloud accepte toutes vos traces et les trie ensuite pour trouver les plus importantes. Infinite Tracing analyse toutes vos traces et vous offre des options de configuration pour échantillonner les traces qui comptent le plus pour vous.
Que vous souhaitiez simplement tester le tracing standard distribué (échantillonnage en début de workflow) ou que vous souhaitiez également mettre en place Infinite Tracing (échantillonnage en fin de workflow), vous devez commencer par mettre en place le tracing standard.
Tracing standard distribué
Il s’agit de la meilleure approche pour configurer le tracing standard distribué si vous n’avez pas encore installé d’agent APM pour vos services.
Conseil
Lorsque vous installez New Relic l'agent .NET, le tracing standard distribué est activé par défaut. Si vous préférez le désactiver, consultez notre guide de configuration.
Identifier les services
Déterminez quels services touchent à votre demande afin de pouvoir instrumenter chacun d'eux pour envoyer des données trace à New Relic.
instrumenter chaque service avec un agent APM
Pour chaque service impliqué dans vos transactions, vous effectuerez une installation distincte de l'agent. Si certains de vos services utilisent d’autres langues, répétez simplement les étapes d’installation pour ces langues.
Pour démarrer la routine d'installation, cliquez sur la tuile ci-dessous. Une fois l'installation de chaque agent terminée, revenez ici pour voir des conseils pour visualiser votre trace.
Afficher la trace
Après avoir instrumenté chacun de vos services avec l'agent APM, générez du trafic dans votre application afin que nous puissions capturer une trace. Voici quelques façons d'afficher votre trace dans l'UI:
Pour plus d'aide pour trouver votre trace dans l'UI:
Infinite Tracing (optionnel)
Avec Infinite Tracing (échantillonnage basé sur la queue), nous pouvons analyser toutes vos données et déterminer quelles traces sont les plus pertinentes.
Terminez la configuration pour le tracing standard distribué
La configuration Infinite Tracing s'appuie sur le tracing standard distribué. Assurez-vous donc d’avoir terminé les étapes ci-dessus, puis continuez avec la configuration de l’observateur de trace.
Configurer l'observateur de trace
L'observateur de trace est un service New Relic basé sur AWSqui collecte et analyse toutes vos traces. Suivez les instructions dans Configurer Trace Observer. Une fois que vous avez terminé, revenez ici avec les informations de votre observateur de trace et passez à l’étape suivante pour configurer l’agent.
Configurer l'agent pour Infinite Tracing
Les paramètres configuration d'Infinite Tracing incluent le tracing standard distribué ainsi que des informations sur l'observateur de trace. Notez que la configuration côté serveur n'est pas disponible pour Infinite Tracing.
Conseil
Si vous avez besoin d'aide avec la configuration du proxy, consultez Assistance proxy.
(Facultatif) Personnaliser Infinite Tracing
Après avoir ajouté les agent configuration paramètres, vous devriez commencer à voir les données dans l’UI de New Relic. Après avoir passé un certain temps à analyser vos données, vous souhaiterez peut-être ajuster certaines fonctionnalités d'Infinite Tracing :
instrumentation manuelle (si instrumentation automatique ne fonctionne pas)
Recommandation : Avant de procéder à une instrumentation personnalisée, lisez :
L'agent .NET envoie automatiquement des données de tracing sur les canaux IPC (fichier d'attente des messages, par exemple) lorsqu'il instrumente automatiquement un client pour ce canal (RabbitMQ.Client, par exemple). Si vos services communiquent à l'aide d'un mécanisme IPC que l'agent n'instrumente pas automatiquement, vous devez utiliser l'API de l'agent de tracing distribué pour propager les données de tracing entre les services.
Important
Pour que l'API de tracing manuel fonctionne, le canal de communication que vous utilisez doit prendre en charge une sorte de stockage de paires valeur-clé (un « transporteur ») associé aux messages transmis. Ceci est parfois appelé « en-têtes » ou « sac de propriétés », mais cela dépendra de la bibliothèque de messagerie avec laquelle vous travaillez.
Voici un exemple que vous pouvez créer et exécuter pour montrer comment cela fonctionne.