Logs contextualizados do agente .NET

Esta é a abordagem mais simples e é uma ótima opção para desenvolvedores que podem não ter acesso ou interesse em configurar um direcionador de logs ou para contas que desejam ver o poder do log e outros metadados de vinculação no contexto de seus aplicativos sem muita sobrecarga.

Usando esta opção, seu registro inclui span.id, trace.id, hostname, entity.guid e entity.name. Saiba mais sobre as limitações de encaminhamento de logs.

Tudo o que você precisa fazer é instalar uma versão do agente com recursos de encaminhamento de logs (agente .NET 9.7.0 ou superior). Se o encaminhamento estiver desabilitado, você poderá habilitá-lo adicionando o seguinte ao arquivo de configuração do agente:

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

Variáveis ambientais:

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 da versão 9.8.0 do agente, esse recurso é habilitado por padrão.

A partir da versão 10.4.0 do agente, o agente também suporta a captura e encaminhamento de dados de contexto (atributo personalizado) de evento de log. Este sub-recurso está desabilitado por padrão. Para habilitar, use a seguinte configuração:

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

Variáveis ambientais:

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 usa dados de contexto prefixados com "contexto". Por exemplo, um atributo de log customizado denominado myKey com valor myValue para New Relic é context.myKey : myValue.

A biblioteca de registro do .NET que usamos normalmente armazena pares de valores principais de dados de contexto em cada evento de registro como um Dictionary<string,object>. Para converter os valores em strings antes de serem enviados para o New Relic, primeiro tentamos usar Newtonsoft.Json.JsonConvert.SerializeObject. Se isso falhar, tentamos chamar .ToString() no objeto; como último recurso enviaremos o nome do tipo.

Você pode filtrar dados de contexto usando as opções de configuração include e exclude . Estas são listas separadas por vírgulas de nomes de atributos. Os valores padrão para ambos são strings vazias; um campo include vazio significa "incluir tudo". Essas opções de inclusão/exclusão seguem as mesmas regras de outras opções de configuração do agente atributo.

Por exemplo, para incluir todos os atributos que começam com "a" exceto "apple", e excluir todos os atributos que começam com "b" exceto "banana", utilize a seguinte configuração:

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

Variáveis ambientais:

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:

Depois que o encaminhamento de logs estiver habilitado, você também terá controle sobre o número máximo de logs enviados para New Relic a cada minuto. O valor padrão é 10.000. Se mais de 10.000 logs forem recebidos em uma janela de 60 segundos, seu log começará a ser amostrado.

Defina-o para um número mais alto para receber mais log. Defina-o para um número menor para receber menos log. Qualquer número inteiro é válido.

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

Variáveis ambientais:

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

Se você tiver uma solução de encaminhamento de logs existente e estiver atualizando seu agente para usar o logs contextualizados automáticos, certifique-se de disable your manual log forwarder. Caso contrário, seu aplicativo enviará linhas de log duplas. Dependendo da sua conta, isso pode resultar em cobrança dupla. Para obter mais informações, siga os procedimentos para desabilitar seu direcionador de logs específico.

Já tem um encaminhador de logs que você gosta? Estamos protegendo você! O agente de linguagem pode decorar seu log com os metadados de link necessários para fornecer acesso ao recurso de log-in-context automático.

Esta opção não deve ser usada com encaminhamento no agente. Usar um encaminhador de logs externo para enviar log para New Relic enquanto o encaminhamento no agente estiver habilitado fará com que seu log seja enviado duas vezes para New Relic. Dependendo da sua conta, isso pode resultar em cobrança dupla.

1. Se você quiser usar esta opção, certifique-se de ter a opção de configuração de encaminhamento no agente desabilitada.

2. Habilite a decoração de log em sua configuração e reinicie o agente para começar a decorar seu log.

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

   Copiar

   Variáveis ambientais:

   NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=false
   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true

   Copiar

   Importante

   O valor da variável de ambiente, se presente, tem precedência sobre o valor do arquivo de configuração.

   Nosso decorador adiciona cinco atributos a cada log message (texto simples): entity.guid, entity.name, hostname, trace.id e span.id. Exemplo:

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

   Copiar

   Importante

   Para JSON, os dados NR-LINKING devem estar na propriedade message .

   Alguns atributos podem ficar vazios se o log ocorreu fora de uma transação ou se não forem aplicáveis ao contexto do seu aplicativo. Recomendamos esta opção em vez do processo manual de usar um formatador de decoração.

   Importante

   A chave usada para ler o token NR-LINKING de uma framework de registro é NR_LINKING e não NR-LINKING para oferecer suporte à estrutura de registro que não permite hífens em nomes de chave.

   Configuração log4net

   Para log4net, o agente .NET armazena o token NR-LINKING como uma propriedade chamada NR_LINKING no objeto de evento de log. Os exemplos de layout comuns a seguir demonstram como configurar o log4net para gravar o token NR-LINKING . Outros layouts são suportados, mas não estão listados abaixo. SimpleLayout não é suportado porque não pode ser alterado.

   PatternLayout/DynamicPatternLayout: atualize conversionPattern para incluir a propriedade NR_LINKING no final da linha.

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

   Copiar

   log4net.Ext.Json: atualize o layout para incluir um membro chamado NR_LINKING na propriedade JSON da mensagem.

   log4net.Appender.AdoNetAppender: Este appender tem uma configuração ligeiramente diferente de outros layouts. Você precisará atualizar o parâmetro message para incluir os metadados. O exemplo a seguir demonstra isso usando um PatternLayout.

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

   Copiar

   Configuração Serilog

   Para Serilog, o agente .NET armazena o token NR-LINKING como uma propriedade chamada NR_LINKING no objeto de evento de log. Os exemplos comuns de formatador e coletor a seguir demonstram como configurar o Serilog para gravar o token NR-LINKING . Outros coletores e formatadores são suportados, mas não estão listados abaixo.

   Plain text using an outputTemplate: atualize outputTemplate para incluir a propriedade NR_LINKING no final da linha.

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

   Copiar

   JSON Formatter with automatic property output: o JsonFormatter padrão não gravará os metadados NR_LINKING na propriedade da mensagem; em vez disso, ele grava cada propriedade em seu próprio objeto JSON. Você precisará criar um formatador JSON personalizado para gravar os dados NR_LINKING no final da propriedade message antes que o logs contextualizados funcione.

   Configuração de Microsoft.Extensions.Logging

   Para Microsoft.Extensions.Logging, o agente .NET armazena o token NR-LINKING com a mensagem em um escopo recém-criado. Como Microsoft.Extensions.Logging depende de outra estrutura para saída, consulte a configuração log4net ou Serilog acima para obter detalhes.

   Configuração do NLog

   Para NLog, o agente .NET é capaz de anexar automaticamente o token NR-LINKING diretamente ao final da mensagem, portanto, nenhuma configuração adicional é necessária.

Antes que o agente de linguagem pudesse encaminhar e decorar log, você poderia habilitar o logs contextualizados atualizando seu aplicativo para enviar metadados de link.

Esta opção ainda é suportada, mas não é mais incentivada. Para obter instruções sobre como usar essa abordagem, consulte logs contextualizados manual na opção.

Além disso, este método requer que você instale um direcionador de logs antes de ativar o logs contextualizados. Se você não tiver um direcionador de logs, a interface do New Relic prompt que você use nosso agente de infraestrutura.

Se você decidir usar sua solução de encaminhamento de logs existente e posteriormente decidir atualizar seu agente para usar o logs contextualizados automático, certifique-se de disable your manual log forwarder. Caso contrário, seu aplicativo enviará linhas de log duplas. Dependendo da sua conta, isso pode resultar em cobrança dupla. Para obter mais informações, siga os procedimentos para desabilitar seu direcionador de logs específico.

O diagrama a seguir ilustra o fluxo da mensagem do log através do Apache log4net, destacando componentes específicos da extensão log4net New Relic . Muitos encaminhadores de logs estão disponíveis. Este exemplo usa Fluentd.

Appender: O NewRelicAppender adiciona informações contextuais do agente .NET (usando a API) ao evento de log gerado pelo aplicativo. Essas informações contextuais, conhecidas como linking metadados, são utilizadas pela New Relic para vincular mensagens do log à transação e aos spans a partir dos quais foram criadas. Este anexador passará o evento de log enriquecido para anexadores downstream para processamento adicional.

Como NewRelicAppender é do tipo ForwardingAppender , ele precisa ser o primeiro anexador na cadeia. Também requer outro anexador que possa gravar em um destino de saída real como seu filho para funcionar.

Layout: O NewRelicLayout formata o evento de log enriquecido no formato JSON esperado pela New Relic. O anexador, ao qual esse layout é atribuído, instrui o log4net a enviar o JSON para um arquivo no local esperado pelo direcionador de logs.

Log Forwarder: O encaminhador de logs monitora uma pasta de saída e envia incrementalmente as informações adequadamente formatadas e enriquecidas log para o de New Relic registro endpoint.

Log4net usa appender e layout para armazenar e formatar mensagem do log. NewRelicAppender enriquece a mensagem do log com informações contextuais do agente New Relic .NET se ele estiver anexado ao seu aplicativo. O anexador passa mensagem do log enriquecida para anexadores downstream para lidar com casos de uso específicos para mensagem do log.

Para obter mais informações sobre criação de log com log4net, consulte a documentação de primeiros passos do Apache log4net.

Para configurar o logs contextualizados com a extensão log4net:

1. Usando o gerenciador de pacote do Visual Studio NuGet, localize e instale o pacote NewRelic.LogEnrichers.Log4Net .

2. No arquivo de configuração do log4net, atualize a configuração de geração de registros para usar NewRelicAppender como o anexador de primeiro nível e faça referência aos anexadores existentes como seus filhos. Substitua também o layout do anexador que grava a mensagem do log em um destino de saída pelo NewRelicLayout.

   O exemplo de configuração do log4net a seguir enriquece o evento de log com metadados de vinculação New Relic . Além do arquivo de log existente, ele gera um novo arquivo de log em formato JSON específico em C:\logs\log4netExample.log.json para consumo do direcionador de logs:

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

   Copiar

   Depois de configurar a extensão log4net e atualizar seu arquivo de log, você poderá configurar sua extensão para enviar dados para o New Relic. Existem várias opções para encaminhar seus logs. Aqui está um exemplo de configuração usando o agente de infraestrutura para logs contextualizados:

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

   Copiar

   Documentação para usar o encaminhador do agente de infraestrutura

A New Relic extensão NLog fornece um NewRelicJsonLayout que formata um evento de log da maneira exigida pelo de New Relic registro endpoint. Em seguida, ele adiciona informações contextuais do agente .NET quando anexado ao seu aplicativo. Em seguida, um destino pode ser configurado para gravar dados de log em uma pasta de saída. O encaminhador de logs pode monitor esta pasta e enviar informações log de forma incremental para New Relic.

O diagrama a seguir ilustra o fluxo de mensagem do log através do NLog, destacando componentes específicos da extensão New Relic NLog.

New Relic JSON Layout: O NewRelicJsonLayout adiciona informações contextuais do agente .NET (usando a API) ao evento de log gerado pelo aplicativo e gera mensagem do log no formato JSON esperado pelo New Relic. Essas informações contextuais, conhecidas como linking metadados, são utilizadas pela New Relic para vincular mensagens do log à transação e aos spans onde foram criadas.

Como NewRelicAppender é do tipo ForwardingAppender , ele precisa ser o primeiro anexador na cadeia. Também requer outro anexador que possa gravar em um destino de saída real como seu filho para funcionar.

File Target: Um FileTarget define um arquivo no disco onde as mensagens do log são gravadas. Adicionar NewRelicJsonLayout a esse destino permite que a saída seja formatada corretamente para encaminhamento ao New Relic.

Log Forwarder: o encaminhador de logs é configurado para enviar os log dados devidamente formatados e enriquecidos da FileTarget saída para o de geração de registros New Relic endpoint.

Para obter mais informações sobre registro em log com NLog, consulte a documentação do nlog-project.org.

Use nossa extensão NLog 4.5 ou superior para vincular seus dados log com dados relacionados no restante da plataforma New Relic .

1. Usando o gerenciador de pacote do Visual Studio NuGet, localize e instale o pacote NewRelic.LogEnrichers.NLog .

2. No código do aplicativo, atualize a configuração de geração de registros para adicionar NewRelicJsonLayout e decida se deseja coletar dados MappedDiagnosticsContext (MDC) ou MappedDiagnosticsLogicalContext (MDLC).

   Os exemplos de configuração a seguir resultam em novos arquivos JSON gravados no disco. Algumas dessas opções de configuração podem ser úteis para gerenciar a quantidade de espaço em disco usado e/ou o desempenho do destino.

• archiveAboveSize

• maxArchiveFiles

• bufferSize

• enableArchiveFileCompression

• autoFlush

• concurrentWrites

  Embora o destino NLog AsyncWrapper não seja necessário, ele pode ajudar a melhorar o desempenho executando a formatação e a saída do arquivo de log em um thread diferente.

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

  O exemplo de código a seguir enriquece o evento de log com metadados de vinculação New Relic , mas não com dados MDC ou MDLC. Além do arquivo de log existente, ele gera um novo arquivo de log em formato JSON específico em C:\logs\NLogExample.log.json para consumo do direcionador de logs:

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

  Copiar

  Collect MDC or the MDLC data:

  Se seu aplicativo usar o MDC ou o MDLC, você poderá configurar o NewRelicJsonLayout para incluir itens nessas coleções. O exemplo de código a seguir adiciona a configuração adicional para permitir a coleta de dados MDC e MDLC. Assim como no exemplo anterior, ele gera um novo arquivo de log em formato JSON específico em C:\logs\NLogExample.log.json para consumo do direcionador de logs:

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

  Copiar

  Depois de configurar a extensão NLog e atualizar seu arquivo de log, você pode configurar sua extensão para enviar dados para o New Relic. Existem várias opções para encaminhar seus logs. Aqui está um exemplo de configuração usando o agente de infraestrutura para logs contextualizados:

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

  Copiar

  Documentação para usar o encaminhador do agente de infraestrutura

Você também pode configurar a extensão New Relic NLog com provedores de configuração baseados em arquivo. O código de exemplo a seguir cria um agente com base nas configurações contidas em um arquivo 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 é uma framework de log estruturada que registra a mensagem do log do seu aplicativo e cria um LogEvent para armazenar os dados da mensagem. Usando Enrichers, você pode adicionar informações adicionais ao evento de log. Pias e Formatadores permitem formatar e gerar esses eventos de log para consumo e visualização downstream.

O diagrama a seguir ilustra o fluxo da mensagem do log através do Serilog, destacando componentes específicos da extensão New Relic Serilog. Muitos encaminhadores de logs estão disponíveis. Este exemplo usa Fluentd.

New Relic Enricher: O NewRelicEnricher adiciona informações contextuais do agente .NET (usando a API) ao evento de log gerado pelo aplicativo. Essas informações contextuais, chamadas de metadados de vinculação, são utilizadas pela New Relic para vincular mensagens do log à transação e aos spans onde foram criadas.

New Relic Formatter: o NewRelicFormatter traduz o evento de log enriquecido para o formato JSON esperado pela New Relic. Um coletor instrui o Serilog a enviar o JSON para um arquivo no local esperado pelo direcionador de logs.

New Relic Log Forwarder: o encaminhador de logs é configurado para enviar os log dados devidamente formatados e enriquecidos da FileTarget saída para o de geração de registros New Relic endpoint.

Para obter mais informações sobre o evento de log do Serilog, consulte a documentação do Serilog no GitHub.

Para configurar o logs contextualizados com a extensão Serilog:

1. Use o gerenciador de pacote do Visual Studio NuGet para localizar e instalar o pacote NewRelic.LogEnrichers.Serilog .

2. No código do aplicativo, atualize a configuração de geração de registros para adicionar NewRelicEnricher e NewRelicFormatter.

   O exemplo de código a seguir enriquece o evento de log com metadados de vinculação New Relic . Além do arquivo de log existente, ele gera um novo arquivo de log em formato JSON específico em C:\logs\SerilogExample.log.json para consumo do direcionador de logs:

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

   Copiar

   Essa configuração resulta em novos arquivos JSON gravados no disco. Algumas dessas opções de configuração podem ser úteis para gerenciar a quantidade de espaço em disco usado e/ou o desempenho do coletor.

• restrictedToMinimumLevel

• buffered

• rollingInterval

• rollOnFileSizeLimit

• retainedFileCountLimit

  Embora não seja obrigatório, o uso do Serilog Asynchronous Sink Wrapper pode ajudar a melhorar o desempenho realizando a formatação e saída do arquivo de log em uma thread diferente.

3. Depois de configurar a extensão Serilog e atualizar seu arquivo de log, há várias opções para encaminhar seus logs. Aqui está um exemplo de configuração usando o agente de infraestrutura para logs contextualizados:

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

   Copiar

   Documentação para usar o encaminhador do agente de infraestrutura

Você também pode configurar a extensão New Relic Serilog com provedores de configuração baseados em arquivo. Os seguintes pacotes NuGet adicionais são necessários:

• Microsoft.Extensions.Configuration

• Serilog.Settings.Configuration

  O código de exemplo a seguir cria um agente com base nas configurações contidas em um arquivo 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();

  Copiar

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

  Copiar

  O código de exemplo a seguir cria um agente com base nas configurações contidas em um arquivo web.config . O pacote Serilog.Settings.AppSettings NuGet é necessário.

  Instantiating logger using .config file

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

  Copiar

  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>

  Copiar