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

Sintomas: os serviços ou recursos do Azure não aparecem na interface do usuário do Instana, mesmo após a criação bem-sucedida dos recursos, a implantação da aplicação e a instalação e configuração da extensão Instana Tracing App Service.

Etapas de resolução de problemas:

1. Verifique a configuração da entidade de serviço: certifique-se de que a entidade de serviço foi criada e configurada com o acesso de leitura necessário.

   Para obter informações detalhadas sobre a criação de entidades de serviço e outras opções de configuração e filtragem, consulte a documentação de monitoramento do Azure.

2. Verifique se há pelo menos um agente do Instana monitorando os recursos do Azure na sua assinatura.

3. Certifique-se de que o sensor de Azure está ativado no arquivo do agente configuration.yaml (*instanaAgentDir*/etc/instana/configuration.yaml):

   com.instana.plugin.azure:
     enabled: true
     subscription: "Your-Subscription-Id"
     tenant: "Your-Tenant-Id"
     principals:
       - id: "Your-Service-Principal-Account-Id"
         secret: "Your-Service-Principal-Secret"

4. Reinicie o agente do host para aplicar a nova configuração.

Sintomas: A interface do usuário do Instana não exibe nenhum registro dos recursos ou serviços do Azure após a instalação e configuração.

Etapas de resolução de problemas:

1. Verifique as seguintes configurações na extensão de rastreamento App Service do Instana :

   • O rastreio está ativado.
   • Verifique a arquitetura da sua aplicação (32 bits ou 64 bits).
   • A chave do agente está correta.
   • O end URL está correto.

2. Verifique o endpoint do servidor sem servidor URL :

   • Instana SaaS: Use o endpoint sem servidor correto do seu locatário do Instana :

     • Formato : https://serverless-<region>.instana.io
     • Exemplo:https://serverless-blue-saas.instana.io

   • Instana auto-hospedado:

     • Formato : https://<instana-backend-ip>/serverless
     • Defina a variável INSTANA_DISABLE_CA_CHECK de ambiente como true ou 1

3. Windows App Service verificações:

   1. Verifique se o Profiler está vinculado ao processo:

      • No portal Azure, acesse App Service > Ferramentas avançadas > Go.
      • Abra o Kudu e acesse o Process Explorer.
      • Localize w3wp.exe o processo e clique em Propriedades.
      • Verifique se há módulos carregados para Instana.Profiler_x64.dll ou Instana.Profiler_x86.dll.

   2. Verifique os registros do Visualizador de Eventos :

      • Verifique se há erros nos registros de eventos do aplicativo nas Ferramentas de Diagnóstico, na seção “Diagnosticar e resolver problemas” do recurso.

4. Linux App Service verificações:

   1. Verifique se as variáveis de ambiente necessárias existem e se os caminhos são válidos, acessíveis pelo processo ou aplicativo e corretos:

      CORECLR_ENABLE_PROFILING=1
      CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
      CORECLR_PROFILER_PATH=/home/site/wwwroot/instana_tracing/CoreProfiler.so
      DOTNET_STARTUP_HOOKS=/home/site/wwwroot/Instana.Tracing.Core.dll
      INSTANA_AGENT_KEY=<your-agent-key>
      INSTANA_ENDPOINT_URL=<your-endpoint-url>

   2. Verifique se o pacote Instana NuGet foi implantado e se a instana_tracing pasta e os arquivos, como [nome do arquivo], CoreProfiler.so existem:

      ls -la /home/site/wwwroot/instana_tracing/
      ls -la /home/site/wwwroot/Instana.Tracing.Core.dll

5. Verifique se as versões de tempo de execução dos aplicativos .NET e .NET Framework são compatíveis:

   • .NET Framework Versões do.NET Framework 4.5.2 ou posterior
   • .NET Versões do.NET Framework 5.0 ou posterior

Sintomas: Você instalou e configurou a extensão de rastreamento App Service do Instana, e seu aplicativo funciona normalmente. No entanto, os registros do Visualizador de Eventos mostram falhas na conexão do profiler, e os rastreamentos não aparecem no Instana.

Causa: Esse problema geralmente é causado por uma incompatibilidade de arquitetura entre a configuração da plataforma do App Service (32 bits ou 64 bits) e a arquitetura configurada na extensão de rastreamento App Service do Instana.

O profiler do ` Instana ` só consegue ser acoplado com sucesso quando ambas as configurações utilizam o mesmo número de bits.

Etapas de resolução de problemas:

1. Verifique a configuração de bits: compare o número de bits da configuração da plataforma App Service com o número de bits ativado na extensão.

   • Verifique as configurações da plataforma App Service :

     1. No portal Azure, acesse App Service > Configuração > Configurações gerais.
     2. Verifique a configuração da plataforma (32 bits ou 64 bits).

   • Verifique a configuração da extensão Instana :

     1. No portal Azure, acesse App Service > Extensões > Rastreamento de Instana App Service.
     2. Marque a caixa de seleção “Ativar 64 bits ”.

2. Analise os cenários de número de bits:

   App Service configuração	Configuração de extensão	Resultado
   32 bits	Ativar 64 bits: DESATIVADO	funciona
   64 bits	Ativar 64 bits: ATIVADO	funciona
   32 bits	Ativar 64 bits: ATIVADO	Falha
   64 bits	Ativar 64 bits: DESATIVADO	Falha

   Observação: Se você implantou seu aplicativo pelo Visual Studio, por padrão, a versão de 32 bits é definida para o aplicativo.
3. Se alguma das configurações estiver diferente, corrija o número de bits de acordo com os cenários. Certifique-se de que ambos estejam configurados para usar o mesmo número de bits.
4. Reinicie o serviço.

5. Verifique se o profiler correto está conectado por meio da ferramenta Kudu:

   1. No portal Azure, acesse App Service > Ferramentas avançadas > Go.
   2. Abra o Kudu e acesse o Process Explorer.
   3. Localize w3wp.exe e clique em Propriedades.

   4. Verifique se o profiler correto está carregado:

      • 32 bits: Instana.Profiler_x86.dll
      • 64 bits: Instana.Profiler_x64.dll

Sintomas: Sua aplicação está em execução em Azure App Service com a extensão de rastreamento Instana ativada, mas você observa um ou mais dos seguintes problemas:

• Conflitos de instrumentação
• O aplicativo trava ou ocorrem reinicializações inesperadas
• Degradação de desempenho

Motivo: O Instana não oferece suporte a cenários em que o Application Insights do Instana e o do Azure sejam usados em conjunto.

Etapas de resolução de problemas:

1. Desativar o Application Insights no App Service :

   1. No portal Azure, acesse App Service Visão geral > Propriedades.
   2. Clique em Application Insights.
   3. Selecione "Desativar".
   4. Confirme clicando em Sim.

2. Remover extensões do Application Insights:

   1. No portal Azure, acesse App Service > Extensões.
   2. Procure por extensões, como ApplicationInsightsAgent ou qualquer outra extensão relacionada ao Application Insights.
   3. Desativar, se existir.

3. Remover as variáveis de ambiente do Application Insights:

   1. Go em App Service > Configuração.
   2. Verifique as configurações.

   3. Verifique se há alguma variável do App Insights presente no arquivo ` App Service `, como:

      • APPINSIGHTS_INSTRUMENTATIONKEY
      • APPLICATIONINSIGHTS_CONNECTION_STRING
      • ApplicationInsightsAgent_EXTENSION_VERSION
   4. Limpe todas elas, exceto as variáveis de ambiente relacionadas ao ` Instana `. Certifique-se de que apenas as variáveis de ambiente relacionadas ao ` Instana ` permaneçam configuradas.
4. Reinicie o servidor de aplicativos ( App Service ) e verifique se o seu aplicativo está funcionando corretamente.

Conclua as etapas a seguir:

1. Ativar registros de depuração: Adicione as seguintes variáveis de ambiente para ativar o registro. Certifique-se de que os caminhos sejam válidos, acessíveis pelo processo ou aplicativo e estejam corretos:

   INSTANA_LOG_SPANS=1
   INSTANA_DEBUG_TRACER=1
   INSTANA_CLRLOG_PATH=C:\home\site\wwwroot\clr_

2. Reinicie o aplicativo e execute chamadas para gerar rastreamentos.

3. Recolha e analise os seguintes registros:

   • Registros de depuração do CLR
   • Instana registros de rastreamento e de intervalo
   • Registros do Visualizador de Eventos (apenas Windows )

4. Para o Windows App Service : Colete os registros do Visualizador de Eventos no portal Azure :

   1. No portal Azure, acesse App Service.
   2. Selecione “Diagnosticar e resolver problemas ”.
   3. Abrir Ferramentas de Diagnóstico.
   4. Analise os registros de eventos do aplicativo.