Pour un framework entièrement pris en charge(.NET Framework | .NET Core), l'agent .NET de New Relic collecte et signale automatiquement des informations sur les tâches de transaction Web et de navigateur. Cependant, si vous utilisez un application framework qui n'est pas automatiquement instrumenté (ou n'utilisez pas de framework), vous pouvez voir de grands blocs de temps dans l'UI de New Relic manquant de détails, ou vous pouvez ne voir aucune transaction. Dans ce cas, vous pouvez utiliser une instrumentation personnalisée pour ajouter des transactions et des détails.
Ce document décrit comment instrumenter une activité qui n'est pas instrumentée par l'agent .NET par défaut. Pour d'autres façons de configurer instrumentation de votre application, consultez le Guide d'utilisation de l'API .NET d'agent.
Important
Pour les deux frameworks supportés par l'agent(.NET framework et .NET Core), instrumentation personnalisée s'effectue de la même manière, sauf mention contraire.
Choisissez une méthode d'instrumentation personnalisée
L'agent .NET prend en charge deux méthodes d'instrumentation personnalisée :
Méthode | Description |
|---|---|
attribut instrumentation personnalisée | instrumentez votre code en décorant vos méthodes avec un attribut. instrumentation d'attribut est plus simple à implémenter que instrumentation XML car vous n'avez besoin d'ajouter qu'un seul décorateur, au même endroit dans votre code que la méthode que vous souhaitez instrument. Pour les instructions, voir instrumentation personnalisée via attribut. |
instrumentation XML personnalisée | instrumentez votre code en listant les méthodes cibles dans un fichier XML. instrumentation XML est plus complexe que instrumentation d'attribut et échouera si vous modifiez le nom de l'assembly, de la classe ou de la méthode que vous souhaitez instrument. Cependant, l’instrumentation XML ne nécessite pas de modifier votre code source. Pour obtenir des instructions, consultez Créer des transactions via XML et Ajouter des détails aux transactions via XML. |
Créer des transactions ou ajouter des détails
Lorsque vous ajoutez une instrumentation personnalisée via l'une ou l'autre méthode, vous devez choisir entre la création d'une nouvelle transaction et l'ajout d'une instrumentation à une transaction existante :
Situation | Recommandation |
|---|---|
La méthode que vous souhaitez instrumenter n'apparaît pas du tout dans l'UI New Relic | Create a new transaction. Pour plus de détails, voir : |
La transaction apparaît dans l'UI de New Relic mais contient des sections de temps non instrumentées | Add detail to an existing transaction. Pour plus de détails, voir : |
Classer comme « Web » ou « non Web » (méthode d'attribut uniquement)
APM sépare les transactions en transactions Web et transactions non Web dans l'UI. Lorsque vous ajoutez des détails à une transaction existante, sa catégorie est déterminée par la catégorie de la transaction parent.
Lorsque vous créez une transaction via une instrumentation personnalisée à l'aide de la méthode d'attribut, vous devez la catégoriser comme web ou non-web. (Ce n'est pas possible avec l'instrumentation XML ; toutes les transactions créées en XML sont classées comme non-web.)
Catégorie | Quand l'utiliser |
|---|---|
Web | Utilisez web pour requests Web. Vous ne pouvez marquer les nouvelles transactions comme des transactions Web avec instrumentation personnalisée qu'en utilisant l'attribut, et non en utilisant XML. |
Hors Web | Utilisez non-web pour d’autres types de requests en arrière-plan, telles que les applications et services de console.
|