Com nosso agente .NET, você pode obter o logs in context, 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 muito log .Net? Confira nosso tutorial sobre como otimizá-los e gerenciá-los.
Opções de logs contextualizadosn automático
Você tem três opções para configurar o log in context para enviar o log do seu aplicativo e vincular metadados automaticamente ao New Relic. A estrutura suportada para logs contextualizados automático usando encaminhamento de agente inclui:
Frameworks | Versão mínima framework | Versão mínima do agente |
---|---|---|
Log4Net | Para framework.NET: v1.2.10 Para .NET Core: v2.0.10 | v9.7.0 |
Serilog | Para framework.NET: v2.0.0 Para .NET Core: v2.5.0 | v9.7.0 |
NLog | Para framework.NET: v4.1.0 Para .NET Core: v4.5.0 | v9.7.0 |
Microsoft.Extensions.Logging | v3.0.0 | Para framework.NET: agente v9.7.0 Para ..NET Core: agente v10.0.0 |
Dica
Muitas versões do Sitecore usam Sitecore.Logging, que é baseado em um fork do log4net, mas independente. O suporte para esta biblioteca foi adicionado na versão 10.14.0 do agente .NET.
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 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 log começará a aparecer menos de um minuto depois de você ativar o logs contextualizados APM. 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 dados log do agente e é ativado por padrão. Isso pode ter um impacto negativo na segurança, conformidade, faturamento ou 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
Se você precisar usar o processo manual para configurar o logs contextualizados para .NET, siga estas etapas:
- 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 .NET e habilite distributed tracing. Use o agente .NET versão 8.21 ou superior e a API New Relic .NET do agente versão 8.21 ou superior para logs contextualizados.
- Instale ou atualize para o Microsoft .NET Framework 4.5 ou superior ou .NET Core 2.0 ou superior.
- Instale e configure qualquer uma das seguintes extensões de log para enriquecer seus dados de log, incluindo:
- Verifique seus dados log na interface New Relic .
Configurar extensão log4net
Você pode usar a extensão Apache log4net versão 2.0.8 ou superior para vincular seus dados de log a dados relacionados no restante da plataforma New Relic.
Configurar extensão NLog
Você pode usar nossa extensão NLog 4.5 ou superior para vincular seus dados log com dados relacionados no restante da plataforma New Relic .
Configurar extensão Serilog 2.5 ou superior
Você pode usar nossa extensão Serilog para vincular seus dados log com dados relacionados no restante da plataforma New Relic . Isto exige: