Com nosso APM de agente Node.js, você pode obter o logs contextualizados, o que permite ver o registro do seu aplicativo no contexto de outros dados New Relic . Para informações gerais sobre este recurso, consulte logs contextualizados APM.
Dica
Tem muitos logs do Node.js? Confira nosso tutorial sobre como otimizá-los e gerenciá-los.
Opções de logs contextualizadosn automático
Com o log do aplicativo, seu agente APM coleta e contextualiza automaticamente seus logs.
Se estiver usando um framework suportado, você tem três opções para configurar o logs contextualizados APM para enviar o log do seu aplicativo e vincular metadados automaticamente ao New Relic.
A estrutura suportada para logs contextualizados automático inclui:
- Winston 3.0.0 ou mais alto.
- Pino 7.0.0 ou superior.
- Bunyan 1.8.12 ou superior (desde a versão 9.3.0 do agente)
Se você não estiver usando um framework suportado, você pode usar o método API de encaminhamento de logs do agente para realizar sua própria instrumentação. Para obter detalhes, consulte a documentação da API do agente Node.js.
Importante
As versões 8.16.0 e superiores do agente possuem esse recurso habilitado no arquivo de configuração do agente por padrão.
Agente encaminhamento de logs causará um aumento no consumo de dados quando uma frameworksuportada for detectada. A quantidade depende do aplicativo e da quantidade de log que ele produz. Este recurso pode ser desativado. Consulte Desativar o registro automático para obter mais informações sobre suas opções.
Se você já possui uma solução de encaminhamento de logs instalada, você deve desabilitar este recurso.
Este documento ajudou você na instalação?
Proteja seus dados
Seu registro pode incluir informações confidenciais protegidas pela HIPAA ou outros protocolos de conformidade. Por padrão, ofuscamos padrões numéricos que parecem ser de itens como cartões de crédito ou números de Seguro Social, mas pode ser necessário aplicar hash ou mascarar informações adicionais.
Para mais informações, veja nossa documentação sobre expressão de ofuscação e regras. Você pode aplicar hash ou mascarar seus dados log usando a interface New Relic ou NerdGraph, nossa API GraphQL.
Explore seus dados
Para aproveitar ao máximo seus dados de registro:
Na página
doAPM , clique no gráfico
Web transaction time
para visualizar o registro associado a um momento específico.
Verifique
do seu aplicativo para visualizar o registro associado aos seus erros.
Use distributed tracing para ver o log associado ao rastreamento individual.
Explore mais dados de registro em sua plataforma com nossa interface de registro.
Configure alertas com base na saída e na gravidade do log.
consulte seus dados usando nossa interface especializada para dados de log e crie um painel com os resultados.
Dicas de resolução de problemas
Normalmente, seu registro começará a aparecer menos de um minuto após você ativar o logs contextualizados. Verifique a seção Triage > Logs do seu aplicativo. Você também começará a ver Padrões de log relacionados ao erro ali.
Se você não vir nenhum log de erros ou rastreamento, talvez não haja nenhum para seu aplicativo. Tente atualizar a página da interface ou altere o período selecionado.
Desabilitar o registro automático
O logs contextualizados APM encaminha automaticamente os dados log do APM do agente. Ele está habilitado por padrão. Se você ativar o log do aplicativo, isso poderá ter um impacto negativo na segurança, na conformidade, no faturamento ou no desempenho do sistema. Para obter mais informações ou se precisar ajustar a configuração padrão, siga os procedimentos para desativar o registro automático.
Opção de logs contextualizados manual
Para ativar o logs contextualizados para aplicativos monitorados por Node.js, você pode usar nossa opção de instalação manual.
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.
Instale ou atualize para a versão mais recente do agente Node.js e ative distributed tracing. Use o agente Node.js versão 6.2.0 ou superior para logs contextualizados.
Instale uma framework compatível para enriquecer seus dados log ou use diretamente a API de encaminhamento de logs do agente.
Na configuração do seu agente, defina
application_config.enabled
comofalse
. (Caso contrário, o agente irá automaticamente instrumentar o seu agente e chamar você mesmo esses enriquecedores não fará nada.)Configure o logs contextualizados para Node.js usando a extensão log apropriada.
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. Se você quiser ver um exemplo funcional de logs contextualizados, dê uma olhada em nosso aplicativo de exemplo.
Qual é o próximo?
Depois de configurar o logs contextualizados, aproveite ao máximo seus dados de registro:
- Explore os dados de registro em sua plataforma com nossa interface de registro.
- Veja seu logs contextualizados do desempenho do seu aplicativo na interfaceAPM . Solucione erros com distributed tracing, rastreamento de pilha, registro de aplicativo e muito mais.
- Obtenha visibilidade mais profunda do seu aplicativo e dos dados de desempenho da plataforma encaminhando seu log com nosso agente de infraestrutura. Revise seu log de infraestrutura na interface.
- Configure o alerta.
- consulte seus dados e crie dashboard.