Solução de problemas do rastreamento do `.NET Framework ` no ` Windows `

Sintomas: O aplicativo exibe métricas, mas não apresenta rastreamentos; alguns serviços geram relatórios, mas outros não; ou o rastreamento é interrompido após uma implantação ou atualização.

Etapas de resolução de problemas:

1. Verifique se a versão do aplicativo para o sistema operacional Windows (.NET ) é compatível:

   • .NET Framework 4.5.2 ou posterior
2. Verifique se o rastreamento está ativado no arquivo do agente configuration.yaml .
3. Recolha os registros de rastreamento utilizando o Log Collector ou por meio da coleta manual de registros.

4. Verifique os logs de rastreamento do Instana e interprete os resultados:

   • Se os registros estiverem vazios ou não houver rastros visíveis, a aplicação não está gerando spans.
   • Se houver registros nos logs, mas faltarem informações (por exemplo, o host), o problema está na camada de rastreamento do .NET.
   • Se houver registros nos logs contendo informações que não constam na interface do usuário, o problema ocorreu no backend do Instana ou no agente.

Sintoma: O aplicativo trava ao iniciar quando o agente do Instana está em execução.

Etapas de resolução de problemas:

1. Verifique se a versão do aplicativo para o sistema operacional Windows (.NET ) é compatível:

   • .NET Framework 4.5.2 ou posterior
2. Recolha os registros do Visualizador de Eventos utilizando o Log Collector ou por meio da coleta manual de registros.

3. Verifique os registros do Visualizador de Eventos do Instana :

   • Verifique se há algum erro ou aviso nos registros. Um evento contém informações detalhadas, incluindo registros de data e hora e códigos de erro, que podem ajudar no diagnóstico de problemas.
   • Se aparecer uma mensagem de erro indicando InstanaPCP.exeque o ` InstanaPCP ` travou, isso significa que o `` travou. Verifique os eventos anteriores e investigue melhor a questão.
4. Recolha um relatório de falha do aplicativo em questão.

Sintoma: O aplicativo .NET não está sendo monitorado pelo agente Instana e não aparece na interface do usuário.

Etapas de resolução de problemas:

1. Verifique se o agente do Instana está sendo executado como administrador.
2. Verifique se o agente do Instana possui permissões para acessar o aplicativo.

3. Verifique se o PCP do Instana está em execução:

   • Abra o Gerenciador de Tarefas em Windows e procure por InstanaPCP.

4. Recolha os registros do agente d Instana e utilizando o Log Collector ou por meio da coleta manual de registros.

   • Nos registros do agente do Instana, deve constar a seguinte linha:

     com.instana.agent-process-handling - <version> |  | InstanaPCP.exe passed early window; marked RUNNING

5. Verifique se os sensores foram ativados corretamente nos registros do agente:

   com.instana.sensor-clr - <version> |  | Activated Sensor

6. Certifique-se de que o processo .NET seja iniciado após o agente Instana.

Sintoma: O aplicativo “ InstanaPCP ” ou “.NET ” apresenta um uso de CPU anormalmente alto após a ativação do rastreamento.

Etapas de resolução de problemas:

1. Verifique o Gerenciador de Tarefas para determinar se o problema está relacionado ao aplicativo ou a um InstanaPCP.

2. Se o problema for com InstanaPCP:

   • Ativar registros de depuração para o ` InstanaPCP `. Consulte “Recolha de registros ”.
   • Verifique os registros em busca de mensagens recorrentes sobre contadores de desempenho ausentes ou exceções.

3. Se o problema for um pico de uso de memória da aplicação:

   • Recolha os registros de eventos e os registros do `.NET ` usando o Log Collector ou recolhendo os registros manualmente.
   • Verifique os registros de eventos e os registros do `.NET ` em busca de exceções relacionadas à memória.
   • Verifique se o problema é causado por uma instrumentação d Instana.
   • Recolha um arquivo de despejo do `.NET ` para análise posterior.

O Log Collector é um aplicativo independente para coletar registros do servidor de log Instana Você pode acionar o Log Collector a partir dos seguintes locais:

• Instana Interface do usuário
• Console

O Log Collector coleta os seguintes registros:

• Logs de rastreamento de aplicativos
• Instana Registros do PCP
• Registros de depuração do CLR
• Registros do Visualizador de Eventos
• Instana registros de depuração do agente
• Instana O agente registra os logs

Como alternativa, você pode coletar os registros manualmente. Conclua as etapas a seguir:

1. Ative logs de depuração:

   1. Adicione variáveis de ambiente usando uma das seguintes opções:

      Observação: certifique-se de que os caminhos sejam válidos, acessíveis pelo processo ou aplicativo e estejam corretos.

      • Defina manualmente as seguintes variáveis de ambiente no nível do sistema:

        INSTANA_NET_LOG_PATH: "C:\dc_net_log"
        INSTANA_NET_LOG_LEVEL: DEBUG
        INSTANA_NET_FF_LOG_LEVEL: DEBUG
        INSTANA_NET_PCP_LOG_LEVEL: DEBUG
        INSTANA_TRACER_ENTEREXIT_LOGGING: 1
        INSTANA_EXTENDED_DEBUG: 1

      • Abra o prompt de comando como administrador e execute o seguinte comando para adicionar as variáveis de ambiente:

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_FF_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_PCP_LOG_LEVEL "DEBUG" /M
        setx INSTANA_TRACER_ENTEREXIT_LOGGING "1" /M
        setx INSTANA_EXTENDED_DEBUG "1" /M

   2. Configure a seguinte chave do Registro Windows :

      CLRDebugLog: "C:\dc_clr_debug_log\clr_"

   3. Reinicie o aplicativo.

2. Recolher os registros do agente d Instana :

   1. Interrompa o agente <instana_install_dir>/bin/stop.sh ou, se o agente tiver sido iniciado como um serviço, interrompa o serviço.

   2. Remova os logs: Apague todos os arquivos no diretório de logs para reiniciar do zero, executando o seguinte comando:

      rm -rf <instana_install_dir>/data/log/*

   3. Defina o nível de registro como "Debug": altere o nível de gravidade do registro no arquivo do agente configuration.yaml . Para obter mais informações, consulte a seção “Configurando o arquivo de configuração do agente”.
   4. Inicie o agente <instana_install_dir>/bin/start.sh ou inicie o serviço.
   5. Reproduza o problema: deixe que o problema ocorra e deixe o agente em execução por aproximadamente 15 minutos.

   6. Recolha os logs: Compacte o diretório de logs para envio executando o seguinte comando:

      cd <instana_install_dir>/data/logs
      zip -r instana_agent_debug_logs.zip *

      Para PowerShell:

      Compress-Archive * instana_agent_debug_logs.zip

3. Recolher os registros de rastreamento d Instana :

   1. com.instana.agent.main.sender.File.cfgGo para [agent-dir]\etc\instana e abrir o arquivo.

   2. Adicione as seguintes linhas ao arquivo:

      prefix=instanaTraces
      type=traces

      Essa configuração gera um arquivo de log contendo todos os rastreamentos com [agent-dir]/data/log o prefixo "instanaTraces".

   3. Reinicie o agente do Instana.
   4. Reinicie o aplicativo e deixe-o em execução por aproximadamente 15 minutos.

   5. Recolha os arquivos de log dos seguintes caminhos:

      • Caminho especificado pela variável INSTANA_NET_LOG_PATH
      • instana-agent-installation-folder/data/log

4. Recolher registros de depuração do CLR:

   1. Abra o Editor do Registro.
   2. Acesse Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Instana\
   3. Adicione a chave CLRDebugLog do Registro como uma string com valor, por exemplo, C:\temp\clr_.

   4. Como alternativa, abra o prompt de comando como administrador e execute o seguinte comando:

      reg add "HKLM\SOFTWARE\Instana" /v CLRDebugLog /t REG_SZ /d "C:\temp\clr_" /f

5. Recolher os registros do Visualizador de Eventos d Windows :

   1. Abrir o Visualizador de Eventos:

      1. Pressione Win + R.
      2. Insira eventvwr.msc.
      3. Pressione Enter.

   2. Go no log que você deseja exportar:

      • Windows Registros: Windows Registros > Aplicativo
      • Registros de aplicativos e serviços
   3. No painel Ações, selecione “Salvar todos os eventos como ”.
   4. Escolha um local e salve como .evtx.