Configuration de l'agent .NET

Pour .NET Framework, les variables suivantes sont requises :

COR_ENABLE_PROFILING=1
COR_PROFILER={71DA0A04-7777-4EC6-9643-7D28B46A8A41}
NEWRELIC_INSTALL_PATH="INSERT_THE_PATH_TO_THE_AGENT_DIRECTORY"

Le Windows agent programme d'installation .NET (.msi) les ajoutera à IIS par défaut, ou en tant que variables d'environnement à l'échelle du système lors de l'activation Instrument All de.

Lorsque vous utilisez le programme d’installation de l’agent Windows .NET, assurez-vous que NEWRELIC_INSTALL_PATH est défini sur C:\Program Files\New Relic\.NET Agent\. C'est ici que les DLL de l'agent sont placées sur le système.

Pour plus de détails sur ces variables, ainsi que sur les valeurs correctes pour d'autres scénarios d'installation, veuillez consulter Comprendre les variables d'environnement de l'agent .NET.

Lors de l'installation de l'agent via le package Nuget, l'agent nécessite un ensemble différent de variables d'environnement.

Pour .NET Core, les variables suivantes sont requises :

Linux:

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME=path/to/agent/directory
CORECLR_PROFILER_PATH="${CORECLR_NEWRELIC_HOME}/libNewRelicProfiler.so"

Windows (MSI Installer):

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent\
CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\

Le Windows agent programme d'installation .NET les ajoutera à IIS par défaut ou en tant que variables d'environnement à l'échelle du système lors de l'activation Instrument All de. Exception : CORECLR_ENABLE_PROFILING doit être défini manuellement pour instrumenter une application .NET Core non hébergée par IIS. Voir Compatibilité et exigences pour .NET Framework pour l'application .NET Framework.

Pour plus de détails sur ces variables, ainsi que sur les valeurs correctes pour d'autres scénarios d'installation, veuillez consulter Comprendre les variables d'environnement de l'agent .NET.

Lors de l'installation de l'agent via le package Nuget sous Windows, l'agent nécessite un ensemble différent de variables d'environnement.

L'agent .NET de New Relic s'appuie sur des variables d'environnement pour indiquer au .NET Common Language Runtime (CLR) de charger New Relic dans vos processus. Les variables d’environnement liées à l’installation sont des variables Microsoft et non des variables New Relic. Ils peuvent être utilisés par d’autres profileurs .NET, et un seul profileur peut être attaché à un processus à la fois. Pour cette raison, si vous avez utilisé des produits monitoring d'applicationantérieurs, vous pouvez avoir des conflits de profileur.

Le programme d'installation MSI 64 bits pour l'agent .NET de New Relic installe automatiquement l'assembly du profileur 32 bits avec l'assembly 64 bits et, à partir de la version 10.16.0, active automatiquement la prise en charge 32 bits pour IIS.Pour les applications non hébergées par IIS, vous pouvez définir manuellement la variable d'environnement requise.

COR_PROFILER_PATH_32="C:\Program Files (x86)\New Relic\.NET Agent\NewRelic.Profiler.dll"

Activer ou désactiver l'agent New Relic.

Le nombre maximal de trames stack à trace dans n'importe quel vidage stack .

Votre clé de licence New Relic. New Relic utilise la clé de licence pour faire correspondre les données de votre application au compte approprié dans l'UI. Définissez la clé de licence via la variable d'environnement.

Vous pouvez également définir la variable d'environnement NEW_RELIC_LICENSE_KEY dans l'environnement de l'application :

NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY

Demande à l'agent d'enregistrer les informations de l'environnement d'exécution. Les informations sur l’environnement incluent le système d’exploitation, la version de l’agent et les assemblys disponibles.

Bloquer le démarrage de l'application jusqu'à ce que l'agent se connecte à New Relic. Si la valeur est true, la première transaction peut prendre beaucoup plus de temps à se terminer, car elle est bloquée jusqu'à ce que la connexion à New Relic soit terminée.

Bloquer l'arrêt application pendant que l'agent lance un cycle final de collecte et envoie toutes les données à New Relic.

Vous pouvez également définir la variable d'environnement NEW_RELIC_SEND_DATA_ON_EXIT dans l'environnement de l'application :

NEW_RELIC_SEND_DATA_ON_EXIT=true

La durée minimale pendant laquelle le processus doit s'exécuter avant que l'agent ne l'empêche de s'arrêter. Ce paramètre s'applique uniquement lorsque sendDataOnExit est true.

Vous pouvez également définir la variable d'environnement NEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS dans l'environnement de l'application :

NEW_RELIC_SEND_DATA_ON_EXIT_THRESHOLD_MS=2000

Si false, l'agent utilise un thread de pool pour terminer le traitement de la transaction.

Si cette valeur est vraie, l'agent terminera le traitement de la transaction sur le thread de demande.

Si false, l'agent tente de réutiliser les transactions existantes lorsque des méthodes instrumentées personnalisées sont rencontrées dans des scénarios asynchrones/threadés.

Si true, l'agent tente de créer de nouvelles transactions lorsque des méthodes instrumentées personnalisées sont rencontrées dans des scénarios asynchrones/threadés.

Alternativement, la variable d’environnement NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD peut être utilisée pour contrôler ce comportement.

NEW_RELIC_FORCE_NEW_TRANSACTION_ON_NEW_THREAD=true

Le délai de demande de l'agent expire lors de la communication avec New Relic.

Démarrez automatiquement l'agent .NET lorsque la première méthode instrumentée est touchée.

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

<service licenseKey="YOUR_LICENSE_KEY"
  host="gov-collector.newrelic.com" />

Vous pouvez également utiliser la variable d’environnement NEW_RELIC_HOST.

NEW_RELIC_HOST=gov-collector.newrelic.com

Définit l'hôte proxy.

Vous pouvez également définir la variable d’environnement NEW_RELIC_PROXY_HOST dans l’environnement de l’application.

Définit le port proxy.

Vous pouvez également définir la variable d’environnement NEW_RELIC_PROXY_PORT dans l’environnement de l’application.

Définissez éventuellement un chemin d'URI proxy.

Vous pouvez également définir la variable d’environnement NEW_RELIC_PROXY_URI_PATH dans l’environnement de l’application.

Définissez éventuellement un domaine à utiliser lors de l’authentification auprès du serveur proxy.

Vous pouvez également définir la variable d’environnement NEW_RELIC_PROXY_DOMAIN dans l’environnement de l’application.

Définissez éventuellement un nom d'utilisateur pour l'authentification.

Vous pouvez également définir la variable d’environnement NEW_RELIC_PROXY_USER dans l’environnement de l’application.

Définissez éventuellement un mot de passe pour l'authentification.

Vous pouvez également définir la variable d’environnement NEW_RELIC_PROXY_PASS dans l’environnement de l’application.

Pour plus de sécurité, l'agent .NET prend en charge l'utilisation d'un mot de passe proxy obscurci avec l'attribut passwordObfuscated. Le mot de passe proxy obscurci est généré à l’aide de la commande CLI New Relic suivante :

$
newrelic agent config obfuscate --key OBSCURING_KEY --value "PLAIN_TEXT_PROXY_PASSWORD"

Vous pouvez également définir la variable d’environnement NEW_RELIC_PROXY_PASS_OBFUSCATED dans l’environnement de l’application.

Lorsque la valeur est false, tout logging est désactivé. Vous pouvez également définir la variable d’environnement NEW_RELIC_LOG_ENABLED dans l’environnement de l’application.

Définit le niveau de détail enregistré dans le fichier de log. Les valeurs possibles, par ordre croissant de détail, sont :

• off

• error

• warn

• info

• debug

• finest

• all

  Vous pouvez également définir la variable d’environnement NEWRELIC_LOG_LEVEL dans l’environnement de l’application.

  Important

  Augmenter le niveau de log augmentera l'impact sur les performances de New Relic.

Enregistre toutes les données envoyées et reçues depuis New Relic dans un fichier log auditlog et dans le fichier log standard. Ignoré si enabled est défini sur false ou console est défini sur true.

Envoyer le message de log à la console au lieu du fichier de log (dans les versions agent antérieures à 10.35.0, les logs sont envoyés à la fois à la console et au fichier de log). Ignoré si enabled est défini sur false. Vous pouvez également définir la variable d’environnement NEW_RELIC_LOG_CONSOLE dans l’environnement de l’application.

Le logging de la console dans le profileur est limitée au niveau info et supérieur en raison de considérations de performances.

Le répertoire contenant le fichier log généré par l'agent. Si cette option est omise, un répertoire nommé Logs dans la zone d'installation de l'agent New Relic sera utilisé par défaut.

Vous pouvez également définir la variable d’environnement NEWRELIC_LOG_DIRECTORY dans l’environnement de l’application. Vous pouvez également envoyer votre log de profileur vers un répertoire personnalisé, mais vous ne pouvez le faire qu'avec la variable d'environnement NEWRELIC_PROFILER_LOG_DIRECTORY dans l'environnement de l'application:

NEWRELIC_LOG_DIRECTORY=path\to\a\directory
NEWRELIC_PROFILER_LOG_DIRECTORY=path\to\a\directory # not configurable via config file

Définit un nom pour le fichier de log. Si vous ne définissez pas de fileName, le nom est dérivé du nom du processus de monitoring.

Vous pouvez également définir la variable d'environnement NEW_RELIC_LOG dans l'environnement de l'application :

NEW_RELIC_LOG=MyApp.log

Définit agent la log stratégie de roulement du fichier de . Les valeurs possibles sont :

• size (par défaut) : Le fichier de log est renouvelé lorsqu'il atteint la taille spécifiée dans maxLogFileSizeMB.

• day: Le fichier de log se termine à minuit.

  Vous pouvez également définir la variable d'environnement NEW_RELIC_LOG_ROLLING_STRATEGY dans l'environnement de l'application :

  NEW_RELIC_LOG_ROLLING_STRATEGY=day

  Copier

  Pris en charge dans l'agent .NET v10.21.0 et supérieur.

Définit le nombre de agent fichiers log à conserver instance agentpar de l', plusieurs applications exécutées sur le même hôte créeront chacune autant de fichiers. Lorsque le nombre maximum de fichier de log est atteint, le fichier de log le plus ancien est supprimé. Une valeur de 0 spécifie qu'il n'y a pas de nombre maximum de fichier de log.

Vous pouvez également définir la variable d'environnement NEW_RELIC_LOG_MAX_FILES dans l'environnement de l'application :

NEW_RELIC_LOG_MAX_FILES=2

Pris en charge dans l'agent .NET v10.21.0 et supérieur.

Définit la taille maximale du agent fichier de de log en mégaoctets avant son basculement. Valable uniquement lorsque logRollingStrategy est défini sur size. Une valeur de 0 spécifie qu'il n'y a pas de taille maximale de fichier log .

Vous pouvez également définir la variable d'environnement NEW_RELIC_LOG_MAX_FILE_SIZE_MB dans l'environnement de l'application :

NEW_RELIC_LOG_MAX_FILE_SIZE_MB=100

Pris en charge dans l'agent .NET v10.21.0 et supérieur.

Le nom de votre application .NET est un enfant de l’élément application . New Relic regroupera vos données en fonction de ce nom. Par exemple, si vous avez deux applications en cours d'exécution nommées AppA et AppB, vous verrez deux applications dans l'interface New Relic : AppA et AppB.

Vous pouvez également attribuer jusqu'à trois noms à votre application. Le prénom est le nom principal. Par exemple:

<application>
  <name>MY APPLICATION PRIMARY</name>
  <name>SECOND APP NAME</name>
  <name>THIRD APP NAME</name>
</application>

Vous pouvez également définir la variable d'environnement NEW_RELIC_APP_NAME dans l'environnement de l'application :

NEW_RELIC_APP_NAME=Descriptive Name

Pour plusieurs noms :

NEW_RELIC_APP_NAME="App Name, App Name 2, App Name 3"

Les échantillonneurs collectent des informations sur la consommation de mémoire et de processeur. Réglez ceci sur true pour désactiver l’échantillonnage.

Vous pouvez également définir la variable d'environnement NEW_RELIC_DISABLE_SAMPLERS dans l'environnement de l'application :

NEW_RELIC_DISABLE_SAMPLERS=true

Définit la méthode HTTP utilisée lors de l'envoi de données à New Relic. Définissez cette valeur sur true pour activer l’utilisation de la méthode PUT lors de l’envoi de données. La méthode POST est utilisée par défaut.

Définissez l’attribut displayName dans l’élément processHost dans newrelic.config. L'élément processHost est un enfant de l'élément configuration .

<configuration . . . >
  <processHost displayName="CUSTOM_NAME" />
</configuration>

Définissez la variable d’environnement NEW_RELIC_PROCESS_HOST_DISPLAY_NAME :

NEW_RELIC_PROCESS_HOST_DISPLAY_NAME="CUSTOM_NAME"

Détermine si l'agent interroge l'API de métadonnées AWS.

Alternativement, ce comportement peut être contrôlé via la variable d'environnement NEW_RELIC_UTILIZATION_DETECT_AWS :

NEW_RELIC_UTILIZATION_DETECT_AWS=false

Détermine si l’agent interroge l’API de métadonnées Microsoft Azure.

Alternativement, ce comportement peut être contrôlé via la variable d'environnement NEW_RELIC_UTILIZATION_DETECT_AZURE :

NEW_RELIC_UTILIZATION_DETECT_AZURE=false

Détermine si l'agent interroge l'API de métadonnées GCP.

Alternativement, ce comportement peut être contrôlé via la variable d'environnement NEW_RELIC_UTILIZATION_DETECT_GCP :

NEW_RELIC_UTILIZATION_DETECT_GCP=false

Détermine si l'agent interroge les informations PCF à partir des variables d'environnement.

Alternativement, ce comportement peut être contrôlé via la variable d'environnement NEW_RELIC_UTILIZATION_DETECT_PCF :

NEW_RELIC_UTILIZATION_DETECT_PCF=false

Détermine si l'agent lit les informations Docker à partir du système de fichiers.

Alternativement, ce comportement peut être contrôlé via la variable d'environnement NEW_RELIC_UTILIZATION_DETECT_DOCKER :

NEW_RELIC_UTILIZATION_DETECT_DOCKER=false

Détermine si l'agent interroge les informations Kubernetes à partir des variables d'environnement.

Alternativement, ce comportement peut être contrôlé via la variable d'environnement NEW_RELIC_UTILIZATION_DETECT_KUBERNETES :

NEW_RELIC_UTILIZATION_DETECT_KUBERNETES=false

Activer ou désactiver la collecte d'attributs. Lorsqu'il est défini sur false dans l'élément d'attribut principal, ce paramètre remplace tous les paramètres d'attribut pour les destinations individuelles.

Vous pouvez également définir la variable d’environnement NEW_RELIC_ATTRIBUTES_ENABLED dans l’environnement de l’application.

Si les attributs sont activés, l'agent collectera toutes les clés d'attribut spécifiées dans cette liste. Pour spécifier plusieurs clés d’attribut, spécifiez chacune d’elles individuellement. Vous pouvez également utiliser un caractère générique * à la fin d'une clé pour faire correspondre plusieurs attributs (par exemple, myApiKey.*). Pour plus d'informations, voir Règles d'attribut.

Vous pouvez également définir la variable d’environnement NEW_RELIC_ATTRIBUTES_INCLUDE dans l’environnement de l’application. Cette variable d'environnement accepte une liste de noms d'attributs délimitée par des virgules.

Si les attributs sont activés, l'agent ne collectera pas les clés d'attribut spécifiées dans cette liste. Pour spécifier plusieurs clés d’attribut, spécifiez chacune d’elles individuellement. Vous pouvez également utiliser un caractère générique * à la fin d'une clé pour faire correspondre plusieurs attributs (par exemple, myApiKey.*). Pour plus d'informations, voir Règles d'attribut.

Vous pouvez également définir la variable d’environnement NEW_RELIC_ATTRIBUTES_EXCLUDE dans l’environnement de l’application. Cette variable d'environnement accepte une liste de noms d'attributs délimitée par des virgules.

Définit le comportement de l'agent .NET au niveau « global » pour les pools application servis via IIS. L'agent .NET instrumente tous les pools application par défaut. Lorsque true, les pools application répertoriés sous applicationPool avec un attribut instrument défini sur false ne seront pas instrumentés.

Essentiellement, lorsqu'elle est définie sur false, la liste du pool application agit comme une liste de domaines autorisés. Lorsque la valeur est true, la liste du pool application agit comme une liste de refus.

Définit le comportement instrumentation pour un pool application spécifique. L'attribut name est le nom d'un pool application . Activer ou désactiver le profilage dans l'attribut instrument . Définissez cette application dans l’attribut name .

Activer ou désactiver le collecteur d'erreurs.

Activer ou désactiver la capture d'événement d'erreur.

Limite du réservoir pour événement d'erreur.

Une liste de noms de classes entièrement qualifiés à ignorer. Le nombre maximal de combinaisons de classes d'erreur et de messages SHOULD être signalés est de 50. Si plus de 50 sont répertoriés, seuls les 50 premiers SHOULD doivent être utilisés.

Une carte facultative de noms de classes entièrement qualifiés vers une liste de chaînes correspondant à une sous-chaîne du message d'une erreur. Le nombre maximal de combinaisons de classes d'erreur et de messages SHOULD être signalés est de 50. Si plus de 50 sont répertoriés, seuls les 50 premiers SHOULD doivent être utilisés.

Répertorie les exceptions spécifiques à ne pas signaler à New Relic. Le nom complet de l’exception doit être utilisé, tel que System.IO.FileNotFoundException.

Répertorie les codes d'erreur HTTP spécifiques à ne pas signaler à New Relic. Vous pouvez utiliser des codes d'erreur HTTP intégraux standard, tels que simplement 401, ou vous pouvez utiliser des codes d'état complets Microsoft avec des points décimaux, tels que 401.4 ou 403.18. Les codes d’état doivent être égaux ou supérieurs à 400.

Cela peut également être configuré via une variable d'environnement, en spécifiant plusieurs codes avec une liste séparée par des virgules :

NEW_RELIC_ERROR_COLLECTOR_IGNORE_ERROR_CODES=401, 403.18

Une liste de noms de classes entièrement qualifiés à marquer comme prévu. Le nombre maximal de combinaisons de classes d'erreur et de messages SHOULD être signalés est de 50. Si plus de 50 sont répertoriés, seuls les 50 premiers SHOULD doivent être utilisés

Une carte facultative de noms de classes entièrement qualifiés vers une liste de chaînes correspondant à une sous-chaîne du message d'une erreur. Le nombre maximal de combinaisons de classes d'erreur et de messages SHOULD être signalés est de 50. Si plus de 50 sont répertoriés, seuls les 50 premiers SHOULD doivent être utilisés

Une liste de codes d'état séparés par des virgules. La liste peut inclure des plages d'entiers à l'aide d'un seul tiret (-) et comprendra à la fois l'entier de début et de fin de la plage.

Cela peut également être configuré via une variable d'environnement :

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_ERROR_CODES=401, 501-503

Utilisez ce sous-élément pour personnaliser les paramètres d’attribut de votre agent pour le suivi des erreurs. Ce sous-élément utilise les mêmes paramètres que l’élément principal attributes : enabled, include et exclude.

Activer ou désactiver le mode haute sécurité. Exemple:

<highSecurity enabled="true"/>

Vous pouvez également définir la variable d'environnement NEW_RELIC_HIGH_SECURITY dans l'environnement de l'application :

NEW_RELIC_HIGH_SECURITY=true

Activer ou désactiver les messages d'exception de bande. Exemple:

<stripExceptionMessages enabled="true"/>

Activer ou désactiver l'enregistreur d'événements.

Le nombre maximal d'événements de transaction échantillonnés que l'agent peut stocker en mémoire à la fois. Il s'agira du nombre maximal d'événements de transaction que l'agent peut envoyer par minute.

Vous pouvez également définir la variable d'environnement MAX_TRANSACTION_SAMPLES_STORED dans l'environnement de l'application :

MAX_TRANSACTION_SAMPLES_STORED=500

Utilisez ce sous-élément pour personnaliser les paramètres d’attributs de votre agent pour l’événement de transaction. Ce sous-élément utilise les mêmes paramètres que l’élément principal attributes : enabled, include et exclude.

Activer ou désactiver l'enregistreur d'événements.

Le nombre maximum d'événements personnalisés échantillonnés que l'agent peut stocker en mémoire à la fois. Ce sera le nombre maximum d'événements personnalisés que l'agent peut envoyer par minute.

Vous pouvez également définir la variable d'environnement MAX_EVENT_SAMPLES_STORED dans l'environnement de l'application :

MAX_EVENT_SAMPLES_STORED=500

• Si vous configurez l'agent pour monitoring de l'IA, nous vous recommandons de définir la valeur sur 100000.

Activer ou désactiver la capture des paramètres personnalisés.

Par défaut, l'agent injecte automatiquement le JavaScript de l'agent du navigateur. Pour désactiver l'injection automatique, définissez cet attribut sur false.

Utilisez ce sous-élément pour personnaliser les paramètres d'attributs de votre agent pour monitoring des navigateurs. Ce sous-élément utilise les mêmes paramètres que l’élément principal attributes : enabled, include et exclude.

Utilisez ce sous-élément pour empêcher l'agent de navigateur d'être injecté dans des pages spécifiques. L'élément est utilisé comme suit :

<requestPathsExcluded>
  <path regex="url-regex-1"/>
  <path regex="url-regex-2"/>
  ...
  <path regex="url-regex-n"/>
</requestPathsExcluded>

L'agent n'injectera pas l'agent de navigateur dans les pages dont l'URL correspond à l'une des expressions régulières spécifiées. Les expressions régulières doivent suivre les directives Microsoft pour la classe Regex.

Il s'agit d'une référence au répertoire virtuel du chemin dans votre application et non à l'URL complète du chemin que vous souhaitez exclure. Par exemple, pour exclure les pages de https://www.mywebsite.com/mywebpages/ vous devez simplement insérer /mywebpages/ comme valeur regex du chemin.

L'élément requestPathsExcluded doit être utilisé dans les cas où il est impossible ou indésirable d'utiliser l'appel DisableBrowserMonitoring() . Pour minimiser un éventuel impact sur les performances, essayez d'utiliser le moins d'expressions régulières possible et de les garder aussi simples que possible.

Activez ou désactivez le tracing des requêtes lentes.

Activer ou désactiver le suivi de transaction.

Définit le seuil de trace de transaction. Si une transaction prend plus de temps que le seuil, elle est éligible au tracing. Consultez les principes de base dutrace des transactions pour en savoir plus sur les règles régissant le suivi.

La valeur par défaut est apdex_f, ce qui définit le seuil à quatre fois la valeur apdex_t de l'application. Pour plus d'informations sur apdex_t, voir Apdex.

Vous pouvez également définir le seuil sur une valeur temporelle spécifique en millisecondes.

Sélectionnez une politique de suivi des requêtes. Les options sont off, qui n'enregistre rien ; obfuscated, qui enregistre une version obscurcie de la requête ; ou raw, qui enregistre la requête exactement telle qu'elle est envoyée à la base de données.

Lorsque true, l'agent capture EXPLAIN instructions pour les requêtes lentes avec des durées dépassant explainThreshold. Notez que l'activation de cette fonctionnalité peut avoir des implications sur les performances, car les plans sont capturés pour chaque transaction jusqu'à la valeur maxExplainPlans .

L'agent collecte les données de requête lente pour les requêtes qui dépassent ce seuil, ainsi que tous les plans d'explication disponibles, dans le cadre du suivi de la transaction.

Le nombre maximal de segments à collecter dans une trace de transaction.

Le nombre maximal de plans explicatifs à collecter par transaction.

Par défaut, maxStackTrace est défini sur 0, ce qui désactive le suivi des appels dans le cadre d'un trace de transaction. Si cette valeur est définie sur une valeur supérieure à 0, la trace des appels sera capturée pour la trace de la transaction.

Utilisez ce sous-élément pour personnaliser les paramètres d'attributs de votre agent pour le suivi de la transaction. Ce sous-élément utilise les mêmes paramètres que l’élément principal attributes : enabled, include et exclude.

Utilisez ce sous-élément pour activer la collecte de datastore instance métriques (telles que l'hôte et le port) pour certains pilotes de base de données. Ceux-ci sont signalés sur requête lente trace et trace de transaction. La valeur par défaut de l'attribut enabled est true.

Utilisez ce sous-élément pour activer la collecte du nom de la base de données sur requête lente trace et trace de transaction pour certains pilotes de base de données. La valeur par défaut de l'attribut enabled est true.

Utilisez ce sous-élément pour activer la collecte des paramètres de requête SQL sur la trace lente de la requête. La valeur par défaut de l'attribut enabled est false.

Vous pouvez également activer le tracing distribué via la variable d'environnement NEW_RELIC_DISTRIBUTED_TRACING_ENABLED dans l'environnement de l'application:

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true

Par défaut, les versions prises en charge de l'agent utilisent à la fois l'en-tête newrelic et les en-têtes W3C Trace Context pour le tracing distribué. L'en-tête distribué de tracing newrelic permet l'interopérabilité avec les agents plus anciens qui ne prennent pas en charge les en-têtes W3C Trace Context . les versions d'agent qui prennent en charge les en-têtes W3C Trace Context les prioriseront par rapport aux en-têtes newrelic pour le tracing distribué.

Si vous ne souhaitez pas utiliser l'en-tête newrelic, définissez-le sur true pour que l'agent exclue l'en-tête newrelic et utilise uniquement les en-têtes W3C Trace Context pour le tracing distribué.

Définissez l'élément <spanEvents> sur false pour le désactiver via le fichier newrelic.config . Cet élément est un enfant de l'élément <configuration> .

<configuration . . . >
  <spanEvents enabled="false" />
</configuration>

Définissez la variable d’environnement NEW_RELIC_SPAN_EVENTS_ENABLED dans l’environnement de l’application :

NEW_RELIC_SPAN_EVENTS_ENABLED=false

L'élément trace_observer identifie un hôte observateur indépendant de l'agent. Pour obtenir de l'aide pour obtenir une entrée d'hôte d'observateur de trace Infinite Tracing valide, consultez Rechercher ou créer un point de terminaison d'observateur de trace.

L'observateur de trace peut également être configuré à l'aide de la variable d'environnement NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST .

Activer ou désactiver le tracing inter-applications

Activer ou désactiver l'enregistreur d'événements.

Le nombre maximal d'événements d'échantillonnage que l'agent peut stocker en mémoire à la fois. Il s'agira du nombre maximal d'événements SPAN que l'agent peut envoyer par minute.

• Cela peut également être configuré à l'aide de la variable d'environnement NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED .

• Nous ne recommandons pas de configurer au-delà de 10 000. Le serveur limitera les données à 10 000 par minute.

• Si vous configurez l'agent pour monitoring de l'IA, nous vous recommandons de définir la valeur sur 10000.

  Important

  Cette option configuration est uniquement disponible dans l'agent .NET v9.0 ou supérieur.

Utilisez ce sous-élément pour personnaliser les paramètres d’attributs de votre agent pour l’événement span. Ce sous-élément utilise les mêmes paramètres que l’élément principal attributes : enabled, include et exclude.

Activer ou désactiver la capture des en-têtes de requête HTTP. Exemple:

Vous pouvez également définir la variable d'environnement NEW_RELIC_ALLOW_ALL_HEADERS dans l'environnement de l'application :

<allowAllHeaders enabled="true" />
<attributes enabled="true">
   <include>request.headers.*</include>
</attributes>

Activez ou désactivez toutes les fonctionnalités instrumentation de logging. Si true, la configuration de sous-fonctionnalité individuelle prend effet. Si false, aucune fonctionnalité d’instrumentation de logging n’est activée.

Ou utilisez la variable d’environnement NEW_RELIC_APPLICATION_LOGGING_ENABLED .

Utilisez ce sous-élément pour activer la collecte de métriques de logging (telles que Logging/lines) pour le framework de logging .NET commun. La valeur par défaut de l'attribut enabled est true.

Ou utilisez la variable d’environnement NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED .

Utilisez ce sous-élément pour activer la transmission du log de votre application vers New Relic. La valeur par défaut de l'attribut enabled est true, vous pouvez également utiliser la variable d'environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED .

La valeur par défaut de l'attribut maxSamplesStored est 10000, vous pouvez également utiliser la variable d'environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED pour ce paramètre. Définissez cette valeur sur une valeur inférieure pour réduire la quantité de lignes log envoyées (peut provoquer un échantillonnage log ). Définissez cette valeur sur une valeur plus élevée pour envoyer plus de lignes log .

Chaque log reçoit la même priorité que sa transaction associée. Les logs qui se produisent en dehors d'une transaction recevront une priorité aléatoire. Certains logs peuvent ne pas être inclus car ils sont limités par maxSamplesStored. Par exemple, si le logging maxSamplesStored est définie sur 10 000 et que la transaction 1 comporte 10 000 entrées log, seules les entrées log de la transaction 1 seront enregistrées. Si la transaction 1 contient moins de 10 000 logs, vous recevez tous les logs de la transaction 1. S'il reste de la place, vous recevez l'intégralité du log de la transaction 2, et ainsi de suite.

Si après tout le log des transactions échantillonnées est enregistré et qu'elles n'ont pas atteint la limite de maxSamplesStored, alors les messages du log des transactions qui ne figuraient pas dans notre échantillonnage sont envoyés. S'il en reste, les messages de log en dehors des transactions sont enregistrés.

Utilisez l'attribut logLevelDenyList (ou la variable d'environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LOG_LEVEL_DENYLIST) pour filtrer les messages de log du niveau de log spécifié. La valeur de cet attribut est une liste de niveaux séparés par des virgules et ne respectant pas la casse. En dehors du cas, la chaîne de niveau de log doit correspondre exactement au niveau de log filtré, les caractères génériques et les expressions régulières ne sont pas pris en charge. Par exemple, si la valeur a été définie sur logLevelDenyList="debug,warn", tout message de log avec un niveau de log de Debug ou Warn ne sera pas capturé ou transmis, mais un log avec un niveau de Warning sera toujours envoyé à New Relic.

Utilisez ce sous-élément, qui est un enfant de l'élément forwarding, pour configurer la capture et la transmission des données de contexte de logging (attribut personnalisé), dans les versions agent 10.4.0 et supérieures.

Définissez l'attribut enabled sur true pour activer la capture et la transmission des données de contexte de logging vers New Relic, vous pouvez également utiliser la variable d'environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLED. La valeur par défaut est false.

L'attribut include est une liste séparée par des virgules de noms d'attributs à inclure lorsque la capture de données contextuelles est activée, vous pouvez également utiliser la variable d'environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDE. La valeur par défaut est une chaîne vide, ce qui signifie « tout inclure ».

L'attribut exclude est une liste séparée par des virgules de noms d'attributs à exclure lorsque la capture de données contextuelles est activée, vous pouvez également utiliser la variable d'environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDE. La valeur par défaut est une chaîne vide, ce qui signifie « ne rien exclure ».

Les listes d'inclusion et d'exclusion suivent les mêmes règles de priorité que les autres agent d'attributs configuration.

Utilisez ce sous-élément, qui est un enfant de l'élément forwarding, pour configurer l'ajout de vos étiquettes (tag) au log transféré agent, dans les versions agent 10.34.0 et supérieures.

Définissez l’attribut enabled sur true pour permettre l’ajout de vos étiquettes au log transmis agent . Vous pouvez également utiliser la variable d’environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED. La valeur par défaut est false.

L'attribut exclude est une liste de noms d'étiquettes séparés par des virgules, insensible à la casse, à exclure lorsque vous activez les étiquettes. Vous pouvez également utiliser la variable d’environnement NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE. La valeur par défaut est une chaîne vide, ce qui signifie « ne rien exclure ». Cet attribut ne prend pas en charge les caractères génériques ni les expressions régulières.

Utilisez ce sous-élément pour activer la décoration du log de votre application avec les métadonnées de liaison New Relic . La valeur par défaut de l'attribut enabled est false. Certaines modifications configuration supplémentaires sont requises pour la décoration log locaux, veuillez consulter .NET : Configurer les logs en contexte pour plus d'informations.

Utilisez ce sous-élément pour configurer l’ID de compte AWS pour votre application.

<cloud>
  <aws accountId="123456789012" />
</cloud>

Cela peut également être configuré via une variable d'environnement :

NEW_RELIC_CLOUD_AWS_ACCOUNT_ID=123456789012

Utilisez ce sous-élément pour permettre à toutes les entrées et sorties de l'événement LLM d'être envoyées à New Relic. La valeur par défaut de l'attribut enabled est true. L'enregistrement de contenu est désactivé en mode haute sécurité.

Notez que si l'enregistrement de contenu est désactivé, le comptage des jetons LLM doit être fourni par les clients, en appelant l'APISetLlmTokenCountingCallback . Si ce rappel n'est pas fourni, l'agent ne pourra pas fournir le comptage des jetons LLM.

<aiMonitoring enabled="true">
  <recordContent enabled="false" />
</aiMonitoring>

Cela peut également être configuré via une variable d'environnement :

NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED=false

Pour plus d’informations, voir Nommer votre application .NET.

<appSettings>
  <add key="NewRelic.AppName" value="Descriptive Name" />
</appSettings>

Désigne un emplacement alternatif pour le fichier de configuration en dehors de la racine locale de l'application ou de l'emplacement de configuration globale. L'emplacement saisi doit être un chemin absolu.

<appSettings>
  <add key="NewRelic.ConfigFile" value="C:\Path-to-alternate-config-dir\newrelic.config" />
</appSettings>

Pour plus d’informations, voir Nommer votre application .NET.

{
  "NewRelic.AppName": "Descriptive Name"
}

Désigne un emplacement alternatif pour le fichier de configuration en dehors de la racine locale de l'application ou de l'emplacement de configuration globale. L'emplacement saisi doit être un chemin absolu.

{
  "NewRelic.ConfigFile": "C:Path-to-alternate-config-dir\newrelic.config"
}