O agente .NET da New Relic oferece suporte tanto ao .NET Framework quanto ao ..NET Core. Este documento descreve a compatibilidade e o suporte para tempos de execução, estrutura e biblioteca do .NET.
O agente inclui instrumentação integrada para algumas das partes mais populares do ecossistema .NET, incluindo estrutura, banco de dados e sistemas de enfileiramento de mensagens. Depois de fazer download e instalar o agente, ele será executado no processo do monitor. O agente não cria um processo ou serviço separado.
Para framework e biblioteca que não são instrumentados automaticamente, você pode estender o agente com instrumentação personalizada .NET.
Quer experimentar nosso agente .NET? Crie uma conta New Relic gratuitamente! Não é necessário cartão de crédito.
Requisitos
Antes de instalar o agente .NET New Relic no Windows ou Linux, certifique-se de que seu sistema atenda a estes requisitos:
Instrumentação automática
Se o seu aplicativo estiver hospedado em ASP..NET Core, o agente cria automaticamente um instrumento de transação. O agente .NET instrumenta automaticamente seu aplicativo após a instalação. Se seu aplicativo não for instrumentado automaticamente ou se você quiser adicionar instrumentação, use instrumentação personalizada.
Recurso indisponível
Os seguintes recursos não estão disponíveis para o agente .NET:
O agente .NET não suporta trim implantação e executáveis independentes, porque o compilador pode potencialmente cortar assemblies dos quais o agente depende.
O Infinite Tracing não é compatível com Alpine Linux devido a um problema de compatibilidade GRPC. Consulte este problema do agente para obter mais informações.
O agente .NET não suporta a implantação Native Ahead of Time (AOT) para o aplicativo .NET porque a compilação just-in-time (JIT) é necessária para que o agente funcione corretamente.
Conecte o agente a outros produtos New Relic
Além do APM, o agente .NET se integra a outros produtos New Relic para oferecer visibilidade de ponta a ponta:
Produtos
Integração
Para aplicativos Web ASP..NET Core v6.0 e posteriores (MVC, Razor e Blazor), o agente .NET (a partir da versão 10.19.0) injeta automaticamente o agente JavaScript do browser quando você habilita a instrumentação automática.
Para outros tipos de aplicativos da web, você pode injetar o agente usando a API do agente .NET ou o método copiar/colar do agente browser.
Depois de ativar a injeção do browser, você pode visualizar os dados do browser na página Resumo do APM e alternar rapidamente entre o APM e os dados do browser para um aplicativo específico. Para opções de configuração e instrumentação manual, consulte monitoramento de Browser e agente .NET.
Ao instalar a infraestrutura e o agente APM no mesmo host, eles detectam um ao outro automaticamente. Você pode então visualizar uma lista de hosts na interface do APM e filtrar seus hosts de infraestrutura por aplicativo APM em nossa interface de infraestrutura. Para obter mais informações, consulte Dados do APM na interface de infraestrutura.
O agente .NET envia evento e atributo padrão para consulta NRQL. Você também pode gravar eventos personalizados para análise avançada.
Requisitos
Antes de instalar o agente .NET da New Relic, certifique-se de que seu sistema atenda a estes requisitos:
Instrumentação automática
Se seu aplicativo estiver hospedado no ASP.NET ou em outro frameworktotalmente suportado, o agente .NET instrumentará automaticamente seu aplicativo após a instalação. Se seu aplicativo não for instrumentado automaticamente ou se você quiser adicionar instrumentação, use instrumentação personalizada.
O agente .NET não monitor diretamente os processos do armazenamento de dados. Além disso, por padrão, a captura de parâmetros SQL do .NET em um trace de consulta não lista parâmetros para uma consulta parametrizada ou um procedimento armazenado. A coleta do parâmetro de consulta SQL pode ser habilitada na configuração do agente.
Recurso indisponível
A compilação just-in-time (JIT) é um requisito para a funcionalidade do agente .NET, portanto, as imagens nativas criadas com o Native Image Generator (NGEN) não são suportadas pelo agente .NET.
Conecte o agente a outros produtos New Relic
Além do APM, o agente se integra a outros produtos da New Relic para oferecer visibilidade de ponta a ponta:
Produtos | Integração |
|---|---|
Para o aplicativo Web ASP.NET, o agente .NET injeta automaticamente o agente JavaScript do browser quando você habilita a instrumentação automática. Depois de ativar a injeção do browser, você poderá visualizar os dados do browser na página Resumo do APM e alternar rapidamente entre os dados e de um aplicativo específico. Para opções de configuração e instrumentação manual, consulte monitoramento de Browser e agente .NET. | |
Ao instalar a infraestrutura e o agente APM no mesmo host, eles detectam um ao outro automaticamente. Você pode então visualizar uma lista de hosts na interface do APM e filtrar seus hosts por aplicativo APM em nossa interface de infraestrutura. Para obter mais informações, consulte Dados do APM na interface de infraestrutura. | |
O agente .NET envia evento e atributo padrão para consulta NRQL. Você também pode gravar eventos personalizados para análise avançada. | |
Sintético trace da transação conecta solicitações do monitor Sintético à transação APM subjacente. |