Compatibilidade do agente .NET e requisitos para .NET Core
O agente .NET da New Relic oferece suporte ao .NET framework e ao .NET Core. Este documento descreve a compatibilidade e o suporte para o aplicativo .NET Core. Consulte Compatibilidade e requisitos do .NET framework para o aplicativo .NET framework .
O agente .NET da New Relic inclui instrumentação integrada para algumas das partes mais populares do ecossistema .NET Core, incluindo estrutura, banco de dados e sistemas de enfileiramento de mensagens.
Após a instalação, o agente é executado no processo de monitoramento; não há um processo ou serviço separado criado pelo agente.
As datas oficiais de início e término do ciclo de vida do produto podem ser encontradas na documentação da Microsoft.
Nosso suporte ao agente .NET da versão Core abaixo de 3.1 terminou com nosso suporte ao agente 9.x New Relic .NET. A partir do agente New Relic .NET versão 10.0, iremos destino ..NET Core 3.1 em diante.
O agente .NET oferece suporte ao .NET Core versão 3.1 e .NET 5.0, 6.0 e 8.0.
Versão do .NET Core
Versão mínima necessária do agente .NET
.NET Core 3.1
8.21.34.0 e superior
.NET 5.0
8.35.0 e superior
.NET 6.0
9.2.0 e superior
.NET 7.0
10.0.0 e superior
.NET 8.0
10.0.0 e superior
Importante
Na plataforma Linux ARM64, o agente .NET only suporta versões do .NET 5.0 ou superior.
O agente .NET oferece suporte apenas a aplicativos direcionados ao .NET Core 3.1 e .NET 5.0, 6.0 e 8.0. Você pode encontrar a framework destino em seu arquivo .csproj. A compatibilidade do agente varia entre diferentes versões do .NET Core. Para obter informações sobre qual versão do agente usar para a versão de destino do .NET Core do seu aplicativo, consulte a seção acima de nossa documentação, Microsoft .NET Core version.
Suportado:
<TargetFramework>netcoreapp3.1</TargetFramework>
<TargetFramework>net5.0</TargetFramework>
<TargetFramework>net6.0</TargetFramework>
<TargetFramework>net7.0</TargetFramework>
<TargetFramework>net8.0</TargetFramework>
Importante
Na plataforma Linux ARM64, o agente .NET only suporta estrutura de destino de net5.0 ou superior.
Não suportado:
<TargetFramework>net452</TargetFramework>
Importante
Se você quiser monitor um aplicativo ASP..NET Core direcionado ao .NET framework, certifique-se de que sua instalação do agente .NET tenha o suporte ao .NET framework habilitado.
Certifique-se de usar um destes servidores de aplicativo/web:
Francelho
Kestrel com proxy reverso do IIS via AspNetCoreModule
Kestrel com proxy reverso do IIS via AspNetCoreModuleV2
Kestrel com proxy reverso Nginx
Kestrel com proxy reverso Apache
Hospedagem em processo
Foi verificado que o agente funciona com o seguinte sistema operacional:
Sistema operacional
Versões suportadas
Windows (arquitetura compatível com Intel de 32 e 64 bits)
Servidor Windows 2008 R2 SP1
Servidor Windows 2012
Servidor Windows 2012 R2
Servidor Windows 2016
Servidor Windows 2019
Servidor Windows 2022
Windows 10
Windows 11
Contêiner Windows rodando no Server 2016 (imagens baseadas em NanoServer não são suportadas)
Linux (compatível apenas com Intel de 64 bits)
Todas as distribuições x64 Linux suportadas pelo tempo de execução .NET Core 2.0+/.NET 5+ são suportadas pelo agente .NET. Para obter uma lista completa, consulte a documentação da Microsoft sobre a versão do tempo de execução que você está usando.
Linux (ARM64/aarch64 arquitetura)
Todas as distribuições Linux ARM64 suportadas pelo tempo de execução .NET 5+ são suportadas pelo agente .NET, com as seguintes exceções conhecidas:
Alpino Linux
Para obter instruções de instalação específicas do Azure, consulte:
O agente está disponível nas versões de 32 bits (x86) e 64 bits (x64) no Windows, bem como nas versões de 64 bits (x64) e ARM64 (aarch64) no Linux.
Importante
Na plataforma Linux ARM64, o agente .NET only suporta versões do .NET 5.0 ou superior.
Instalar e executar o agente .NET requer estas permissões:
Componente
Permissões necessárias
Instale o agente
O processo ou usuário que instala o agente deve ter permissões suficientes para configurar variáveis de ambiente e acesso de gravação ao diretório onde o agente está instalado.
Execute o agente
O processo monitor deve ter acesso de leitura/gravação ao diretório no qual você instalou o agente. O agente é executado como parte do processo de monitoramento e depende dessas permissões para funcionar.
Para aplicativos que usam IIS via proxy reverso, o grupo IIS_IUSRS é frequentemente usado.
O agente requer seu firewall para permitir conexões de saída para redes e portas específicas.
Instrumentação automática
Se sua aplicação estiver hospedada em ASP..NET Core, o agente cria automaticamente um instrumento de transação. 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 utiliza automaticamente esta estrutura de aplicativos:
ASP..NET Core MVC 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0 e 8.0 (inclui API Web)
ASP.NET Core Razor páginas 6.0, 7.0 e 8.0 (começando com o agente .NET versão 10.19.0)
O agente .NET instrumenta automaticamente o desempenho das chamadas do aplicativo .NET para estes datastores:
As versões 8.10.0 e superiores são suportadas a partir do agente .NET v10.20.1
As versões 8.12.1 e superiores são suportadas a partir do agente .NET v10.23.0
NEST
Versão mínima suportada: 7.0.0
Versão compatível verificada mais recente: 7.17.5
Elasticsearch.Net
Versão mínima suportada: 7.0.0
Versão compatível verificada mais recente: 7.17.5
O agente .NET não monitor diretamente os processos do armazenamento de dados. Além disso, 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 de detalhes da instância para datastores compatíveis está habilitada por padrão. Para solicitar informações em nível de instância de armazenamentos de dados não listados atualmente, obtenha suporte em support.newrelic.com.
O agente .NET utiliza automaticamente esta biblioteca de chamada externa:
Bibliotecas
Supported methods
HttpCliente
O agente utiliza estes métodos HttpClient:
SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync
O agente utiliza automaticamente estes sistemas de mensagens:
Bibliotecas
Supported methods
Confluent.Kafka
Produzir e consumir sobre temas.
Os seguintes métodos são instrumentados:
IProducer.Produce
IProducer.ProduceAsync
IConsumer.Consume
Versão mínima suportada: 1.4.0
Última versão compatível verificada: 2.2.0
NServiceBus
Coloca e recebe mensagens.
Versão mínima suportada: 5.0
RabbitMQ
Coloca e recebe mensagens e limpa filas.
Ao receber mensagens usando um IBasicConsumer, o EventingBasicConsumer é a única implementação instrumentada pelo agente .NET.
BasicGet é instrumentado, mas o agente não suporta distributed tracing para BasicGet.
Os seguintes métodos são instrumentados:
IModel.BasicGet
IModel.BasicPublish
IModel.BasicConsume
IModel.QueuePurge
EventingBasicConsumer.HandleBasicDeliver
Versão mínima suportada: 3.5.2
Última versão compatível verificada: 6.6.0
MassTransit (agente versões 10.19.0 e mais recentes)
Publicação/envio e consumo de mensagens
Versão mínima suportada: 7.1.0
Última versão compatível verificada: 8.1.1
Amazon Simple Queue Service (AWSSDK.SQS) (agente versões 10.27.0 e mais recentes)
Envio e recebimento de mensagens e eliminação de filas.
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:
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.
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.