L'agent Java New Relic lit sa configuration à partir du fichier newrelic.yml . Par défaut, l'agent recherche ce fichier dans le répertoire qui contient newrelic.jar. Vous pouvez remplacer l'emplacement du fichier de configuration en définissant la propriété système newrelic.config.file sur un nom de fichier complet.
Vous pourrez configurer notre agent Java en fonction de votre environnement après avoir créé un compte New Relic (c'est gratuit, pour toujours) et installé l'agent Java.
Structure du fichier de configuration
Le fichier newrelic.yml comporte des sections distinctes pour différents environnements :
- Test
- Développement
- Simulation
- Production (par défaut)
New Relic applique les paramètres de la section common à chacun de ces environnements. Vous pouvez sélectionner d’autres environnements par défaut en définissant la propriété système newrelic.environment sur le nom de l’environnement.
Conseil
Un modèlenewrelic.yml est disponible.
Si vous éditez newrelic.yml, veillez à respecter le format YAML. Utilisez un validateur YAML pour vous assurer que la syntaxe est exacte avant d'utiliser le fichier avec l'agent Java de New Relic et suivez ces règles :
Java agent newrelic.yml | Requirements |
|---|---|
Format | Les fichiers YML sont sensibles à la casse. |
Indentations | Toutes les indentations doivent être incrémentées de deux caractères. D’autres indentations entraîneront une erreur
|
Modifications apportées au fichier | Vous devez redémarrer votre processus hôte JVM pour que les modifications prennent effet. Exception: Les modifications de propriété apportées à |
Priorité des paramètres de configuration
Pour remplacer un paramètre dans le fichier de configuration, utilisez une propriété système override. Dans certains environnements, les variables d'environnement peuvent également être utilisées pour remplacer à la fois le fichier de configuration et les propriétés système. Les variables d'environnement existent principalement pour prendre en charge Heroku. Lorsqu'elle est utilisée, la configuration côté serveur remplace tous les autres paramètres de configuration.
Avec l'agent Java, la configuration côté serveur remplace tous les autres paramètres. Les variables d’environnement remplacent les propriétés du système Java. Les propriétés Java remplacent les paramètres de configuration utilisateur dans votre fichier newrelic.yml . Les paramètres utilisateur remplacent les paramètres par défaut newrelic.yml .
Configuration du répertoire des extensions Java
L'agent Java lit les fichiers de configuration au démarrage du processus. Pour identifier le répertoire dans lequel se trouvent les fichiers, créez un nouveau répertoire d'extensions ou spécifiez un répertoire d'extensions existant :
Index des paramètres
Les pages suivantes contiennent la référence complète des paramètres pour chaque zone de configuration :
| Page des paramètres | Description |
|---|---|
| Paramètres généraux | Paramètres principaux : clé de licence, nom de l'application, proxy, haute sécurité, extensions |
| Paramètres du traceur de transactions | Tracing de transaction, capture SQL, événements de transaction, segments, traceur de messages |
| Paramètres du collecteur d’erreurs | Collecte des erreurs, classes ignorées/attendues et codes d'état, Errors Inbox |
| Paramètres de tracing distribué | Tracing distribué, Infinite Tracing, événements de span, traceur inter-applications |
| Paramètres de Logs en contexte | Transfert de logs, métriques de logs, décoration locale, configuration du logging |
| Paramètres des attributs | Filtrage des attributs, listes d'inclusion/exclusion, mode d'attribut HTTP |
| Paramètres de sécurité | Agent de sécurité IAST, paramètres de détection des vulnérabilités |
| Paramètres de monitoring de l’IA | Monitoring de l'IA et enregistrement du contenu LLM |
| Paramètres de monitoring des navigateurs | Auto-instrumentation de l'agent Browser et configuration des attributs |
| Paramètres d’instrumentation asynchrone | Configuration du délai d’expiration du jeton et du segment asynchrones |
| Paramètres OpenTelemetry | Configuration des signaux de trace, de métriques, et de log OpenTelemetry |
| Paramètres JFR | Profilage en temps réel de Java Flight Recorder |
| Paramètres du transformateur de classe | Nommage des transactions Spring, annotations de trace, tracing Lambda |
| Paramètres JMX | Monitoring JMX et métadonnées de liaison |
| Autres paramètres | Disjoncteur, configuration cloud, utilisation, événements personnalisés, collecteur de jar, obfuscation de la JVM, profileur de threads, et plus |
Important
Les deux paramètres que vous devez configurer sont le nom de votre application et la clé de licence, définis via app_name et license_key dans newrelic.yml (ou les variables d’environnement NEW_RELIC_APP_NAME et NEW_RELIC_LICENSE_KEY). Tous les autres paramètres sont facultatifs.