Paramètres généraux de l’agent Java

Pour créer le répertoire des extensions :

1. Accédez au répertoire où se trouvent newrelic.jar et newrelic.yml . Créez un répertoire nommé extensions.
2. Dans newrelic.yml, vérifiez que la propriété extensions.dir n'est pas définie.

Pour utiliser un répertoire d’extensions Java existant :

1. Dans votre fichier newrelic.yml, recherchez la section common .
2. Utilisez la propriété extensions.dir pour spécifier l’emplacement du fichier.

Ce paramètre est required. Vous devez spécifier la clé de licence associée à votre compte New Relic. Cette clé lie les données de votre agent à votre compte dans le service New Relic.

Ce paramètre est required. Définit le nom de l'application utilisé pour signaler les données à New Relic.

Si enable_auto_app_naming est faux, l'agent signale toutes les données à cette application. Dans le cas contraire, l'agent signale uniquement les tâches d'arrière-plan (transactions pour les applications non Web) à cette application.

Pour signaler des données à plusieurs application, séparez les noms application par un point-virgule. Par exemple, pour signaler des données à My Application et My Application 2 utilisez ceci :

app_name: My Application;My Application 2

Pour plus de méthodes de dénomination de votre application, voir Nommer votre application Java.

Drapeau pour activer l'agent. Utilisez ce paramètre pour forcer l’agent à s’exécuter ou non.

Le seuil apdex_t en secondes pour le score Apdex de l'application. Pour les versions agent Java 1.2.008 ou supérieures, la valeur apdex_t est définie dans l'UI et la valeur dans newrelic.yml est ignorée.

Numéro permettant de différencier les JVM pour la même application sur la même machine. New Relic utilise l'hôte/port pour l'unicité, vous pouvez donc distinguer les JVM en plaçant un commutateur comme celui-ci dans les arguments de démarrage de chaque JVM :

-Dnewrelic.config.appserver_port=8081

Une fois que vous avez utilisé appserver_port pour nommer les JVM et les redémarrer, vous devriez pouvoir les voir individuellement dans la liste déroulante et dans l'interface de profilage.

Active le logging en texte brut de toutes les données envoyées à New Relic dans le fichier log de l'agent. Ce paramètre est dynamique, donc l'agent en cours d'exécution remarquera les modifications apportées à newrelic.yml sans redémarrage JVM .

Spécifie un chemin vers un ensemble de certificats SSL personnalisé qui sera utilisé par l'agent pour établir une connexion sécurisée à New Relic. Si votre ensemble de certificats SSL personnalisé n'inclut pas de certificats suffisants pour vous connecter à New Relic, vous devrez fusionner les certificats requis dans votre ensemble de certificats personnalisé.

Si plusieurs adresses sont détectées lors du cycle de connexion à un magasin de données, ce paramètre détermine l'adresse que l'agent choisira :

• NONEL'agent renvoie une adresse vide. Il s'agit du comportement par défaut.

• FIRST: Utilisez la première adresse détectée.

• LAST: Utilisez la dernière adresse détectée.

  Cette configuration existe dans la version 8.25.0 et suivantes de l'agent Java.

Permet la création de rapports de données séparément pour chaque application Web. Définissez sur true pour activer la prise en charge de la dénomination automatique des applications. Le nom de chaque application Web est détecté automatiquement et l'agent rapporte les données séparément pour chacune d'elles. Cela fournit une répartition plus précise des performances des applications Web dans New Relic.

Pour plus d'informations, voir Nommage automatique des applications.

Pour plus de méthodes de dénomination de votre application, voir Nommer votre application Java.

Permet la dénomination des transactions basée sur les composants. Définissez sur true pour activer la dénomination des transactions basée sur les composants. Définissez sur false pour utiliser l’URI d’une requête Web comme nom de la transaction. Pour plus d'informations, voir Nommage des transactions Web.

Active toute instrumentation utilisant une annotation @Trace . La désactivation de cette option entraîne l'ignorance de @Trace annotations.

Événement ingest URI utilisé par certaines fonctionnalités agent. La valeur par défaut est le point de terminaison d'ingestion de production américain. Peut être configuré manuellement pour envoyer l'événement à un autre point de terminaison d'ingestion (par exemple, production UE : https://insights-collector.eu01.nr-data.net/v1/accounts/events).

Les clients conformes à FedRAMP doivent utiliser le point de terminaison conforme à FedRAMP: https://gov-insights-collector.newrelic.com/v1/accounts/events

Définit l'emplacement du répertoire des extensions facultatives. Si cette propriété n'est pas définie, l'agent recherchera un sous-répertoire nommé extensions dans le même répertoire que newrelic.jar et newrelic.yml.

Pour que la haute sécurité soit activée, cette propriété doit être définie sur true et la propriété de haute sécurité dans l'interface utilisateur New Relic doit être activée. L'activation de la haute sécurité signifie que SSL est activé, que les paramètres de demande et de fichier d'attente des messages ne sont pas collectés et que la requête ne peut pas être envoyée à New Relic sous sa forme brute.

Fournit la possibilité de configurer un point de terminaison compatible FedRAMP pour l'agent à utiliser, avec la valeur gov-collector.newrelic.com.

Une clé API d'insertion valide pour votre compte. Ceci n'est pas actuellement utilisé par l'agent.

Attachez une étiquette à cette application.

Notez que cette option active désormais la balise, qui a remplacé la fonctionnalité d'étiquette. Vous pouvez toujours interroger vos étiquettes historiques. Plusieurs balises peuvent être attachées en utilisant un point-virgule comme séparateur comme suit :

-Dnewrelic.config.labels="tagName1:tagValue1;tagName2:tagValue2;tagName3:tagValue3"

Dans de rares cas, une fuite de mémoire peut se produire avec instrumentation qui utilise l'legacy asynchrone API pour suivre le cycle de vie des servlets asynchrones ou des Jetty continuations . La fuite de mémoire se manifesterait par des transactions divulguées qui ont été suspendues mais jamais reprises. Cette configuration agit comme une solution de contournement pour empêcher qu'un tel scénario ne se produise. Il est conseillé d'activer cette solution de contournement uniquement en cas de fuite de mémoire.

Limite le nombre de lignes que l'agent collecte à partir de chaque trace d'appels. L’augmentation de cette valeur peut avoir un impact sur les performances, car elle augmente la quantité de mémoire utilisée par l’agent et la quantité de données envoyées à New Relic.

Métrique ingest URI utilisé par certaines fonctionnalités agent . La valeur par défaut est le point de terminaison d'ingestion de production américain. Peut être configuré manuellement pour envoyer des métriques à d'autres points de terminaison d'ingestion (exemple d'URI de production UE : https://metric-api.eu.newrelic.com/metric/v1).

Les clients conformes à FedRAMP doivent utiliser le point de terminaison conforme à FedRAMP: https://gov-metric-api.newrelic.com/metric/v1

L'hôte proxy via lequel se connecter au collecteur New Relic. Si un proxy est utilisé, le paramètre hôte est requis. Les autres paramètres proxy sont facultatifs.

Le mot de passe pour l'authentification proxy. Si un proxy est utilisé, le paramètre hôte est requis. Les autres paramètres proxy sont facultatifs. Les paramètres de nom d'utilisateur et de mot de passe seront utilisés pour s'authentifier auprès des défis d'authentification de base à partir d'un serveur proxy.

Le numéro de port de l'hôte proxy. Si un proxy est utilisé, le paramètre hôte est requis. Les autres paramètres proxy sont facultatifs.

Le nom d'utilisateur pour l'authentification proxy, telle que l'authentification de base (texte clair). Si un proxy est utilisé, le paramètre hôte est requis. Les autres paramètres proxy sont facultatifs. Les paramètres de nom d'utilisateur et de mot de passe seront utilisés pour s'authentifier auprès des défis d'authentification de base à partir d'un serveur proxy.

Le schéma proxy utilisé. Le paramètre proxy_scheme: "https" permettra à l'agent de se connecter via des proxys en utilisant le schéma HTTPS.

Si des erreurs sont signalées pour Reactor Netty. La valeur par défaut est faux. Si défini sur vrai, les erreurs Reactor Netty seront signalées.

Activez l’arrêt différé de la JVM pour donner à l’agent une chance d’envoyer les dernières données de métrique à New Relic avant l’arrêt de la JVM.

Le nombre de secondes après lequel l'agent utilisera le paramètre send_data_on_exit.

Activer la création de rapports sur les paramètres JVM vers New Relic.

Lorsqu'il est défini sur true, les propriétés JVM seront envoyées à New Relic.

Nécessite des connexions au collecteur New Relic pour passer par SSL.

L'agent communique avec New Relic via HTTPS par défaut, et New Relic requiert HTTPS pour tout le trafic vers APMet l'API REST New Relic.

Ce travail est effectué de manière asynchrone par rapport aux threads qui traitent le code de votre application, de sorte que les temps de réponse ne seront pas directement affectés par ce changement.

Permettez à l'agent de connecter le collecteur New Relic immédiatement au démarrage de l'application.

Pour des détails de trace de transaction plus concis, l’agent ne signale pas les Futures Scala comme des segments de transaction, et ces Futures ne contribuent pas au temps total de la transaction.

L'activation de scala_futures_as_segments augmente vos frais généraux. Si vous souhaitez que Scala Futures génère des rapports sous forme de segments de transaction afin que vous puissiez les afficher dans une trace de transaction, vous pouvez l'activer :

scala_futures_as_segments:
  enabled: true

Lorsque le temps exclusif d'un segment est inférieur à 2 % du temps total de transaction, la métrique pour cet appel de méthode sera agrégée sous Java/other.

La définition de trim_stats sur false désactivera ce comportement, permettant aux métriques d'être affichées individuellement.

trim_stats: false

À partir de la version agent 8.7.0, si elle est définie sur true et que l'agent s'exécute avec JBoss EAP / Wildfly, cela empêchera l'agent d'exiger qu'une classe sous le package javax.management soit chargée par le chargeur de classes système. Ceci est ajouté pour aider à résoudre les problèmes de démarrage d'application avec les modules JBoss lorsque l'API de gestion J2EE/Jakarta est utilisée. Plus d'informations sont fournies dans le document de dépannage JBoss / Wildfly.

Drapeau expérimental qui permet à l'agent de s'exécuter avec des versions Java non prises en charge.

Définissez un nom d'affichage pour décorer l'étiquette « hôte : port » dans l'UI de New Relic . Nécessite l'agent Java 3.17 ou supérieur.

Chaîne contenant un chemin d'accès complet au fichier de configuration newrelic. Si vide, l'agent suppose que newrelic.yml se trouve dans le même répertoire que newrelic.jar.

Activer le logging de débogage.

Chaîne contenant la configuration de l'environnement que l'agent doit utiliser.

Chaîne contenant le répertoire personnel de l'agent. La valeur par défaut est le même répertoire que le fichier jar de l'agent.

Chaîne contenant le nom du agent fichier de log.