Este guia é aplicável a clientes que já tenham configurado encaminhamento de logs ou log in context; caso você não tenha configurado nenhum dos recursos, recomendamos atualizar para a versão mais recente do agente para aproveitar o encaminhamento automático de logs e a decoração local.
Se você estiver enviando log do aplicativo para New Relic, será possível enviar log duplicado se você atualizar para o agente de linguagem APM mais recente sem revisar sua estratégia de log atual. O caminho de migração ideal dependerá do seu aplicativo e de seu ambiente.
Se você tiver processamento de dados extensivo ou lógica de enriquecimento em sua configuração de logs existente, o envio de log diretamente do agente APM ignorará essa etapa.
Dica
Tem muito log do Go? Confira nosso tutorial sobre como otimizá-los e gerenciá-los.
Existem dois caminhos principais de atualização que recomendamos para evitar o envio de logs duplicados:
Atualize para o agente APM mais recente, que encaminha automaticamente o log, e então desabilite o direcionador de logs:
- Atualize a configuração framework de log do seu aplicativo para garantir que seu aplicativo não esteja gravando log para preparação ou produção. Isso pode ser para um arquivo no disco ou para STDOUT se você estiver coletando log usando um arquivo secundário
- Desative o encaminhamento de logs seguindo o arquivo de log do seu aplicativo. Desabilitar contêiner(es) usado(s) para coletar log do aplicativo
- Desative o encaminhamento de logs com seu provedor de nuvem
- Reinicie o agente APM/implante suas alterações
Use o agente APM com direcionador de logs (recomendado apenas se um encaminhador já estiver instalado):
- Atualizar o agente APM
- Configure o agente APM para garantir que a decoração log local esteja habilitada e o encaminhamento de logs esteja desabilitado.
- Reverta as alterações anteriores feitas na configuração framework de log do aplicativo para ativar o logs contextualizados manual.
- Confirme se framework de log do aplicativo está configurada para gravar o log do aplicativo em STDOUT ou em um arquivo que está sendo monitorado/assistido por um direcionador de logs.
- Reinicie o agente APM/implante suas alterações
Habilitando decoração local
A documentação sobre como configurar a decoração local na versão mais recente do agente de idioma pode ser encontrada abaixo:
Atualizando com Kubernetes
Se o log in context tiver sido configurado, os clientes que usam nosso Kubernetes encaminhamento de logs precisarão reverter as alterações feitas na framework configuração log do aplicativo ao implementar o log in context manualmente. Isso é necessário para preservar o enriquecimento de metadados do Kubernetes realizado pela nossa integração.
Observe que a framework de log do aplicativo deve ser configurada para gravar o log do aplicativo em STDOUT.
A decoração local precisa estar ativada no agente para garantir que seu registro seja contextualizado. Nenhuma alteração precisa ser feita em sua configuração de encaminhamento de logs.
Siga as etapas abaixo para atualizar seu monitoramento do Kubernetes:
- Atualize o agente APM.
- Configure o agente APM para garantir que a decoração log local esteja habilitada e o encaminhamento de logs esteja desabilitado.
- Reverta as alterações anteriores feitas na configuração framework de registro do aplicativo para ativar o logs contextualizados manual.
- Confirme se framework de log do aplicativo está configurada para gravar o log do aplicativo em STDOUT ou em um arquivo que está sendo monitorado/assistido por um direcionador de logs.
- Reinicie o agente APM/implante suas alterações.