Logs en contexte de l'agent .NET

Il s'agit de l'approche la plus simple et constitue un excellent choix pour les développeurs qui n'ont peut-être pas l'accès ou l'intérêt de configurer un redirecteur de log , ou pour les comptes qui souhaitent voir la puissance des logs et autres liens métadonnées dans le contexte de leurs applications, sans beaucoup de frais généraux.

En utilisant cette option, votre log inclut span.id, trace.id, hostname, entity.guid et entity.name. Renseignez-vous sur les limites du transfert de log .

Il vous suffit d'installer une version d'agent avec des capacités de transfert de log (agent .NET 9.7.0 ou supérieur). Si le transfert est désactivé, vous pouvez l'activer en ajoutant les éléments suivants à votre fichier de configuration d'agent :

<applicationLogging enabled="true">
  <forwarding enabled="true" maxSamplesStored="10000" />
  <localDecorating enabled="false" />
</applicationLogging>

Variables d'environnement :

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=false

À partir de la version 9.8.0 de l'agent, cette fonctionnalité est activée par défaut.

À partir de la version 10.4.0 de l'agent, l'agent prend également en charge la capture et la transmission des données de contexte (attribut personnalisé) à partir de l'événement de log. Cette sous-fonctionnalité est désactivée par défaut. Pour l'activer, utilisez la configuration suivante :

<applicationLogging enabled="true">
  <forwarding enabled="true" maxSamplesStored="10000">
    <contextData enabled="true" include="" exclude="" />
  </forwarding>
  <localDecorating enabled="false" />
</applicationLogging>

Variables d'environnement :

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=false

New Relic utilise des données contextuelles préfixées par « contexte ». Par exemple, un attribut log personnalisé nommé myKey avec la valeur myValue pour New Relic est context.myKey : myValue.

La bibliothèque de logging .NET que nous instrumentons stocke généralement les paires de données de contexte valeur clé sur chaque événement de log sous la forme d'un Dictionary<string,object>. Pour convertir les valeurs en chaînes avant d'être envoyées à New Relic, nous essayons d'abord d'utiliser Newtonsoft.Json.JsonConvert.SerializeObject. Si cela échoue, nous essayons d'appeler .ToString() sur l'objet ; en dernier recours, nous enverrons le nom du type.

Vous pouvez filtrer les données contextuelles à l'aide des options de configuration include et exclude . Il s'agit de listes de noms d'attributs séparés par des virgules. Les valeurs par défaut pour les deux sont des chaînes vides ; un champ include vide signifie « tout inclure ». Ces options d'inclusion/exclusion suivent les mêmes règles que les autres options configuration d'attributs d'agent.

Par exemple, pour inclure tous les attributs commençant par « a » sauf « pomme » et exclure tous les attributs commençant par « b » sauf « banane », utilisez la configuration suivante :

<applicationLogging enabled="true">
  <forwarding enabled="true" maxSamplesStored="10000">
    <contextData enabled="true" include="a*, banana" exclude="b*, apple" />
  </forwarding>
  <localDecorating enabled="false" />
</applicationLogging>

Variables d'environnement :

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_INCLUDE="a*, banana"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_CONTEXT_DATA_EXCLUDE="b*, apple"
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=false

Optional adjustments:

Une fois le transfert de logactivé, vous avez également le contrôle sur le nombre maximum de logs envoyés à New Relic chaque minute. La valeur par défaut est 10 000. Si plus de 10 000 logs sont reçus dans une fenêtre de 60 secondes, votre log commencera à être échantillonné.

Réglez-le sur un nombre plus élevé pour recevoir plus de logs. Réglez-le sur un nombre inférieur pour recevoir moins de logs. Tout entier est valide.

<applicationLogging enabled="true">
  <forwarding enabled="true" maxSamplesStored="10000" />
  <localDecorating enabled="false" />
</applicationLogging>

Variables d'environnement :

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=false

Si vous disposez déjà d'une solution de transfert de loget que vous mettez à jour votre agent pour utiliser les logs automatiques dans ce contexte, assurez-vous de disable your manual log forwarder. Sinon, votre application enverra des lignes log en double. Selon votre compte, cela peut entraîner une double facturation. Pour plus d'informations, suivez les procédures pour désactiver votre redirecteur de logspécifique.

Vous avez déjà un redirecteur de logqui vous plaît ? Nous sommes là pour vous ! Les agents linguistiques peuvent décorer votre log avec les liens métadonnées nécessaires pour fournir l'accès aux logs automatiques en contexte de fonctionnalité.

Cette option ne doit pas être utilisée avec le transfert interne à l'agent. L'utilisation d'un redirecteur de logexterne pour envoyer le log à New Relic alors que le transfert interne à l'agent est activé entraînera l'envoi de votre log deux fois à New Relic. Selon votre compte, cela peut entraîner une double facturation.

1. Si vous souhaitez utiliser cette option, assurez-vous que l’option de configuration de transfert dans l’agent est désactivée.

2. Activez la décoration log dans votre configuration, puis relancez l'agent pour commencer à décorer votre log.

   <applicationLogging enabled="true">
     <forwarding enabled="false" />
     <localDecorating enabled="true" />
   </applicationLogging>

   Copier

   Variables d'environnement :

   NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=false
   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true

   Copier

   Important

   La valeur de la variable d'environnement, si elle est présente, a priorité sur la valeur du fichier de configuration.

   Notre décorateur ajoute cinq attributs à chaque log message (texte brut) : entity.guid, entity.name, hostname, trace.id et span.id. Exemple:

   This is my log message. NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}

   Copier

   Important

   Pour JSON, les données NR-LINKING doivent être dans la propriété message .

   Si le message de log est vide ou vierge, le message de sortie sera également vide. Exemple:

   NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}|.

   Copier

   Le message de sortie du log sera une chaîne vide.

   Certains attributs peuvent être vides si le log s'est produit en dehors d'une transaction ou s'ils ne sont pas applicables au contexte de votre application. Nous recommandons cette option plutôt que le processus manuel consistant à utiliser un formatteur de décoration.

   Important

   La clé utilisée pour lire le jeton NR-LINKING à partir d'un framework de logging est NR_LINKING et non NR-LINKING afin de prendre en charge les frameworks de logging qui n'autorisent pas les tirets dans les noms de clé.

   Configuration de log4net

   Pour log4net, l'agent .NET stocke le jeton NR-LINKING comme une propriété appelée NR_LINKING dans l'objet événement de log . Les exemples de disposition courants suivants montrent comment configurer log4net pour écrire le jeton NR-LINKING . D'autres dispositions sont prises en charge, mais ne sont pas répertoriées ci-dessous. SimpleLayout n'est pas pris en charge car il ne peut pas être modifié.

   PatternLayout/DynamicPatternLayout: Mettez à jour le conversionPattern pour inclure la propriété NR_LINKING à la fin de la ligne.

   <layout type="log4net.Layout.PatternLayout">
     <conversionPattern value="%date %5level %logger.%method [%line] - MESSAGE: %message %property{NR_LINKING}%newline %exception" />
   </layout>

   Copier

   log4net.Ext.Json: Mettez à jour la mise en page pour inclure un membre appelé NR_LINKING dans la propriété JSON du message.

   log4net.Appender.AdoNetAppender:Cet appender a une configuration légèrement différente des autres mises en page. Vous devrez mettre à jour le paramètre message pour inclure les métadonnées. L'exemple suivant le démontre en utilisant un PatternLayout.

   <parameter>
     <parameterName value="@message" />
     <dbType value="String" />
     <size value="4000" />
     <layout type="log4net.Layout.PatternLayout">
       <conversionPattern value="%message %property{NR_LINKING}" />
     </layout>
   </parameter>

   Copier

   Configuration de Serilog

   Pour Serilog, l'agent .NET stocke le jeton NR-LINKING en tant que propriété appelée NR_LINKING dans l'objet événement de log . Les exemples de formateur et de récepteur courants suivants montrent comment configurer Serilog pour écrire le jeton NR-LINKING . D'autres récepteurs et formateurs sont pris en charge, mais ne sont pas répertoriés ci-dessous.

   Plain text using an outputTemplate: Mettez à jour le outputTemplate pour inclure la propriété NR_LINKING à la fin de la ligne.

   Log.Logger = new LoggerConfiguration()
       .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
       .Enrich.FromLogContext()
       .WriteTo.File(
           path: @"plaintext_log.txt",
           fileSizeLimitBytes: 1_000_000,
           rollOnFileSizeLimit: true,
           shared: true,
           flushToDiskInterval: TimeSpan.FromSeconds(1),
           outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj} {NR_LINKING} {NewLine}{Exception}"
       )
       .CreateLogger();

   Copier

   JSON Formatter with automatic property output: Le JsonFormatter par défaut n'écrira pas les métadonnées NR_LINKING dans la propriété du message ; à la place, il écrit chaque propriété dans son propre objet JSON. Vous devrez créer un formateur JSON personnalisé pour écrire les données NR_LINKING à la fin de la propriété message avant que les logs en contexte ne fonctionnent.

   Configuration de Microsoft.Extensions.Logging

   Pour Microsoft.Extensions.Logging, l’agent .NET stocke le jeton NR-LINKING avec le message dans une étendue nouvellement créée. Étant donné que Microsoft.Extensions.Logging s'appuie sur un autre framework pour la sortie, veuillez consulter la configuration log4net ou Serilog ci-dessus pour plus de détails.

   Configuration de NLog

   Pour NLog, l'agent .NET est capable d'ajouter automatiquement le jeton NR-LINKING directement à la fin du message, aucune configuration supplémentaire n'est donc requise.

Avant que les agents linguistiques aient la possibilité de transmettre et de décorer les logs, vous pouviez activer les logs en contexte en mettant à jour votre application pour envoyer des liens mémorisables.

Cette option est toujours prise en charge, mais n'est plus encouragée. Pour obtenir des instructions sur l'utilisation de cette approche, consultez l'option logs en contexte manuels.

De plus, cette méthode nécessite que vous installiez un redirecteur de logavant d'activer les logs dans ce contexte. Si vous ne disposez pas d'un redirecteur de log , l'interface utilisateur de New Relic vous prompt d'utiliser notre agent infrastructure .

Si vous décidez d'utiliser votre solution de transfert de log existante et que vous décidez ultérieurement de mettre à jour votre agent pour utiliser les logs en contexte automatiques, assurez-vous de disable your manual log forwarder. Sinon, votre application enverra des lignes log en double. Selon votre compte, cela peut entraîner une double facturation. Pour plus d'informations, suivez les procédures pour désactiver votre redirecteur de logspécifique.

Le diagramme suivant illustre le flux de messages de log via Apache log4net, mettant en évidence les composants spécifiques de l'extension New Relic log4net. De nombreux redirecteurs de logsont disponibles. Cet exemple utilise Fluentd.

Appender: Le NewRelicAppender ajoute des informations contextuelles de l'agent .NET (en utilisant l'API) à l'événement de log généré par l'application. Ces informations contextuelles, appelées métadonnées de liaison, sont utilisées par New Relic pour lier les messages de log aux transactions et aux étendues à partir desquelles ils ont été créés. Cet appender transmettra l'événement de log enrichi aux appenders en aval pour un traitement ultérieur.

Étant donné que NewRelicAppender est de type ForwardingAppender , il doit être le premier appender de la chaîne. Il nécessite également un autre appender capable d'écrire sur une destination de sortie réelle en tant qu'enfant pour fonctionner.

Layout: Le NewRelicLayout formate l'événement de log enrichi au format JSON attendu par New Relic. L'appender, auquel cette mise en page est attribuée, demande à log4net de générer le JSON dans un fichier à l'emplacement attendu par le redirecteur de logs.

Log Forwarder:Le redirecteur de log monitore un dossier de sortie et envoie de manière incrémentielle les informations log correctement formatées et enrichies au point de terminaison de logging New Relic.

Log4net utilise appender et layout pour stocker et formater les messages de log. NewRelicAppender enrichit le message de log avec des informations contextuelles de l'agent .NET New Relic s'il est attaché à votre application. L'appender transmet le message de log enrichi aux appenders en aval pour gérer des cas d'utilisation spécifiques pour le message de log.

Pour plus d'informations sur le logging avec log4net, consultez la documentation de démarrage d'Apache log4net.

Pour configurer les logs en contexte avec l'extension log4net :

1. À l’aide du gestionnaire de paquets Visual Studio NuGet , recherchez et installez le NewRelic.LogEnrichers.Log4Net package.

2. Dans votre fichier de configuration log4net, mettez à jour votre configuration de logging pour utiliser NewRelicAppender comme appender de premier niveau et référencez vos appenders existants comme ses enfants. Remplacez également la disposition de l'appender qui écrit le message de log vers une destination de sortie par NewRelicLayout.

   L'exemple configuration log4net suivant enrichit l'événement de log avec les métadonnées de liaison New Relic. En plus du fichier de log existant, il génère un nouveau fichier de log dans un format JSON spécifique à C:\logs\log4netExample.log.json pour consommation par les redirecteurs de log :

   <log4net>
     <root>
       <level value="ALL" />
       <appender-ref ref="NewRelicAppender" />
     </root>
   
     <appender name="NewRelicAppender" type="NewRelic.LogEnrichers.Log4Net.NewRelicAppender, NewRelic.LogEnrichers.Log4Net" >
       <threshold value="ALL"/>
       <appender-ref ref="FileAppender" />
     </appender>
   
     <appender name="FileAppender" type="log4net.Appender.FileAppender">
       <file value="C:\logs\log4netExample.log.json" />
       <param name="AppendToFile" value="true" />
       <layout type="NewRelic.LogEnrichers.Log4Net.NewRelicLayout, NewRelic.LogEnrichers.Log4Net">
       </layout>
     </appender>
   </log4net>

   Copier

   Après avoir configuré l'extension log4net et mis à jour votre fichier de logging, vous pouvez configurer votre extension pour envoyer des données à New Relic. Il existe plusieurs options pour transférer vos logs. Voici un exemple configuration utilisant l'agent infrastructure pour les logs en contexte :

   logs:
     - name: application-log
       file: C:\logs\log4netExample.log.json # Path to a single log file

   Copier

   Documentation pour l'utilisation de l'agent d'infrastructure forwarder

L' extension New Relic NLog fournit un NewRelicJsonLayout qui formate un événement de log de la manière requise par le point de terminaison de logging New Relic. Ensuite, il ajoute des informations contextuelles à partir de l’agent .NET lorsqu’il est attaché à votre application. Ensuite, une cible peut être configurée pour écrire les données de logging dans un dossier de sortie. Le redirecteur de log peut monitorer ce dossier et envoyer de manière incrémentielle les informations log à New Relic.

Le diagramme suivant illustre le flux de messages de log via NLog, mettant en évidence les composants spécifiques de l'extension New Relic NLog.

New Relic JSON Layout: Le NewRelicJsonLayout ajoute des informations contextuelles de l'agent .NET (à l'aide de l'API) à l'événement de log généré par l'application et génère un message de log au format JSON attendu par New Relic. Ces informations contextuelles, appelées métadonnées de liaison, sont utilisées par New Relic pour lier les messages de log aux transactions et aux étendues où ils ont été créés.

Étant donné que NewRelicAppender est de type ForwardingAppender , il doit être le premier appender de la chaîne. Il nécessite également un autre appender capable d'écrire sur une destination de sortie réelle en tant qu'enfant pour fonctionner.

File Target: Un FileTarget définit un fichier sur le disque où les messages de log sont écrits. L'ajout de NewRelicJsonLayout à cette cible permet à la sortie d'être formatée correctement pour la transmission à New Relic.

Log Forwarder: Le redirecteur de logs est configuré pour envoyer les données log correctement formatées et enrichies de la sortie FileTarget au point de terminaison de logging New Relic.

Pour plus d'informations sur le logging avec NLog, consultez la documentation nlog-project.org.

Utilisez notre extension NLog 4.5 ou supérieure pour créer un lien entre vos données log et les données associées sur le reste de la plateforme New Relic.

1. À l’aide du gestionnaire de paquets Visual Studio NuGet , recherchez et installez le NewRelic.LogEnrichers.NLog package.

2. Dans votre code d'application, mettez à jour votre configuration de logging pour ajouter le NewRelicJsonLayout et décidez si vous souhaitez collecter les données MappedDiagnosticsContext (MDC) ou MappedDiagnosticsLogicalContext (MDLC).

   Les exemples de configuration suivants génèrent de nouveaux fichiers JSON qui sont écrits sur le disque. Certaines de ces options de configuration peuvent être utiles pour gérer la quantité d’espace disque utilisé et/ou les performances de la cible.

• archiveAboveSize

• maxArchiveFiles

• bufferSize

• enableArchiveFileCompression

• autoFlush

• concurrentWrites

  Bien que la cible NLog AsyncWrapper ne soit pas requise, elle peut aider à améliorer les performances en effectuant le formatage et la sortie du fichier log sur un thread différent.

  Don't collect MDC or the MDLC data (default):

  L'exemple de code suivant enrichit l'événement de log avec la liaison New Relic des métadonnées, mais pas avec MDC ou les données MDLC. En plus du fichier de log existant, il génère un nouveau fichier de log dans un format JSON spécifique à C:\logs\NLogExample.log.json pour consommation par les redirecteurs de log :

  var loggerConfig = new LoggingConfiguration();
  var newRelicFileTarget = new FileTarget("NewRelicFileTarget");
  newRelicFileTarget.Layout = new NewRelicJsonLayout();
  newRelicFileTarget.FileName = "C:\logs\NLogExample.json";
  loggerConfig.AddTarget(newRelicFileTarget);
  loggerConfig.AddRuleForAllLevels("NewRelicFileTarget");
  LogManager.Configuration = loggerConfig;
  var logger = LogManager.GetLogger("Example");

  Copier

  Collect MDC or the MDLC data:

  Si votre application utilise le MDC ou le MDLC, vous pouvez configurer le NewRelicJsonLayout pour inclure des éléments dans ces collections. L'exemple de code suivant ajoute la configuration supplémentaire pour permettre la collecte de données MDC et MDLC. Comme dans l'exemple précédent, il génère un nouveau fichier de log dans un format JSON spécifique à C:\logs\NLogExample.log.json pour consommation par les redirecteurs de log :

  var loggerConfig = new LoggingConfiguration();
  var newRelicFileTarget = new FileTarget("NewRelicFileTarget");
  var newRelicLayout = new NewRelicJsonLayout
  {
      IncludeScopeProperties = true
  };
  
  newRelicFileTarget.Layout = newRelicLayout;
  newRelicFileTarget.FileName = @"C:\logs\NLogExample.json";
  loggerConfig.AddTarget(newRelicFileTarget);
  loggerConfig.AddRuleForAllLevels("NewRelicFileTarget");
  LogManager.Configuration = loggerConfig;
  var logger = LogManager.GetLogger("Example");

  Copier

  Une fois que vous avez configuré l'extension NLog et mis à jour votre fichier de logging, vous pouvez configurer votre extension pour envoyer des données à New Relic. Il existe plusieurs options pour transférer vos logs. Voici un exemple configuration utilisant l'agent infrastructure pour les logs en contexte :

  logs:
    - name: application-log
      file: C:\logs\log4netExample.log.json # Path to a single log file

  Copier

  Documentation pour l'utilisation de l'agent d'infrastructure forwarder

Vous pouvez également configurer l’extension New Relic NLog avec des fournisseurs de configuration basés sur des fichiers. L'exemple de code suivant crée un enregistreur basé sur les paramètres contenus dans un fichier App.config .

Instantiating Logger using .config file

var logger = LogManager.GetLogger("NewRelicLog");
logger.Info("Hello, New Relic!");

Sample App.config file

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="nlog" type="NLog.Config.ConfigSectionHandler, NLog"/>
  </configSections>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
  </startup>
  <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <extensions>
      <add assembly="NewRelic.LogEnrichers.NLog" />
    </extensions>
    <targets>
      <target name="NewRelicLogFile" xsi:type="File" fileName="C:/path/to/NewRelicLog.json">
        <layout xsi:type="newrelic-jsonlayout">
        </layout>
      </target>
    </targets>
    <rules>
      <logger name="NewRelicLog" minlevel="Info" writeTo="newRelicLogFile" />
    </rules>
  </nlog>
</configuration>

Serilog est un framework de logging structuré qui enregistre les messages du log de votre application et crée un LogEvent pour stocker les données du message. En utilisant les Enrichisseurs, vous pouvez ajouter des informations supplémentaires à l'événement de log. Les récepteurs et les formateurs vous permettent de formater et de générer ces événements de log pour une consommation et une visualisation en aval.

Le diagramme suivant illustre le flux de messages de log via Serilog, mettant en évidence les composants spécifiques de l'extension New Relic Serilog. De nombreux redirecteurs de logsont disponibles. Cet exemple utilise Fluentd.

New Relic Enricher: Le NewRelicEnricher ajoute des informations contextuelles de l'agent .NET (à l'aide de l'API) à l'événement de log généré par l'application. Ces informations contextuelles, appelées métadonnées de liaison, sont utilisées par New Relic pour lier les messages de log aux transactions et aux spans où ils ont été créés.

New Relic Formatter: Le NewRelicFormatter traduit l'événement de log enrichi au format JSON attendu par New Relic. Un sink demande à Serilog de générer le JSON dans un fichier à l'emplacement attendu par le redirecteur de logs.

New Relic Log Forwarder: Le redirecteur de logs est configuré pour envoyer les données log correctement formatées et enrichies de la sortie FileTarget au point de terminaison de logging New Relic.

Pour plus d'informations sur Serilog événement de log, consultez la documentation Serilog sur GitHub.

Pour configurer les logs en contexte avec l'extension Serilog :

1. Utilisez le gestionnaire de paquets Visual Studio NuGet pour localiser et installer le NewRelic.LogEnrichers.Serilog package.

2. Dans votre code d’application, mettez à jour votre configuration de logging pour ajouter NewRelicEnricher et NewRelicFormatter.

   L'exemple de code suivant enrichit l'événement de log avec les métadonnées de liaison New Relic. En plus du fichier de log existant, il génère un nouveau fichier de log dans un format JSON spécifique à C:\logs\SerilogExample.log.json pour consommation par les redirecteurs de log :

   var loggerConfig = new LoggerConfiguration();
   
   loggerConfig
       .Enrich.WithThreadName()
       .Enrich.WithThreadId()
       .Enrich.WithNewRelicLogsInContext()
       .WriteTo.File( path: @"C:\logs\ExistingLoggingOutput.txt")
       .WriteTo.File(
           formatter: new NewRelicFormatter(),
           path: @"C:\logs\SerilogExample.log.json");
   
   var log = loggerConfig.CreateLogger();

   Copier

   Cette configuration génère de nouveaux fichiers JSON qui sont écrits sur le disque. Certaines de ces options de configuration peuvent être utiles pour gérer la quantité d’espace disque utilisé et/ou les performances du récepteur.

• restrictedToMinimumLevel

• buffered

• rollingInterval

• rollOnFileSizeLimit

• retainedFileCountLimit

  Bien que cela ne soit pas obligatoire, l'utilisation du Serilog asynchrone Sink Wrapper peut aider à améliorer les performances en effectuant le formatage et la sortie du fichier de log sur un thread différent.

3. Une fois que vous avez configuré l'extension Serilog et mis à jour votre fichier de logging, plusieurs options s'offrent à vous pour transférer vos logs. Voici un exemple configuration utilisant l'agent infrastructure pour les logs en contexte :

   logs:
     - name: application-log
       file: C:\logs\log4netExample.log.json # Path to a single log file

   Copier

   Documentation pour l'utilisation de l'agent d'infrastructure forwarder

Vous pouvez également configurer l'extension New Relic Serilog avec des fournisseurs configuration basés sur des fichiers. Le package NuGet supplémentaire suivant est requis :

• Microsoft.Extensions.Configuration

• Serilog.Settings.Configuration

  L'exemple de code suivant crée un enregistreur basé sur les paramètres contenus dans un fichier appSettings.json .

  Instantiating logger using appsettings.json

  var builder = new ConfigurationBuilder()
      .AddJsonFile("appsettings.json");
  
  var configuration = builder.Build();
  
  var logger = new LoggerConfiguration()
      .ReadFrom.Configuration(configuration)
      .CreateLogger();

  Copier

  Sample appsettings.json file

  {
    "Serilog": {
      "Using": [
        "Serilog.Sinks.Console",
        "Serilog.Sinks.File",
        "NewRelic.LogEnrichers.Serilog"
      ],
      "MinimumLevel": "Debug",
      "Enrich": ["WithNewRelicLogsInContext"],
      "WriteTo": [
        {
          "Name": "File",
          "Args": {
            "path": "C:\\Logs\\SerilogExample.log.json",
            "formatter": "NewRelic.LogEnrichers.Serilog.NewRelicFormatter, NewRelic.LogEnrichers.Serilog"
          }
        }
      ],
      "Properties": {
        "Application": "NewRelic Logging Serilog Example"
      }
    }
  }

  Copier

  L'exemple de code suivant crée un enregistreur basé sur les paramètres contenus dans un fichier web.config . Le package NuGet Serilog.Settings.AppSettings est requis.

  Instantiating logger using .config file

  var logger = new LoggerConfiguration()
      .ReadFrom.AppSettings()
      .CreateLogger();

  Copier

  Sample web.config file

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
    <appSettings>
      <add key="serilog:using:NewRelic" value="NewRelic.LogEnrichers.Serilog" />
      <add key="serilog:using:File" value="Serilog.Sinks.File" />
      <!--Add other enrichers here-->
      <add key="serilog:enrich:WithNewRelicLogsInContext" />
      <add key="serilog:write-to:File.path" value="C:\logs\SerilogExample.log.json" />
      <add key="serilog:write-to:File.formatter" value="NewRelic.LogEnrichers.Serilog.NewRelicFormatter, NewRelic.LogEnrichers.Serilog" />
    </appSettings>

  Copier