Monitoramento de aplicativos baseados em .NET e .NET Core

Você pode configurar o rastreamento para suas aplicações do .NET de forma automática ou manual, dependendo do seu ambiente.

Se o seu ambiente for compatível com o AutoTrace,, o Instana instrumenta automaticamente sua aplicação .NET. No entanto, se o recurso " AutoTrace " não for compatível, você deverá usar o rastreamento manual.

Selecione o guia adequado ao seu ambiente de implantação:

Depois de configurar o monitoramento básico, você pode definir os seguintes recursos opcionais adicionais para aprimorar as capacidades de monitoramento do .NET :

• Kafka Cabeçalhos de correlação de rastreamento : Configure os formatos dos cabeçalhos para o rastreamento d Kafka.
• Ignorar processos : controle quais processos são monitorados usando uma lista de permissões ou uma lista de restrições.
• Lista de processos permitidos : monitorar apenas processos específicos.
• Filtragem de intervalos : Reduza o volume de dados filtrando intervalos específicos.
• AutoProfile : Ativar a análise contínua de desempenho para otimização do desempenho.
• Rastreamento personalizado : adicione intervalos personalizados usando o SDK do .NET.
• Instrumentação orientada a eventos : Capture dados de telemetria por meio de eventos d ActivitySource.
• HTTP 4xx Relatórios de erros por código de status : Oferecer suporte à classificação opcional de respostas do tipo “ HTTP ” 4xx como erros em intervalos de saída.

Para obter instruções detalhadas sobre a configuração, consulte “Configurando recursos adicionais ”.

No Linux, implante seu aplicativo com o pacote Instana.Tracing.CoreNuGet 1.1.34 ou uma versão posterior. Defina a seguinte variável de ambiente:

DOTNET_STARTUP_HOOKS=[path-to-your-app]/Instana.Tracing.Core.dll
 

Para confirmar se o pacote foi carregado com sucesso, procure a seguinte linha na saída do seu aplicativo:

INSTANA Agent for .NET Core applications installed. Running on 
 

É possível usar o mesmo pacote para o rastreio

Instana avalia continuamente os indicadores de integridade em relação às métricas recebidas e notifica problemas ou incidentes com base no impacto sobre os usuários.

Os eventos integrados acionam problemas ou incidentes com base em assinaturas de integridade com falha nas entidades, enquanto os eventos personalizados acionam problemas ou incidentes com base nos limites de uma métrica específica de qualquer entidade.

Para obter informações sobre eventos integrados do .NET, consulte a Referência de eventos integrados.

Devido a algumas limitações do Application Insights para o ASP.NET Core, é possível que você observe dados incompletos ou ausentes no Application Insights quando o monitoramento do Instana .NET Core for executado em paralelo.

Se você deseja usar o Application Insights e o Instana simultaneamente, é necessário desativar a propagação do contexto de rastreamento do W3C, desativando a injeção do cabeçalho W3C pelo Instana.

Para impedir que o ` Instana ` insira cabeçalhos ` W3C `, defina a seguinte variável de ambiente:

INSTANA_W3C_DISABLE_INJECT_HEADERS=1
 

Instana com o sensor .NET Core, 1.0.90 e .NET; a versão do Tracer 1.315.1 (13 de março de 2026) restringe a instrumentação às versões de bibliotecas explicitamente listadas na seção “Bibliotecas e frameworks compatíveis para rastreamento ”. As versões não compatíveis não são monitoradas.

Para garantir suporte contínuo, atualize para as versões compatíveis. Para obter mais detalhes e opções de solução alternativa, consulte a nota técnica.

Ao hospedar aplicativos d.NET e 5 ou versões posteriores (incluindo o.NET e 6, 7, 8 e versões posteriores) no IIS, o pool de aplicativos deve ser configurado para ser executado com No Managed Code. Neste modo, o Instana não consegue coletar métricas no nível do IIS.

Quando um pool de aplicativos do IIS está definido como No Managed Code, o Instana não consegue coletar as seguintes métricas no nível do IIS:

• Nomes dos pools de aplicativos
• w3wp.exe métricas de processo
• Dados de monitoramento no nível do processo de trabalho

Essa limitação é inerente à forma como o IIS hospeda aplicativos do..NET. 5 e versões posteriores. A instrumentação e o rastreamento no nível da aplicação continuam funcionando conforme o esperado, mas as métricas no nível do IIS não estão disponíveis.

Se você precisar de métricas no nível do IIS, considere usar aplicativos do..NET Framework e 4 ou versões anteriores, que oferecem suporte a pools de aplicativos de código gerenciado.

Se você não encontrar rastreamentos ou métricas na interface do usuário do Instana, siga estas etapas gerais de solução de problemas:

1. Verifique os pré-requisitos:

   • Verifique se a versão do seu runtime do .NET é compatível (.NET5.0 ou posterior)
   • Verifique se o agente do Instana está em execução e acessível
   • Verifique a conectividade de rede entre seu aplicativo e o agente

2. Verifique as variáveis de ambiente:

   • Verifique se todas as variáveis de ambiente necessárias estão definidas corretamente
   • Certifique-se de que os caminhos sejam válidos e acessíveis
   • Verifique se os nomes das variáveis estão escritos corretamente

3. Verifique a inicialização do IL-Rewriter:

   • Verifique os logs do aplicativo em busca de mensagens de inicialização do IL-Rewriter
   • Certifique-se de que CORECLR_ENABLE_PROFILING, CORECLR_PROFILER_PATH, e CORECLR_PROFILER estejam configurados corretamente

4. Ativar diagnósticos:

   • Se você usar o rastreamento que depende do reescritor de IL do Instana, defina COMPlus_EnableDiagnostics e DOTNET_EnableDiagnostics como 1
   • Sem o diagnóstico ativado, o IL-Rewriter não consegue se conectar ao processo

5. Verifique a configuração de rastreamento:

   • Verifique se o rastreamento está ativado no arquivo do agente configuration.yaml
   • Reinicie o agente e o aplicativo após as alterações na configuração

Para obter informações detalhadas sobre cenários de solução de problemas específicos para cada plataforma e procedimentos de coleta de logs, consulte o guia de solução de problemas correspondente na seção a seguir.