New Relic connecte les métriques à l'application individuelle en utilisant votre clé de licence et le nom application principale. Vous pouvez modifier le nom de l'application dans votre fichier de configuration ou attribuer un alias à l'application pour modifier son apparence dans l'UI de New Relic .
Important
Si vous ne spécifiez pas le nom de l'application dans votre New Relic configuration fichier , la plupart des agents de New Relic fournissent un application nom générique par défaut. Pour garantir que toutes les données agrégées pour la même application sont signalées avec précision, assurez-vous de donner à chaque application un nom descriptif.
Changer le nom ou l'alias
Vous pouvez attribuer un nouveau nom d’application ou modifier l’alias de l’application. Ceux-ci ont deux effets différents :
Terme | How to change it | Effect |
|---|---|---|
Nom | La modification du nom de l'application dans le fichier de configuration de l'agent entraînera l'envoi de l'application vers un nouvel en-tête dans l'interface utilisateur New Relic, avec une discontinuité totale des données. Cela est utile, par exemple, si vous souhaitez recommencer et signaler de nouvelles données. Si aucun autre agent ne fait rapport à l'ancien nom d'application, l'ancien nom d'application apparaîtra en gris et pourra être supprimé. | |
Alias | La création d'un alias pour le nom de l'application modifie uniquement la manière dont le nom de l'application apparaît dans l'UI de New Relic. La modification de l’alias n’affecte pas la manière dont les données sont signalées. Il vous aide simplement à garder une trace de vos données avec un alias utile. |
Donnez à chaque application un nom descriptif
Par défaut, la plupart des agents New Relic fournissent un nom application par défaut, tel que My Application ou PHP Application, pour chaque application liée à votre compte.
Important
Nous vous recommandons de modifier le nom par défaut d'une application par un nom plus descriptif avant le déploiement, et il peut comporter jusqu'à 128 caractères.
Chaque nom d'application unique crée un nouvel application enregistrement dans votre UI de New Relic, ce qui vous permet de :
- Exécutez une application sur plusieurs hôtes et faites en sorte que toutes les données soient agrégées (collectées) sous le même nom.
- Exécutez plusieurs applications sur un seul hôte et ayez toutes les données agrégées (collectées) sous des noms différents.
Attribuez le nom dans votre fichier de configuration
Pour modifier le nom de l'application, définissez la valeur du nom de l'application dans le fichier de configuration de l'agent. Si vous avez déployé une application via un agent APM, puis déployé une autre application avec le même nom via un agent APM différent, New Relic ajoutera automatiquement le nom de la langue agent à la fin du nom de la deuxième application. Par exemple, si vous lancez une application Node.js nommée New-App, puis une application .NET nommée New-App, New Relic ajoutera automatiquement le nom de la deuxième application sous la forme New-App (DOTNET).
Afin de garantir le respect des conventions de dénomination, veuillez noter que les symboles < et > ne sont pas autorisés dans le nom de l'application. Si ces symboles sont inclus, ils seront automatiquement supprimés. Veuillez vous assurer que le nom de votre application respecte cette exigence.
Agent | Configuration file value |
|---|---|
C | Identifiez un maximum de trois noms séparés par un point-virgule |
Go | Définissez |
Java | Consultez les options permettant de nommer votre application Java. |
.NET | Utilisez l’une des options disponibles pour nommer votre application .NET. |
Node.js | Définissez |
PHP | Voir les options pour nommer votre application PHP. |
Python | Définissez |
Ruby | Définissez |
Changer l'alias de l'application
Le nom de l’application que vous définissez dans l’interface utilisateur New Relic est un alias lisible par l’homme. Si vous renommez votre application, le nom visible est mis à jour partout dans l'UI de New Relic, y compris dans les applications de navigateur liées .
Initialement, cet alias est le même que le nom de l'identifiant de l'application dans le fichier de configuration de l'agent New Relic. Cependant, la modification de l'alias UI does not affecte le nom de l'application sous-jacente utilisé pour rollup des données, qui est défini dans le fichier de configuration agent . L'application doit signaler activement des données pour modifier l'alias. La modification de l'alias UI entraînera le redémarrage de tous les agents qui relèvent de l'identifiant de l'application.
Pour modifier le alias du nom de votre application dans l'interface utilisateur New Relic :
- Allez à one.newrelic.com > All capabilities > APM & services > (select an app) > Settings > Application.
- Dans le champ Application alias , saisissez un nouveau nom (alias) pour l’application sélectionnée.
- Sélectionnez Save application settings.
Vous pouvez également modifier l'alias de l'application avec l'API REST New Relic.
Conseil
Lorsque vous effectuez une modification via Application settings, la modification enregistrée redémarre l'agent. Seul l'agent de ce service spécifique redémarrera, mais l'action ne redémarrera pas vos pools d'applications ou vos serveurs Web.
Utiliser plusieurs noms pour une application
En donnant plusieurs noms à votre application, vous pouvez agréger plusieurs agents sur l'ensemble d'une application ou d'un service.
Important
Si vous utilisez plusieurs noms pour une application, le dernier nom attribué est le nom le moins spécifique que New Relic utilise pour regrouper les données. Pour obtenir les meilleurs résultats, affichez à la fois les données au niveau instanceet les données agrégées, l'ordre des noms rollup de votre application, du plus spécifique au moins spécifique, dans votre fichier configuration .