Log contextualizadosdo agente Python

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 adiciona 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 Python 7.12.0.176 ou superior). Se o encaminhamento estiver desabilitado, você poderá usar esta configuração:

newrelic.ini:

application_logging.enabled=true
application_logging.forwarding.enabled=true

Variável de ambiente:

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

Esta opção está ativada por padrão a partir da versão do agente 7.16.0.178.

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.

newrelic.ini:

event_harvest_config.harvest_limits.log_event_data=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.

Esta opção também não deve ser usada com o formatador manual de decoração log . Se você tiver referências ao formatador manual em sua base de código, remova-as antes de ativar esta opção.

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

   newrelic.ini:

   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.ini:

   application_logging.enabled=true
   application_logging.forwarding.enabled=false
   application_logging.local_decorating.enabled=true

   Copiar

   Variável de ambiente:

   NEW_RELIC_APPLICATION_LOGGING_ENABLED: "true"
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED: "false"
   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.

   Recomendamos esta opção em vez do formatador de decoração manual, NewRelicContextFormatter.

Você também pode usar nossa opção de instalação manual para ativar o logs contextualizados para APMaplicativos monitorados por Python.

1. Certifique-se de já ter configurado o login no New Relic. Isso inclui a configuração de um encaminhador de logs compatível que coleta seu log do aplicativo e estende os metadados que são encaminhados para New Relic.

2. Instale ou atualize para a versão mais recente do agente Python e ative distributed tracing. Use o agente Python versão 5.4.0 ou superior para logs contextualizados.

3. Configure o logs contextualizados para seu manipulador log . Antes que o agente de linguagem tivesse a capacidade de encaminhar e decorar o log, você poderia habilitar o logs contextualizados instanciando um formatador log e adicionando-o ao seu manipulador log . Este exemplo usa um StreamHandler que por padrão grava log em sys.stderr, mas qualquer manipulador pode ser usado. Para obter mais informações sobre como configurar manipuladores de log, consulte a documentação do Python.org.

   # Import the logging module and the New Relic log formatter
   import logging
   from newrelic.agent import NewRelicContextFormatter
   
   # Instantiate a new log handler
   handler = logging.StreamHandler()
   
   # Instantiate the log formatter and add it to the log handler
   formatter = NewRelicContextFormatter()
   handler.setFormatter(formatter)
   
   # Get the root logger and add the handler to it
   root_logger = logging.getLogger()
   root_logger.addHandler(handler)

   Copiar

4. Para verificar se você configurou o anexador log corretamente, execute seu aplicativo e verifique seus dados de log no New Relic usando o operador de consulta has:span.id has:trace.id.

   Se tudo estiver configurado corretamente e seus dados estiverem sendo encaminhados para New Relic com os metadados enriquecidos, seu log agora deverá ser emitido como JSON e conter os campos trace.id e span.id. Se você não vir os dados log na interface, siga os procedimentos de resolução de problemas.