L'agent .NET de New Relic vous offre plusieurs façons de modifier le nom de l'application signalé et affiché dans APM. Ce document vous donne un aperçu de ces options de dénomination.
Pour un aperçu général de la dénomination des applications APM (non spécifique à .NET), voir Nommez votre application. Pour modifier le nom d'une application sans interrompre la continuité des données, utilisez l'option UI alias-change.
Définissez le nom de votre application (méthode recommandée)
Lorsque vous déployez votre application pour la première fois, vous pouvez modifier le nom par défaut pour un nom plus descriptif. Étant donné que New Relic collecte les métriques à l'aide de ces noms, leur personnalisation vous permet d'exécuter la même application sur plusieurs hôtes et d'obtenir les métriques de toutes leurs instances.
En règle générale, la configuration de votre fichier newrelic.config local d'application est la méthode de dénomination la plus pratique.
Méthode de dénomination | Description |
|---|---|
Recommandé: Configurez votre fichier | Cette méthode vous permet de donner à votre application un nom unique avec des paramètres de configuration spécifiques. Il fonctionne également pour les applications hébergées par IIS et non IIS.
|
Tant que votre application est active, les données devraient apparaître en quelques minutes. Dans le cas contraire, suivez nos procédures de dépannage.
Autres méthodes
Si vous avez une utilisation ou un objectif spécifique en tête, vous préférerez peut-être une méthode de dénomination différente. Voici une liste complète des méthodes alternatives :
Important
Certaines méthodes ont la priorité sur d’autres. Avant de choisir une méthode de dénomination, assurez-vous de bien comprendre comment votre configuration peut être affectée.
Méthode de dénomination | Description |
|---|---|
Configurez votre fichier | Si vous avez des applications hébergées sur IIS et que vous préférez ne pas avoir de fichier |
Définir le nom de l'application à l'aide de variables d'environnement | Si vous souhaitez définir facilement les noms des applications lors du déploiement du conteneur, définissez une variable d'environnement dans l'environnement de l'application. |
Nom d'après les pools d'applications | Si vos pools d'applications IIS ont déjà des noms uniques que vous aimez, ou si vous utilisez une infrastructure de contenu réseau partagé (SNCI), vous pouvez nommer votre application d'après son pool d'applications attribué. |
Configurez votre fichier | Si vous avez une application non hébergée sur IIS et que vous préférez ne pas avoir de fichier |
Utiliser l'API de l'agent .NET | Si vous souhaitez renommer votre application par programmation, vous pouvez utiliser l'appel |
Tant que votre application est active, les données devraient apparaître en quelques minutes. Dans le cas contraire, assurez-vous d’avoir exécuté une commande IISRESET à partir d’une invite de commande administrative si vous avez modifié le fichier de configuration de votre application .NET (newrelic.config ou app.config). Sinon, suivez nos procédures de dépannage.
Utiliser plusieurs noms d’application
Vous pouvez utiliser plusieurs noms d’application pour regrouper les données de votre application. Nous appelons parfois cela « regrouper » vos données.
Pour l'agent .NET, vous pouvez définir jusqu'à trois noms d'application. Le premier nom est le nom de l’application principale, et les deuxième et troisième noms sont utilisés pour les catégories d’agrégation de données plus générales. Pour en savoir plus sur le fonctionnement de plusieurs noms d’applications, consultez Utiliser plusieurs noms d’applications.