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

Artigo
12/05/2023

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

Nota

O .NET 6 padroniza o prefixo DOTNET_ em vez de variáveis de ambiente que configuram o comportamento em tempo de execução do COMPlus_ .NET. No entanto, o prefixo COMPlus_ continuará a funcionar. Se você estiver usando uma versão anterior do tempo de execução do .NET, ainda deverá usar o prefixo COMPlus_ para variáveis de ambiente.

Ativar diagnóstico

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.

	Nome da definição	Valores
runtimeconfig.json	N/A	N/A
Variável de ambiente	`COMPlus_EnableDiagnostics` ou `DOTNET_EnableDiagnostics`	`1` - ativado `0` - deficientes

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.

	Nome da definição	Valores
runtimeconfig.json	N/A	N/A
Variável de ambiente	`CORECLR_ENABLE_PROFILING`	`0` - deficientes `1` - ativado

GUID do criador de perfil

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

	Nome da definição	Valores
runtimeconfig.json	N/A	N/A
Variável de ambiente	`CORECLR_PROFILER`	string-guid

Localização do criador de perfil

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.
Para obter mais informações, consulte Localizando a biblioteca do criador de perfil.

	Nome da definição	Valores
Variável de ambiente	`CORECLR_PROFILER_PATH`	caminho da cadeia de caracteres
Variável de ambiente	`CORECLR_PROFILER_PATH_32`	caminho da cadeia de caracteres
Variável de ambiente	`CORECLR_PROFILER_PATH_64`	caminho da cadeia de caracteres

Exportar mapas perf e jit dumps

Habilita ou desabilita a ativação seletiva de mapas perf ou jit dumps. Esses arquivos permitem que ferramentas de terceiros, como a ferramenta Linux perf , identifiquem sites de chamada 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 perf ou jit dumps causa uma sobrecarga de 10-20%. Para minimizar o impacto no desempenho, é recomendável habilitar seletivamente mapas perf ou jit dumps, mas não ambos.

A tabela a seguir compara mapas perf e jit maps.

Formato	Description	Suportado em
Mapas de Perf	Emite `/tmp/perf-<pid>.map`, que contém informações simbólicas para código gerado dinamicamente. Emits `/tmp/perfinfo-<pid>.map`, que inclui informações do símbolo do módulo ReadyToRun (R2R) e é usado pelo PerfCollect.	Os mapas Perf são suportados em todas as versões do kernel Linux.
Despejos de Jit	O formato jit dump substitui os mapas perf e contém informações simbólicas mais detalhadas. Quando ativado, os despejos jit são enviados para `/tmp/jit-<pid>.dump` arquivos.	Linux kernel versões 5.4 ou superior.

	Nome da definição	Valores
runtimeconfig.json	N/A	N/A
Variável de ambiente	`COMPlus_PerfMapEnabled` ou `DOTNET_PerfMapEnabled`	`0` - deficientes `1` - Mapas Perf e Jit Dumps ambos ativados `2` - Dumps JIT ativados `3` - Mapas PERF ativados

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.

	Nome da definição	Valores
runtimeconfig.json	N/A	N/A
Variável de ambiente	`COMPlus_PerfMapIgnoreSignal` ou `DOTNET_PerfMapIgnoreSignal`	`0` - deficientes `1` - ativado