Opções de configuração de runtime para depuração e criação de perfil

Este artigo detalha as configurações que você pode usar para configurar a depuração e a criação de perfil do .NET.

Habilitar diagnóstico

• Configura se o depurador, o criador de perfil e o diagnóstico eventPipe estão habilitados ou desabilitados.
• Se você omitir essa configuração, o diagnóstico será habilitado. Isso é equivalente a definir o valor como 1.

Habilitar criação de perfil

• Configura se a criação de perfil está habilitada para o processo em execução no momento.
• Se você omitir essa configuração, a criação de perfil será desabilitada. Isso é equivalente a definir o valor como 0.
• Para carregar um criador de perfil, além de habilitar a criação de perfil, o GUID do criador de perfil e o local do criador de perfil também precisam ser configurados usando essas configurações.

GUID do criador de perfil

• Especifica o GUID do criador de perfil a ser carregado no processo em execução no momento.

Local do Criador de Perfil

Depois que a criação de perfil estiver habilitada, o criador de perfil poderá ser carregado de duas maneiras: com variáveis de ambiente (entre equipes) ou por meio do registro (somente Windows). As variáveis de ambiente de caminho do criador de perfil têm precedência sobre qualquer caminho de biblioteca COM no registro, se ambas forem especificadas.

Variável de ambiente (entre equipes)

• Especifica o caminho para a DLL do criador de perfil a ser carregada no processo em execução no momento (ou processo de 32 bits ou 64 bits).
• Se mais de uma variável for definida, as variáveis específicas de bits têm precedência. Eles especificam qual bit do criador de perfil carregar.

Por meio do registro (somente Windows)

Quando as DOTNET_PROFILER_PATH*variáveis de DOTNET_PROFILER ambiente não são definidas durante a execução no Windows, o coreclr procura o CLSID no registro para encontrar o caminho completo para a DLL do criador de perfil. Assim como acontece com qualquer DLL de servidor COM, o CLSID do criador de perfil é pesquisado em HKEY_CLASSES_ROOT, que mescla as classes de HKLM e HKCU.

Exportar mapas perf e despejos de jit

• Habilita ou desabilita mapas perf ou despejos de jit. Esses arquivos permitem que ferramentas de terceiros, como a ferramenta Linux perf , forneçam nomes legíveis humanos para códigos gerados dinamicamente e módulos R2R (ReadyToRun) pré-compilados.
• Se você omitir essa configuração, a gravação do mapa perf e os arquivos de despejo de jit serão desabilitados. Isso é equivalente a definir o valor como 0.
• Quando os mapas perf estiverem desabilitados, nem todos os sites de chamadas gerenciados serão resolvidos corretamente.
• Dependendo da versão do kernel do Linux, ambos os formatos são compatíveis com a perf ferramenta.
• Habilitar mapas perf ou despejos de jit pode causar até 20% sobrecarga, embora muitas vezes seja muito menos. Para minimizar o impacto no desempenho, é recomendável habilitar seletivamente mapas perf ou despejos de jit, mas não ambos. O impacto ocorre apenas enquanto o aplicativo é o código JITing. Geralmente isso ocorre na inicialização, mas pode ocorrer mais tarde se o aplicativo estiver executando um novo caminho de código pela primeira vez.

A tabela a seguir compara mapas perf e mapas jit.

Marcadores de log perf

• Habilita ou desabilita o sinal especificado a ser aceito e ignorado como um marcador nos logs de perf.
• Se você omitir essa configuração, o sinal especificado não será ignorado. Isso é equivalente a definir o valor como 0.