El agente .NET logs en el contexto

Este es el enfoque más simple y es una excelente opción para desarrolladores que quizás no tengan acceso o interés en configurar un reenviador de registros, o para cuentas que quieran ver el poder de los registros y otros metadatos de enlace en el contexto de sus aplicaciones. sin muchos gastos generales.

Al utilizar esta opción, su registro incluye span.id, trace.id, hostname, entity.guid y entity.name. Obtenga más información sobre las limitaciones del reenvío de registros.

Todo lo que necesita hacer es instalar una versión del agente con capacidades de reenvío de registros (.NET agente 9.7.0 o superior). Si el reenvío está deshabilitado, puede habilitarlo agregando lo siguiente al archivo de configuración de su agente:

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

Variables de entorno:

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

A partir de la versión 9.8.0 del agente, esta característica está habilitada de forma predeterminada.

A partir de la versión 10.4.0 del agente, el agente también admite la captura y reenvío de datos de contexto (atributo personalizado) desde el registro de eventos. Esta subcaracterística está deshabilitada por defecto. Para habilitarlo, utilice la siguiente configuración:

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

Variables de entorno:

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 utiliza datos de contexto con el prefijo "contexto". Por ejemplo, un atributo log personalizado denominado myKey con valor myValue para New Relic es context.myKey : myValue.

La biblioteca de registro .NET que utilizamos generalmente almacena pares principales de valores de datos de contexto en cada registro de evento como Dictionary<string,object>. Para convertir los valores en cadenas antes de enviarlos a New Relic, primero intentamos usar Newtonsoft.Json.JsonConvert.SerializeObject. Si eso falla, intentamos llamar .ToString() en el objeto; como último recurso enviaremos el nombre del tipo.

Puede filtrar datos de contexto utilizando las opciones de configuración include y exclude . Estas son listas de nombres de atributos separados por comas. Los valores predeterminados para ambos son cadenas vacías; un campo include vacío significa "incluir todo". Estas opciones de inclusión/exclusión siguen las mismas reglas que otras opciones de configuración de atributos de agente.

Por ejemplo, para incluir todos los atributos que comienzan con "a" excepto "apple" y excluir todos los atributos que comienzan con "b" excepto "banana", use la siguiente configuración:

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

Variables de entorno:

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:

Una vez habilitado el reenvío de registros, también tendrá control sobre la cantidad máxima de registros enviados a New Relic cada minuto. El valor predeterminado es 10.000. Si se reciben más de 10 000 registros en un período de 60 segundos, se comenzará a muestrear su registro.

Configúrelo en un número más alto para recibir más registros. Configúrelo en un número más bajo para recibir menos registros. Cualquier número entero es válido.

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

Variables de entorno:

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 ya tiene una solución de reenvío de registros y está actualizando su agente para usar el logs en el contexto automático, asegúrese de disable your manual log forwarder. De lo contrario, su aplicación enviará líneas log dobles. Dependiendo de su cuenta, esto podría resultar en una doble facturación. Para obtener más información, siga los procedimientos para desactivar su reenviador de registros específico.

¿Ya tienes un reenviador de logs que te gusta? ¡Te tenemos cubierto! Language Agent puede decorar su registro con los metadatos de enlace necesarios para proporcionar acceso a la característica de contexto de inicio de sesión automático.

Esta opción no debe usarse con el reenvío dentro del agente. El uso de un reenviador de registros externo para enviar registros a New Relic mientras el reenvío en el agente está habilitado hará que su registro se envíe dos veces a New Relic. Dependiendo de su cuenta, esto puede resultar en una facturación doble.

1. Si desea utilizar esta opción, asegúrese de tener desactivada la opción de configuración de reenvío en el agente.

2. Habilite la decoración log en su configuración, luego reinicie el agente para comenzar a decorar su tronco.

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

   Copia

   Variables de entorno:

   NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=false
   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true

   Copia

   Importante

   El valor de la variable de entorno, si está presente, tiene prioridad sobre el valor del archivo de configuración.

   Nuestro decorador agrega cinco atributos a cada log message (texto sin formato): entity.guid, entity.name, hostname, trace.id y span.id. Ejemplo:

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

   Copia

   Importante

   Para JSON, los datos NR-LINKING deben estar en la propiedad message .

   Algunos atributos pueden estar vacíos si el log ocurrió fuera de una transacción o si no son aplicables al contexto de su aplicación. Recomendamos esta opción en lugar del proceso manual para utilizar un formateador decorativo.

   Importante

   La clave utilizada para leer el token NR-LINKING de un framework de registro es NR_LINKING y no NR-LINKING para admitir un marco de registro que no permite guiones en los nombres de las claves.

   Configuración de log4net

   Para log4net, el agente .NET almacena el token NR-LINKING como una propiedad llamada NR_LINKING en el objeto de registro de eventos. Los siguientes ejemplos de diseño común demuestran cómo configurar log4net para escribir el token NR-LINKING . Se admiten otros diseños, pero no se enumeran a continuación. SimpleLayout no es compatible porque no se puede modificar.

   PatternLayout/DynamicPatternLayout: actualice conversionPattern para incluir la propiedad NR_LINKING al final de la línea.

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

   Copia

   log4net.Ext.Json: actualice el diseño para incluir un miembro llamado NR_LINKING en la propiedad JSON del mensaje.

   log4net.Appender.AdoNetAppender: este apéndice tiene una configuración ligeramente diferente a la de otros diseños. Deberá actualizar el parámetro message para incluir los metadatos. El siguiente ejemplo demuestra esto usando 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>

   Copia

   Configuración de Serilog

   Para Serilog, el agente .NET almacena el token NR-LINKING como una propiedad llamada NR_LINKING en el objeto de registro de eventos. Los siguientes ejemplos comunes de formateador y receptor demuestran cómo configurar Serilog para escribir el token NR-LINKING . Se admiten otros receptores y formateadores, pero no se enumeran a continuación.

   Plain text using an outputTemplate: actualice outputTemplate para incluir la propiedad NR_LINKING al final de la línea.

   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();

   Copia

   JSON Formatter with automatic property output: El JsonFormatter predeterminado no escribirá los metadatos NR_LINKING en la propiedad del mensaje; en cambio, escribe cada propiedad en su propio objeto JSON. Deberá crear un formateador JSON personalizado para escribir los datos NR_LINKING al final de la propiedad message antes de que funcione el logs en el contexto.

   Configuración de Microsoft.Extensions.Logging

   Para Microsoft.Extensions.Logging, el agente .NET almacena el token NR-LINKING con el mensaje en un ámbito recién creado. Dado que Microsoft.Extensions.Logging depende de otro marco para la salida, consulte la configuración de log4net o Serilog anterior para obtener más detalles.

   Configuración de registro N

   Para NLog, el agente .NET puede agregar automáticamente el token NR-LINKING directamente al final del mensaje, por lo que no se requiere configuración adicional.

Antes de que Language Agent tuviera la capacidad de reenviar y decorar registros, podía habilitar el logs en el contexto actualizando su aplicación para enviar metadatos de enlace.

Esta opción todavía se admite, pero ya no se recomienda. Para obtener instrucciones sobre cómo utilizar este enfoque, consulte Opción de logs en el contexto manual.

Además, este método requiere que instale un reenviador de registros antes de habilitar el logs en el contexto. Si no tiene un reenviador de registros, la New Relic UI le indicará que utilice nuestro agente de infraestructura.

Si decide utilizar su solución de reenvío de registros existente y luego decide actualizar su agente para usar el logs en el contexto automático, asegúrese de disable your manual log forwarder. De lo contrario, su aplicación enviará líneas log dobles. Dependiendo de su cuenta, esto podría resultar en una doble facturación. Para obtener más información, siga los procedimientos para desactivar su reenviador de registros específico.

El siguiente diagrama ilustra el flujo de mensajes de registro a través de Apache log4net, destacando componentes específicos de la extensión New Relic log4net. Hay muchos reenviadores de logs disponibles. Este ejemplo utiliza Fluentd.

Appender: El NewRelicAppender agrega información contextual del agente .NET (usando la API) al registro de eventos generado por la aplicación. New Relic utiliza esta información contextual, conocida como metadatos de enlace, para vincular el mensaje de registro con la transacción y los tramos a partir de los cuales se crearon. Este agregador pasará el registro de eventos enriquecido a los agregadores posteriores para su posterior procesamiento.

Dado que NewRelicAppender es del tipo ForwardingAppender , debe ser el primer agregado de la cadena. También requiere otro apéndice que pueda escribir en un destino de salida real como su hijo para poder funcionar.

Layout: NewRelicLayout formatea el registro de eventos enriquecido en el formato JSON esperado por New Relic. El adjunto, al que está asignado este diseño, indica a log4net que envíe el JSON a un archivo en la ubicación que espera el reenviador de registros.

Log Forwarder: El reenviador de registros monitorea una carpeta de salida y envía incrementalmente la información log enriquecida y formateada correctamente al extremo de registro New Relic .

Log4net utiliza appender y layout para almacenar y formatear mensajes de registro. NewRelicAppender enriquece el mensaje de registro con información contextual del agente .NET New Relic si está adjunto a su aplicación. El agregador pasa el mensaje de registro enriquecido a los agregadores posteriores para manejar casos de uso específicos para el mensaje de registro.

Para obtener más información sobre cómo iniciar sesión con log4net, consulte la documentación de introducción a Apache log4net.

Para configurar el logs en el contexto con la extensión log4net:

1. Usando el administrador de paquetes de Visual Studio NuGet, ubique e instale el paquete NewRelic.LogEnrichers.Log4Net .

2. En su archivo de configuración de log4net, actualice su configuración de registro para usar NewRelicAppender como agregador de primer nivel y haga referencia a sus agregados existentes como sus hijos. También reemplace el diseño del apéndice que escribe el mensaje de registro en un destino de salida con NewRelicLayout.

   El siguiente ejemplo de configuración de log4net enriquece el registro de eventos con metadatos de enlace New Relic . Además del archivo de registro existente, genera un nuevo archivo de registro en un formato JSON específico en C:\logs\log4netExample.log.json para que lo consuma el reenviador de registros:

   <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>

   Copia

   Después de configurar la extensión log4net y actualizar su archivo de registro, puede configurar su extensión para enviar datos a New Relic. Hay varias opciones para reenviar sus registros. Aquí hay un ejemplo de configuración usando el agente de infraestructura para logs en el contexto:

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

   Copia

   Documentación para utilizar el reenviador del agente de infraestructura

La extensión New Relic NLog proporciona un NewRelicJsonLayout que formatea un registro de eventos de la forma requerida por el extremo de registro New Relic . A continuación, agrega información contextual del agente .NET cuando se adjunta a su aplicación. Luego, se puede configurar un objetivo para escribir datos de registro en una carpeta de salida. El reenviador de registros puede monitor esta carpeta y enviar incrementalmente información log a New Relic.

El siguiente diagrama ilustra el flujo de mensajes de registro a través de NLog, destacando componentes específicos de la extensión New Relic NLog.

New Relic JSON Layout: NewRelicJsonLayout agrega información contextual del agente .NET (usando la API) al registro de eventos generado por la aplicación y genera un mensaje de registro en el formato JSON esperado por New Relic. New Relic utiliza esta información contextual, conocida como metadatos de enlace, para vincular el mensaje de registro con la transacción y los tramos donde se crearon.

Dado que NewRelicAppender es del tipo ForwardingAppender , debe ser el primer agregado de la cadena. También requiere otro apéndice que pueda escribir en un destino de salida real como su hijo para poder funcionar.

File Target: Un FileTarget define un archivo en el disco donde se escriben los mensajes de registro. Agregar el NewRelicJsonLayout a ese objetivo permite que la salida se formatee correctamente para reenviarla a New Relic.

Log Forwarder: El reenviador de registros está configurado para enviar los datos log enriquecidos y formateados correctamente desde la salida FileTarget al extremo de registro New Relic .

Para obtener más información sobre cómo iniciar sesión con NLog, consulte la documentación de nlog-project.org.

Utilice nuestra extensión NLog 4.5 o superior para vincular sus datos log con datos relacionados en el resto de la plataforma New Relic .

1. Usando el administrador de paquetes de Visual Studio NuGet, ubique e instale el paquete NewRelic.LogEnrichers.NLog .

2. En el código de su aplicación, actualice su configuración de registro para agregar NewRelicJsonLayout y decida si desea recopilar datos de MappedDiagnosticsContext (MDC) o MappedDiagnosticsLogicalContext (MDLC).

   Los siguientes ejemplos de configuración dan como resultado nuevos archivos JSON que se escriben en el disco. Algunas de estas opciones de configuración pueden ser útiles para administrar la cantidad de espacio en disco utilizado y/o el rendimiento del objetivo.

• archiveAboveSize

• maxArchiveFiles

• bufferSize

• enableArchiveFileCompression

• autoFlush

• concurrentWrites

  Aunque el objetivo NLog AsyncWrapper no es necesario, puede ayudar a mejorar el rendimiento al realizar el formateo y la salida del archivo de registro en un subproceso diferente.

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

  El siguiente ejemplo de código enriquece el registro de eventos con metadatos de enlace New Relic , pero no con datos MDC o MDLC. Además del archivo de registro existente, genera un nuevo archivo de registro en un formato JSON específico en C:\logs\NLogExample.log.json para que lo consuma el reenviador de registros:

  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");

  Copia

  Collect MDC or the MDLC data:

  Si su aplicación utiliza MDC o MDLC, puede configurar NewRelicJsonLayout para incluir elementos en esas colecciones. El siguiente ejemplo de código agrega la configuración adicional para permitir la recopilación de datos MDC y MDLC. Como en el ejemplo anterior, genera un nuevo archivo de registro en un formato JSON específico en C:\logs\NLogExample.log.json para que lo consuma el reenviador de registros:

  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");

  Copia

  Una vez que haya configurado la extensión NLog y haya actualizado su archivo de registro, puede configurar su extensión para enviar datos a New Relic. Hay varias opciones para reenviar sus registros. Aquí hay un ejemplo de configuración usando el agente de infraestructura para logs en el contexto:

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

  Copia

  Documentación para utilizar el reenviador del agente de infraestructura

También puede configurar la extensión New Relic NLog con proveedores de configuración basados en archivos. El siguiente código de ejemplo crea un logger basado en la configuración contenida en un archivo 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 es un framework de registro estructurado que registra el mensaje de registro de su aplicación y crea un LogEvent para almacenar los datos del mensaje. Usando Enrichers, puedes agregar información adicional al registro de eventos. Los receptores y formateadores le permiten formatear y generar esos registros de eventos para su consumo y visualización posteriores.

El siguiente diagrama ilustra el flujo de mensaje de registro a través de Serilog, destacando componentes específicos de la extensión New Relic Serilog. Hay muchos reenviadores de logs disponibles. Este ejemplo utiliza Fluentd.

New Relic Enricher: El NewRelicEnricher agrega información contextual del agente .NET (usando la API) al registro de eventos generado por la aplicación. New Relic utiliza esta información contextual, llamada metadatos de enlace, para vincular el mensaje de registro con la transacción y los tramos donde se crearon.

New Relic Formatter: NewRelicFormatter traduce el registro de eventos enriquecido al formato JSON esperado por New Relic. Un receptor le indica a Serilog que envíe el JSON a un archivo en la ubicación que espera el reenviador de registros.

New Relic Log Forwarder: El reenviador de registros está configurado para enviar los datos log enriquecidos y formateados correctamente desde la salida FileTarget al extremo de registro New Relic .

Para obtener más información sobre el registro de eventos de Serilog, consulte la documentación de Serilog en GitHub.

Para configurar el logs en el contexto con la extensión Serilog:

1. Utilice el administrador de paquetes de Visual Studio NuGet para localizar e instalar el paquete NewRelic.LogEnrichers.Serilog .

2. En el código de su aplicación, actualice su configuración de registro para agregar NewRelicEnricher y NewRelicFormatter.

   El siguiente ejemplo de código enriquece el registro de eventos con metadatos de enlace New Relic . Además del archivo de registro existente, genera un nuevo archivo de registro en un formato JSON específico en C:\logs\SerilogExample.log.json para que lo consuma el reenviador de registros:

   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();

   Copia

   Esta configuración da como resultado nuevos archivos JSON que se escriben en el disco. Algunas de estas opciones de configuración pueden ser útiles para administrar la cantidad de espacio en disco utilizado y/o el rendimiento del disipador.

• restrictedToMinimumLevel

• buffered

• rollingInterval

• rollOnFileSizeLimit

• retainedFileCountLimit

  Aunque no es necesario, el uso del Serilog Asynchronous Sink Wrapper puede ayudar a mejorar el rendimiento al realizar el formateo y la salida del archivo de registro en un subproceso diferente.

3. Una vez que haya configurado la extensión Serilog y haya actualizado su archivo de registro, existen varias opciones para reenviar sus registros. Aquí hay un ejemplo de configuración usando el agente de infraestructura para logs en el contexto:

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

   Copia

   Documentación para utilizar el reenviador del agente de infraestructura

También puede configurar la extensión New Relic Serilog con proveedores de configuración basados en archivos. Se requieren los siguientes paquetes NuGet adicionales:

• Microsoft.Extensions.Configuration

• Serilog.Settings.Configuration

  El siguiente código de ejemplo crea un logger basado en la configuración contenida en un archivo 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();

  Copia

  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"
      }
    }
  }

  Copia

  El siguiente código de ejemplo crea un logger basado en la configuración contenida en un archivo web.config. Se requiere el paquete NuGet Serilog.Settings.AppSettings .

  Instantiating logger using .config file

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

  Copia

  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>

  Copia