Solução de problemas do rastreamento do `.NET ` 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 Core 5.0 ou versão posterior
2. Verifique se o rastreamento está ativado no arquivo do agente configuration.yaml .
3. Recolha os registros de rastreamento usando o Log Collector ou coletando-os manualmente.

4. Verifique os logs de rastreamento do Instana :

   • 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 falha 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 Core 5.0 ou versão posterior
2. Recolha os registros do Visualizador de Eventos usando o Log Collector ou coletando-os manualmente.

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.exe que InstanaPCP falhou. Verifique os eventos que antecederam a situação e investigue o problema mais a fundo.
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 usando o Log Collector ou recolhendo os registros manualmente.

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

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

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

   com.instana.sensor-clr - 1.1.141 |  | Activated Sensor

6. Verifique se o processo `.NET ` é 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 ` utilizando 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. Go No Gerenciador de Tarefas, clique com o botão direito do mouse no processo e crie um arquivo de despejo.

O Log Collector é um aplicativo independente para coletar logs do 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_CORE_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_CORE_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 arquivos de log: Apague todos os arquivos no diretório de log 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 a gravidade do nível de 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 execute o agente 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 *

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 que contém todos os rastreamentos com [agent-dir]/data/log o instanaTraces prefixo.

   3. Reinicie o agente do Instana.
   4. Deixe o produto agir por cerca de 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. Navegue para 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