Configurando o rastreamento d.NET Framework no Windows

Para configurar o rastreamento d.NET Framework no Windows, siga estas etapas:

• Certifique-se de que o agente do Instana esteja em execução na máquina host. Consulte a seção “Instalando o agente” em Windows.
• Verifique se o serviço “ InstanaPCP ” está em execução na máquina host. InstanaPCP permite que o agente do Instana se comunique com o seu aplicativo .NET Framework. Para verificar se o serviço “ InstanaPCP ” está em execução, abra o Gerenciador de Tarefas em Windows e procure por InstanaPCP.exe.
• Verifique se o seu aplicativo funciona no .NET Framework 4.5.2 ou em uma versão posterior.
• Consulte as informações de suporte.

O agente do Instana não habilita o rastreamento automaticamente para todas as aplicações baseadas no .NET. Por exemplo, aplicativos do sistem Windows ou processos independentes são excluídos, a menos que sejam explicitamente configurados.

O IIS e o WebSphere Application Server estão configurados para conectar o profiler automaticamente por meio da definição das variáveis de ambiente apropriadas. No entanto, os processos independentes devem ser configurados manualmente.

Para ativar o rastreamento de um processo, defina as seguintes variáveis de ambiente:

SET COR_ENABLE_PROFILING=1
SET COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}

Você pode incluir essas configurações em um script em lote ou de shell que defina as variáveis de ambiente e, em seguida, inicie o seu processo.

Se você estiver executando os Serviços d Windows, poderá adicionar configurações de variáveis de ambiente no Registro para cada serviço individualmente. Ao adicionar essas configurações, você terá mais controle na escolha dos serviços a serem rastreados.

Para configurar a variável de ambiente para os Serviços d Windows, siga estas etapas:

1. Go no Editor do Registro, no HKLM\System\CurrentControlSet\Services\serviceName diretório.
2. EnvironmentAdicione o MULTI_SZ valor com o nome.
3. Se MULTI_SZ não existir, copie as variáveis COR_ENABLE_PROFILING, COR_PROFILER e INSTANA_ALLOW_ROOT_EXIT_SPAN para esse valor.
4. Para definir o conteúdo de um MULTI_SZ valor, adicione um par chave-valor por linha, conforme mostrado no exemplo a seguir:

   COR_ENABLE_PROFILING=1
   COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
   INSTANA_ALLOW_ROOT_EXIT_SPAN=1

5. Após a última linha, pressione Enter.
6. Reinicie o serviço " Windows " para que as alterações entrem em vigor.

• Visualizar traços na interface do usuário do Instana
• Configurar recursos adicionais
• Verifique os problemas conhecidos e as limitações
• Resolver problemas de rastreamento d.NET Framework
• Desativar rastreio