New Relic collecte et rapporte des informations sur les transactions Web et non Web, telles que les tâches en arrière-plan. New Relic produit normalement des informations complètes automatiquement, sans qu'il soit nécessaire de modifier le code de votre application. Cependant, si vous n’utilisez pas un framework pris en charge, vous devrez peut-être ajouter une instrumentation personnalisée.
L'instrumentation personnalisée est également utile pour :
- Ajoutez des détails à votre trace de transaction.
- Bloquez instrumentation sur les transactions sélectionnées que vous ne souhaitez pas instrumenter.
- instrumentez une partie de votre code que New Relic ne capte tout simplement pas.
instrumentation personnalisée qui crée une nouvelle transaction collecte à la fois des données d'intervalle de temps métrique et d'événement . instrumentation personnalisée pour les transactions déjà instrumentées ne collecte que des données d'intervalle de temps métrique.
Important
N'utilisez pas de crochets [suffix] à la fin du nom de votre transaction. New Relic supprime automatiquement les crochets du nom. Utilisez plutôt des parenthèses (suffix) ou d’autres symboles si nécessaire.
Quand utiliser une instrumentation personnalisée
L'instrumentation personnalisée vous permet de suivre les interactions qui ne sont pas capturées par l'instrumentation automatique de New Relic. L'instrumentation personnalisée peut également ajouter des détails à votre trace de transaction, pour vous aider à identifier les problèmes clés.
New Relic collecte automatiquement les données de nombreux frameworks. Si vous utilisez un frameworkpris en charge, vous ne devriez pas avoir besoin instrumentation personnalisée pour collecter les tranches de temps métriques, les événements et les traces.
Cependant, si vous rencontrez l’une de ces situations, vous aurez peut-être besoin d’une instrumentation personnalisée :
- Les transactions n'apparaissent pas dans l'UI.
- Les traces de transaction incluent de gros blocs de code application sans détails complets.
Si vous utilisez un framework pris en charge, mais que vous ne voyez pas de transaction sur la page APMTransactions , obtenez de l'aide sur support.newrelic.com pour vous assurer que l'instrumentation du framework fonctionne.
Mettre en œuvre une instrumentation personnalisée
Chaque agent implémente l'instrumentation personnalisée différemment :
Problèmes de regroupement
Un problème de regroupement métrique se produit lorsqu'un compte envoie trop de tranches de temps métriques nommées différemment à New Relic et que ces transactions Web individuelles ne sont pas correctement agrégées. Par exemple, au lieu d’un seul nom de métrique /user/controlpanel/ , vous pourriez voir /user/controlpanel/alice, /user/controlpanel/bob et /user/controlpanel/carol.
instrumentation personnalisée peut entraîner des problèmes de regroupement métrique si vous introduisez trop de tranches de temps métriques nommées de manière unique que New Relic ne peut pas regrouper efficacement. Si vous envoyez des milliers de métriques, New Relic peut appliquer des règles pour réduire le nombre de transactions.