Logs contextualizados do agente Node.js

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, o agente reporta todo o seu log e adiciona nossos atributos span.id, trace.id, hostname, entity.guid e entity.name. Esses atributos vinculam seu log a spans, rastreamento e outras telemetrias, facilitando a solução de problemas.

Tudo o que você precisa fazer é instalar uma versão do agente com recursos de encaminhamento de logs (Node.js agente 8.11.0 ou superior). Se o encaminhamento estiver desabilitado, você poderá usar esta configuração:

newrelic.js:

application_logging: {
  forwarding: {
    enabled: true
  }
}

Variável de ambiente:

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

Esta opção está ativada por padrão desde a versão 8.16.0 do agente.

Optional adjustments:

Depois de habilitado, você também terá controle sobre o número máximo de logs enviados ao 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 até 100.000 é válido. Aumentar esse valor pode aumentar a utilização de CPU e RAM do agente.

newrelic.js:

application_logging: {
  forwarding: {
    max_samples_stored: 10000
  }
}

Variável de ambiente:

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED: 10000

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.

   newrelic.js:

   application_logging: {
     forwarding: {
       enabled: false
     }
   }

   Copiar

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

   newrelic.js:

   application_logging: {
     local_decorating: {
       enabled: true
     }
   }

   Copiar

   Variável de ambiente:

   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED=true

   Copiar

   Nosso decorador adiciona cinco atributos a cada mensagem do log: 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

   Se a mensagem do log estiver vazia ou em branco, a mensagem de saída também estará vazia. Exemplo:

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

   Copiar

   A mensagem do log de saída será uma string vazia.

   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.