Opções de configuração de tempo de execução 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.

Ativar diagnósticos

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

Ativar 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 equivale a definir o valor como 0.
• Para carregar um perfilador, além de ativar o perfil, o GUID e a localização do perfilador também precisam de ser configurados usando estas definições.

GUID do criador de perfil

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

Localização do criador de perfil

Uma vez ativado o perfil, o perfilador pode ser carregado de duas formas: com variáveis de ambiente (cross-plat) ou através do registo (apenas Windows). As variáveis de ambiente do caminho do perfilador têm precedência sobre qualquer caminho da biblioteca COM no registo, se ambos forem especificados.

Variável de ambiente (cross-plot)

• 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 bitness terão precedência. Eles especificam qual bitness do profiler carregar.

Através do registo (apenas Windows)

Quando as DOTNET_PROFILER_PATH*variáveis de ambiente não estão definidas durante a execução no Windows, o coreclr procura o CLSID no DOTNET_PROFILER registo para encontrar o caminho completo até à DLL do profiler. Tal como em qualquer DLL de servidor COM, o CLSID do profiler é consultado em HKEY_CLASSES_ROOT, o que funde as classes do HKLM e do HKCU.

Exportar mapas de perf e jit dumps

• Habilita ou desabilita mapas perf ou jit dumps. Esses arquivos permitem que ferramentas de terceiros, como a ferramenta Linux perf , forneçam nomes legíveis por humanos para código gerado dinamicamente e módulos ReadyToRun (R2R) pré-compilados.
• Se você omitir essa configuração, a gravação de arquivos perf map e jit dump será desabilitada. Isso equivale a definir o valor como 0.
• Quando os mapas perf são desativados, nem todos os sites de chamada gerenciados serão resolvidos corretamente.
• Dependendo da versão do kernel Linux, ambos os formatos são suportados perf pela ferramenta.
• Habilitar mapas de perf ou jit dumps pode causar até 20% de sobrecarga, embora muitas vezes seja muito menor. Para minimizar o impacto no desempenho, é recomendável habilitar seletivamente mapas perf ou jit dumps, mas não ambos. O impacto ocorre apenas enquanto o aplicativo é código JITing. Muitas vezes, 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 jit maps.

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 equivale a definir o valor como 0.