Compatibilidade .NET do agente e requisitos para .NET framework

Nosso agente .NET oferece suporte ao .NET framework e ao .NET Core. Aqui descrevemos a compatibilidade e o suporte para o aplicativo .NET framework . Para .NET Core, consulte Compatibilidade e requisitos para .NET Core.

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 o agente .NET da New Relic? Crie uma conta New Relic gratuitamente! Não é necessário cartão de crédito.

Requisitos

Antes de instalar o agente .NET da New Relic, certifique-se de que seu sistema atenda a estes requisitos:

AVISO DE EOL

A Microsoft anunciou oficialmente o fim da vida útil das versões 4.5.1, 4.5.2 e 4.6.1 do .NET framework em 26 de abril de 2022.

Você pode encontrar o blog informativo no blog da Microsoft. Você pode encontrar as datas oficiais de início e término do ciclo de vida do produto na documentação da Microsoft.

Nosso suporte ao agente .NET para essas versões framework termina com o agente .NET 9.x New Relic mais recente. A partir do agente New Relic .NET versão 10.0, iremos destino o .NET framework 4.6.2 em diante. Para obter mais detalhes, incluindo como você pode se preparar facilmente para essa transição, consulte nossa postagem no Fórum de suporte.

.NET Framework 4.6.2 or higher

O .NET framework 4.6.2 ou superior requer o agente New Relic .NET versão 7.0 ou superior.

.NET Framework 4.5.1, 4.5.2, and 4.6.1

Para o aplicativo do instrumento em execução no .NET framework 4.5.1, 4.5.2 ou 4.6.1, você deve executar uma versão do agente New Relic .NET inferior a 10.0, mas não inferior a 7.0.

.NET Framework 4.0 or lower

Para que o aplicativo do instrumento seja executado no .NET framework versão 4.0 ou inferior, você deve executar uma versão do agente .NET New Relic inferior a 7.0. Para obter mais informações e procedimentos de download, consulte Suporte técnico para .NET framework 4.0 ou inferior.

Aqui estão detalhes adicionais sobre as versões 4.0 ou inferiores do .NET framework :

Versão framework .NET	Notas
Framework .NET 2.0	A menos que você tenha instalado o only .NET framework 4.0 ou superior, você must terá o .NET framework versão 3.5 instalado no host de destino, além de quaisquer outras versões do .NET framework instaladas.
Framework .NET 3.0	A menos que você tenha instalado o only .NET framework 4.0 ou superior, você must terá o .NET framework versão 3.5 instalado no host de destino, além de quaisquer outras versões do .NET framework instaladas.
Framework .NET 3.5	Totalmente compatível com versões do agente .NET inferiores a 7.0.
Framework .NET 4.0	Totalmente compatível com versões do agente .NET inferiores a 7.0.

Você deve usar um destes servidores de aplicativo/web:

IIS
OWIN auto-hospedado
WCF auto-hospedado
Francelho
Kestrel com proxy reverso do IIS via AspNetCoreModule
Kestrel com proxy reverso do IIS via AspNetCoreModuleV2
O agente cria automaticamente transações para aplicativos hospedados no IIS. Se você se auto-hospedar com WCF e OWIN versão 3 ou superior, o agente também cria transação automaticamente. Para outros serviços auto-hospedados, será necessário criar transações via instrumentação customizada.

A instalação requer privilégios elevados (administrador). Por exemplo, você pode:

Faça login como usuário administrador.
Seja membro do grupo administrador.
No sistema operacional mais recente, forneça credenciais de elevação quando solicitado.
O processo monitor deve ter acesso de leitura/gravação ao diretório no qual o agente está instalado. O agente é executado como parte do processo de monitoramento e depende dessas permissões para funcionar.
Recommendation:
Restrinja as permissões para o arquivo newrelic.config e conceda acesso de leitura/gravação somente ao proprietário do processo monitor.
Revise as permissões do log criado pelo agente para minimizar o número de usuários com acesso e seus privilégios.

Instrumentação automática

Se sua aplicação estiver hospedada em ASP.NET ou outro framework totalmente suportado, o agente .NET instrumentará automaticamente sua aplicação 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.

O agente automaticamente instrumenta alguma estrutura de aplicativo; nos referimos a essa estrutura como fully supported.

Compatibility status

.NET app frameworks

Totalmente suportado

Essa estrutura are fully supported:

ASP.NET MVC 2
ASP.NET MVC 3
ASP.NET MVC 4
ASP.NET MVC 5
API Web ASP.NET v2
ASP.NET Core MVC 2.0
ASP.NET Core 2.1
ASP.NET Core 2.2
Formulários Web ASP.NET
Castle MonoRail v2 (não é mais compatível com o agente .NET versão 10.0 ou superior)
Aplicativo de API da web hospedado por OWIN no .NET framework usando:
- Microsoft.Owin.Host.HttpListener v2.x
- Microsoft.Owin.Host.HttpListener v3.x
- Microsoft.Owin.Host.HttpListener v4.x
Serviços da web baseados em SOAP

WCF

Hosting Models
- IIS hospedado (com e sem compatibilidade ASP)
- Auto-hospedado

Binding Types (cliente e serviço)
A instrumentação do WCF foi testada para os seguintes tipos de associação comuns. Vários níveis de suporte estão disponíveis para distributed tracing (DT) e rastreamento multiaplicativo (CAT):

Vinculativo	Suporte para distributed tracing (DT)	Suporte ao rastreamento multiaplicativo (CAT) (obsoleto)
HTTP básico	suportado	suportado
WebHTTP	suportado	suportado
WSHTTP	suportado	suportado
NetTCP	suportado	suportado
NetNamedPipe	não suportado*	não suportado*
NetMSMQ	não suportado*	não suportado*

* distributed tracing pode ser implementado manualmente usando esses métodos de API distributed tracing .

Invocation Methods (cliente e serviço)
- Síncrono
- Modelo de Processamento assíncrono (APM) Início/Fim
- Processamento assíncrono de tarefas (TAP)
- Processamento assíncrono baseado em eventos (EAP)
  - Somente suporte ao cliente.

Não totalmente compatível

Esses quadros são not fully supported:

ASP.NET Web API v1:
Consulte as informações de resolução de problemas sobre o uso da API Web ASP.NET v1 com o agente .NET 5.0 ou superior da New Relic para aplicativos direcionados ao .NET framework 4.0. (Isso não afeta o .NET framework 4.5 ou superior.)
Mono:
New Relic não oferece suporte a Mono, uma framework .NET de código aberto que roda em Linux. Isso ocorre porque não há API profiler para injetar no agente .NET como um profiler no aplicativo .NET baseado em Mono. A API profiler é uma interface baseada em Component Object Model (COM) e não é suportada no Linux.

Não suportado

O ASP clássico é not supported, porque o agente só pode usar aplicativos baseados no instrumento .NET framework .

O Sharepoint é not supported.

A coleta de detalhes da instância para armazenamentos de dados compatíveis requer o agente .NET versão 6.5.29.0 ou superior e está habilitada por padrão. Para solicitar informações em nível de instância de datastores não listados atualmente, obtenha suporte no centro de suporte da New Relic.

Para instrumentar automaticamente o desempenho das chamadas do aplicativo .NET framework para esses datastores, certifique-se de ter o agente .NET versão 8.14 ou superior:

Versões compatíveis verificadas: 4.0.40

Versões incompatíveis conhecidas: 4.0.44 ou superior

Armazenamento de dados	Detalhes da instância	Outras notas
Cosmos DB		O agente .NET `v9.2.0` ou superior utiliza automaticamente a biblioteca Microsoft.Azure.Cosmos . Versão mínima suportada: 3.17.0 Versões compatíveis verificadas: 3.17.0, 3.23.0
Sofá		Usar CouchbaseNetClient. Versão mínima suportada: 2.0.0 Versões compatíveis verificadas: 2.3.8 Versões incompatíveis conhecidas: 2.4.0+ Com o Couchbase, os itens a seguir não são instrumentados por padrão em favor de suas contrapartes com vários documentos: `Get(string key)` `GetDocument(string key)` `Remove(string key)` `Remove(string key, ulong cas)` `Upsert<T>(string key, T value)`
IBM DB2
Servidor SQL da Microsoft		Use SqlClient do pacote System.Data.SqlClient NuGet ou do pacote Microsoft.Data.SqlClient NuGet ou do assembly System.Data integrado framework . System.Data.SqlClient Versão mínima suportada: 4.4.0 Versões compatíveis verificadas: 4.4.0, 4.6.1, 4.7.0, 4.8.4, 4.8.5, 4.8.6 Microsoft.Data.SqlClient Versão mínima suportada: 1.0.19239.1 Versões compatíveis verificadas: 1.0.19239.1, 2.1.5, 3.1.1, 4.1.1, 5.0.1, 5.1.1, 5.2.0 System.Data Versão mínima suportada: .NET framework 4.6.2 Versões compatíveis verificadas: .NET framework 4.6.2, 4.7.1, 4.8
MongoDB (driver legado)		Versão mínima suportada: 1.10.0 Versões compatíveis verificadas: 1.10.0 Versões incompatíveis conhecidas: os detalhes da instância não estão disponíveis na versão inferior 2.
MongoDB (driver moderno)		Versão mínima suportada: 2.3.0 Versões compatíveis verificadas: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.20.0, 2.21.0, 2.22.0, 2.23.0, 2.23.1. 2.24.0 A partir da versão 10.12.0 do agente, os seguintes métodos adicionados ou após a versão 2.7 do driver são instrumentados: `IMongoCollection.CountDocuments[Async]` `IMongoCollection.EstimatedDocumentCount[Async]` `IMongoCollection.AggregateToCollection[Async]` `IMongoDatabase.ListCollectionNames[Async]` `IMongoDatabase.Aggregate[Async]` `IMongoDatabase.AggregateToCollection[Async]` `IMongoDatabase.Watch[Async]`
MySQL		Use MySQL.Data ou MySQL Connector MySql.Data Versão mínima suportada: 6.10.7 Versões compatíveis verificadas: 6.10.7, 8.0.15, 8.0.30, 8.0.33, 8.1.0, 8.2.0, 8.3.0 MySqlConnector Versão mínima suportada: 1.0.1 Versões compatíveis verificadas: 1.0.1, 1.3.13, 2.1.2, 2.3.1, 2.3.3, 2.3.5
Oracle
PostgreSQL		Usar Npgsql Versão mínima suportada: 4.0.0 Versões compatíveis verificadas: 4.0.5 Versões anteriores do Npgsql também podem ser instrumentadas, mas métricas duplicadas e/ou ausentes são possíveis.
ServiceStack.Redis
StackExchange.Redis		Versão mínima suportada: 1.0.488 Versões compatíveis verificadas: 1.0.488, 1.1.608, 1.2.6, 2.0.601, 2.1.58, 2.2.88, 2.6.66, 2.6.116, 2.7.4, 2.7.10, 2.7.17, 2.7.33
Elasticsearch		Use Elastic.Clients.Elasticsearch, NEST ou Elasticsearch.Net. Elastic.Clients.Elasticsearch Versão mínima suportada: 8.0.0 Versões compatíveis verificadas: 8.0.0, 8.1.0, 8.1.1, 8.9.1, 8.9.2, 8.9.3, 8.10.0, 8.11.0, 8.12.0 As versões 8.10.0 e superiores são suportadas a partir do agente .NET v10.20.1 NEST Versão mínima suportada: 7.0.0 Versões compatíveis verificadas: 7.0.0, 7.17.5 Elasticsearch.Net Versão mínima suportada: 7.0.0 Versões compatíveis verificadas: 7.0.0, 7.17.5

O agente automaticamente utiliza esta biblioteca de chamada externa:

Bibliotecas	Supported methods
HttpCliente	O agente utiliza estes métodos HttpClient: `SendAsync` `GetAsync` `PostAsync` `PutAsync` `DeleteAsync` `GetStringAsync` `GetStreamAsync` `GetByteArrayAsync`
RestSharp	O agente utiliza estes métodos RestSharp: `ExecuteTaskAsync` `ExecuteGetTaskAsync` `ExecutePostTaskAsync` `Execute` `ExecuteAsGet` `ExecuteAsPost` `DownloadData` Versão mínima suportada: 105.2.3 Versões compatíveis verificadas: 105.2.3, 106.0.0, 106.6.10, 106.11.0, 106.12.0, 106.13.0, 106.15.0, 107.3.0, 108.0.3, 109.0.1 Versões incompatíveis conhecidas: 106.8.0, 106.9.0, 106.10.0, 106.10.1
HttpWebRequest	O agente utiliza estes métodos HttpWebRequest: `GetResponse`

Bibliotecas

Supported methods

HttpCliente

O agente utiliza estes métodos HttpClient:

SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync

RestSharp

O agente utiliza estes métodos RestSharp:

ExecuteTaskAsync
ExecuteGetTaskAsync
ExecutePostTaskAsync
Execute
ExecuteAsGet
ExecuteAsPost
DownloadData
Versão mínima suportada: 105.2.3
Versões compatíveis verificadas: 105.2.3, 106.0.0, 106.6.10, 106.11.0, 106.12.0, 106.13.0, 106.15.0, 107.3.0, 108.0.3, 109.0.1
Versões incompatíveis conhecidas: 106.8.0, 106.9.0, 106.10.0, 106.10.1

HttpWebRequest

O agente utiliza estes métodos HttpWebRequest:

GetResponse

O agente .NET pode ser configurado para instrumentar automaticamente essa estrutura de registro para logs automáticos no contexto com encaminhamento de agente e decoração log local:

Frameworks	Versão mínima framework	Versão mínima do agente	Versões compatíveis verificadas
Log4Net	1.2.10	9.7.0	1.2.10, 2.0.5, 2.0.14, 2.0.16
Serilog	2.0.0	9.7.0	1.5.14, 2.5.0, 2.10.0, 3.0.1, 3.1.1
NLog	4.1.0	9.7.0	4.1.2, 4.3.11, 4.5.11, 5.2.0, 5.2.2, 5.2.3, 5.2.4, 5.2.5, 5.2.6, 5.2.7, 5.2.8
Microsoft.Extensions.Logging	3.0.0	9.7.0

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 Versões compatíveis verificadas: 1.4.0, 2.2.0
MSMQ	Envio e recebimento de mensagens, visualização e eliminação de filas
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 Versões compatíveis verificadas: 3.5.2, 5.1.0, 6.2.1, 3.6.9, 4.1.3, 5.2.0, 6.0.0, 6.2.1, 6.4.0, 6.5.0, 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 Versões compatíveis verificadas: 7.1.0, 7.3.1, 8.1.1

As linguagens e tecnologias .NET listadas são compatíveis com nosso painel de observabilidade instantânea . Se você usar qualquer uma dessas linguagens ou tecnologias, poderá visualizar seus dados em um dashboard New Relic, pronto para uso:

Linguagem/tecnologia	Configuração adicional
Aplicativo C#	New Relic pode instrumentar automaticamente serviços escritos em C#. Acesse nossa página de início rápido do C# para instalar o painel do C#.
ADO.net	Se seu aplicativo usa ADO.net, você pode instalar uma combinação de agente New Relic que gera um dashboard ADO.net. Aqui está o que você precisa fazer: Instale o agente New Relic APM .NET e o agente de infraestrutura seguindo as etapas em nossa instalação guiada. Instale a integração no host do Microsoft Windows Perfmon/WMI para New Relic Infrastructure seguindo as instruções do nri-perfmon. Se você instalou o Perfmon manualmente, reinicie o agente de infraestrutura. Acesse nossa página de início rápido do ADO.NET para instalar o painel do ADO.NET.
Servidor Blazor	Rastreie seus dados mais importantes em nosso dashboard do Blazor Server instrumentando seu aplicativo com New Relic: Instale o agente New Relic APM .NET e o agente de infraestrutura seguindo as etapas em nossa instalação guiada. Se preferir, você pode instalar o agente de infraestrutura através da linha de comando. Obtenha o dashboard pré-construído instalando o início rápido do Blazor Em one.newrelic.com, vá para APM & services e selecione seu aplicativo. Para verificar se sua instalação foi bem-sucedida, consulte o seguinte: `FROM Transaction SELECT count(*) FACET request.uri` Se aparecerem dados, você instrumentou seu aplicativo corretamente.

Linguagem/tecnologia

Configuração adicional

Aplicativo C#

New Relic pode instrumentar automaticamente serviços escritos em C#. Acesse nossa página de início rápido do C# para instalar o painel do C#.

ADO.net

Se seu aplicativo usa ADO.net, você pode instalar uma combinação de agente New Relic que gera um dashboard ADO.net. Aqui está o que você precisa fazer:

Instale o agente New Relic APM .NET e o agente de infraestrutura seguindo as etapas em nossa instalação guiada.
Instale a integração no host do Microsoft Windows Perfmon/WMI para New Relic Infrastructure seguindo as instruções do nri-perfmon.
Se você instalou o Perfmon manualmente, reinicie o agente de infraestrutura.
Acesse nossa página de início rápido do ADO.NET para instalar o painel do ADO.NET.

Servidor Blazor

Rastreie seus dados mais importantes em nosso dashboard do Blazor Server instrumentando seu aplicativo com New Relic:

Instale o agente New Relic APM .NET e o agente de infraestrutura seguindo as etapas em nossa instalação guiada. Se preferir, você pode instalar o agente de infraestrutura através da linha de comando.
Obtenha o dashboard pré-construído instalando o início rápido do Blazor
Em one.newrelic.com, vá para APM & services e selecione seu aplicativo. Para verificar se sua instalação foi bem-sucedida, consulte o seguinte:
```
FROM Transaction SELECT count(*) FACET request.uri
```
Se aparecerem dados, você instrumentou seu aplicativo corretamente.

O agente .NET pode ser configurado para instrumentar automaticamente esta estrutura LLM:

Frameworks	Versão mínima framework	Versão mínima do agente	Versões compatíveis verificadas
AWS Bedrock	3.7.200.0	10.23.0	3.7.200.0, 3.7.301.45

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
Monitoramento de browser	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.
Monitoramento de infraestrutura	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.
Painel	O agente .NET envia evento e atributo padrão para consulta NRQL. Você também pode gravar eventos personalizados para análise avançada.
Monitoramento sintético	Sintético trace da transação conecta solicitações do monitor Sintético à transação APM subjacente.

Esta tradução de máquina é fornecida para sua comodidade.

Compatibilidade .NET do agente e requisitos para .NET framework

Requisitos

Versão framework .NET

AVISO DE EOL

Vida útil do aplicativo

Servidores de aplicativos/web

AWS Elastic Beanstalk

Importante

CLRs

Segurança de acesso ao código

Microsoft Azure

Requisitos de rede

Sistema operacional

Permissões

Processador arquitetura

Requisitos de segurança

Uso de outro software de monitoramento

Instrumentação automática

Estrutura do aplicativo

Armazenamentos de dados

CMS

Biblioteca de chamada externa

Estrutura de registro

Mensagens

Linguagens e tecnologias .NET suportadas para painel

Grande modelo de linguagem (LLM)

Conecte o agente a outros produtos New Relic

Esta tradução de máquina é fornecida para sua comodidade.

Compatibilidade .NET do agente e requisitos para .NET framework

Requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Vida útil do aplicativo

Servidores de aplicativos/web

AWS Elastic Beanstalk

CLRs

Segurança de acesso ao código

Microsoft Azure

Requisitos de rede

Sistema operacional

Permissões

Processador arquitetura

Requisitos de segurança

Uso de outro software de monitoramento

Instrumentação automática

Estrutura do aplicativo

Armazenamentos de dados

CMS

Biblioteca de chamada externa

Estrutura de registro

Mensagens

Linguagens e tecnologias .NET suportadas para painel

Grande modelo de linguagem (LLM)

Conecte o agente a outros produtos New Relic

Requisitos