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.
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
Para que o aplicativo do instrumento seja executado no .NET framework 4.6.2 ou superior, você deve executar o agente New Relic .NET 10.0 ou superior.
The .NET agent does not support .NET Framework versions 4.5.1, 4.5.2, and 4.6.1
.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.
O agente .NET carrega dados no final de cada ciclo de coleta (uma vez por minuto). Se seu aplicativo .NET não funcionar por tanto tempo, você poderá definir o atributo sendDataOnExit de service element como true no arquivo newrelic.config .
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.
O agente requer o CLR versão 4.0. O aplicativo legado rodando em CLR 2.0 pode ser instrumentado com versões de agente inferiores a 7.0.
O uso do Code Access Security é compatível com o agente .NET somente quando Full Trust é fornecido. O agente não é compatível com níveis de confiança mais restritivos.
Para obter instruções de instalação específicas do Azure, consulte:
O agente requer seu firewall para permitir conexões de saída para redes e portas específicas.
O agente requer um destes sistemas operacionais:
Servidor Windows 2008
Servidor Windows 2008 R2
Servidor Windows 2012
Servidor Windows 2012 R2
Servidor Windows 2016
Servidor Windows 2019
Servidor Windows 2022
Windows 10
Windows 11
Windows Azure (família de SO 1, 2 e 3)
Contêiner Windows rodando no Windows 2016 (imagens baseadas em NanoServer não são suportadas)
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.
O agente está disponível nas versões de 32 e 64 bits. Em sistemas de 64 bits, o agente de 64 bits pode utilizar aplicativos de 32 e 64 bits.
O .NET Common Language Runtime (CLR) permite apenas que um profiler acesse a API de criação de perfil de um processo a qualquer momento. Executar nosso agente .NET junto com outro software de monitoramento resultará em um conflito de perfil. Para obter mais informações, consulte Erros ao usar outro software APM.
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:
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)
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:
Última versão compatível verificada: 4.0.40
Versões incompatíveis conhecidas: 4.0.44 ou superior
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
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
Ú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.
Os seguintes métodos são instrumentados:
AmazonSQSClient.SendMessage
AmazonSQSClient.SendMessageAsync
AmazonSQSClient.SendMessageBatch
AmazonSQSClient.SendMessageBatchAsync
AmazonSQSClient.ReceiveMessage
AmazonSQSClient.ReceiveMessageAsync
AmazonSQSClient.PurgeQueue
AmazonSQSClient.PurgeQueueAsync
Versão mínima suportada: 3.3.0
Última versão compatível verificada: 3.7.301.32
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.
Em one.newrelic.com, vá para APM & services e selecione seu aplicativo. Para verificar se sua instalação foi bem-sucedida, consulte o seguinte:
FROMTransactionSELECTcount(*) 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ão compatível verificada mais recente
AWS Bedrock
3.7.200.0
10.23.0
3.7.301.45
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:
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.