L'agent Java attribue automatiquement un nom host:port à vos JVM. Si le nom par défaut n'est pas utile, vous pouvez définir un nom d'affichage pour distinguer vos JVM dans l'UI de New Relic. Pour le framework pris en charge, l'agent Java utilise le nominstance au lieu du nom d'affichage.
L'agent Java identifie de manière unique l'agent en cours d'exécution par son hôte, son port et son répartiteur, quel que soit l'environnement utilisé.
Noms d'affichage
Si host:port l'étiquette par défaut dans l'UI APM n'est pas utile, vous pouvez décorer ce nom dans l'UI de New Relic avec un nom d'affichage. Définissez le nom d'affichage via la configuration, soit dans une variable d'environnement, soit dans votre fichier de configuration newrelic.yml . La variable d'environnement a priorité sur la valeur du fichier de configuration. Une fois la JVM redémarrée et l'agent Java à nouveau opérationnel, le nom d'affichage s'affichera dans la liste JVM comme indiqué dans l'exemple ci-dessous en plus de host:port.
Pour définir un nom d’affichage :
- Définissez la variable d’environnement
NEW_RELIC_PROCESS_HOST_DISPLAY_NAME.\ OU - Définissez
process_host.display_namedans votre newrelic.yml.
Redémarrez JVM votre pour voir vos modifications dans l'UI de New Relic.
Conseil
Vous pouvez également définir le nom d’affichage avec une propriété système.
Noms d'instance
Pour les utilisateurs WebSphere et WebLogic, l'agent Java signale également le nom instance pour chaque instance de serveur d'applications active, qui est visible dans la page APM Settings > Environment. Généralement, ce nom est fourni par le serveur d'applications. Si un instance nom est défini, il sera utilisé à la place du nom d'affichage dans l'UI de New Relic.
priorité logique du nom d'hôte
S'il existe plusieurs paramètres de nom d'hôte (par exemple, vous utilisez WebSphere et définissez également la propriété display_name), l'agent utilise cette priorité :
display_nameremplace le nom par défaut et les noms d'instance WebSphere et WebLogic.- Les noms d'instance WebSphere et WebLogic remplacent le nom par défaut.
- Le nom par défaut (
host:port) a la priorité la plus basse.
Hôtes et identifiant unique agent
L'agent Java utilise des hôtes, des ports et des répartiteurs pour identifier de manière unique plusieurs JVM faisant référence au même nom d'application. Plusieurs agents exécutés sur le même serveur sont donc signalés séparément, à condition que leurs ports ou leurs noms de répartiteur diffèrent.
L'identifiant unique est basé sur les valeurs suivantes :
- Host: Un identifiant pour le serveur parent de votre application qui est dérivé du système d'exploitation. Cette valeur n'est pas configurable par l'agent Java.
- Port: Le port associé au serveur d'applications. Si l'agent ne peut pas déterminer le numéro de port ou si votre application ne s'exécute pas sur un serveur d'applications, la valeur par défaut est 0. Cette valeur est configurable par l'utilisateur.
- Dispatcher Name: Le nom du serveur d'applications. Par exemple, Apache Tomcat, Glassfish ou WebLogic. S'il n'y a pas de serveur d'applications actif, la valeur par défaut est Unknown.