Körningskonfigurationsalternativ för felsökning och profilering

Artikel
12/05/2023

Den här artikeln beskriver de inställningar som du kan använda för att konfigurera .NET-felsökning och profilering.

Kommentar

.NET 6 standardiserar på prefixet DOTNET_ i stället COMPlus_ för för miljövariabler som konfigurerar .NET-körningsbeteende. Prefixet COMPlus_ fortsätter dock att fungera. Om du använder en tidigare version av .NET-körningen bör du fortfarande använda prefixet COMPlus_ för miljövariabler.

Aktivera diagnostik

Konfigurerar om felsökningsprogrammet, profileraren och EventPipe-diagnostiken är aktiverade eller inaktiverade.
Om du utelämnar den här inställningen aktiveras diagnostik. Detta motsvarar att ange värdet till 1.

	Inställningsnamn	Värden
runtimeconfig.json	Saknas	Saknas
Miljövariabel	`COMPlus_EnableDiagnostics` eller `DOTNET_EnableDiagnostics`	`1` -Aktiverat `0` -Inaktiverad

Aktivera profilering

Konfigurerar om profilering är aktiverat för den process som körs.
Om du utelämnar den här inställningen inaktiveras profilering. Detta motsvarar att ange värdet till 0.

	Inställningsnamn	Värden
runtimeconfig.json	Saknas	Saknas
Miljövariabel	`CORECLR_ENABLE_PROFILING`	`0` -Inaktiverad `1` -Aktiverat

Profilerar-GUID

Anger GUID för profileraren som ska läsas in i den process som körs.

	Inställningsnamn	Värden
runtimeconfig.json	Saknas	Saknas
Miljövariabel	`CORECLR_PROFILER`	string-guid

Profileringsplats

Anger sökvägen till profilerar-DLL:en som ska läsas in i den process som körs (eller 32-bitars eller 64-bitarsprocessen).
Om fler än en variabel anges har de bitnessspecifika variablerna företräde. De anger vilken bit av profilerare som ska läsas in.
Mer information finns i Hitta profilerarbiblioteket.

	Inställningsnamn	Värden
Miljövariabel	`CORECLR_PROFILER_PATH`	strängsökväg
Miljövariabel	`CORECLR_PROFILER_PATH_32`	strängsökväg
Miljövariabel	`CORECLR_PROFILER_PATH_64`	strängsökväg

Exportera perf-kartor och jit-dumpar

Aktiverar eller inaktiverar selektiv aktivering av perf-kartor eller jitdumpar. Dessa filer gör det möjligt för verktyg från tredje part, till exempel Linux-verktyget perf , att identifiera anropsplatser för dynamiskt genererad kod och förkompilerade ReadyToRun-moduler (R2R).
Om du utelämnar den här inställningen inaktiveras båda filerna för att skriva perf-karta och jit dump. Detta motsvarar att ange värdet till 0.
När perf-kartor är inaktiverade kommer inte alla hanterade anropswebbplatser att lösas korrekt.
Beroende på Linux-kernelversionen stöds båda formaten perf av verktyget.
Om du aktiverar perf-kartor eller jitdumpar medför det en kostnad på 10–20 %. För att minimera prestandapåverkan rekommenderar vi att du selektivt aktiverar antingen perf-kartor eller jitdumpar, men inte båda.

I följande tabell jämförs perf-kartor och jit-kartor.

Format	beskrivning	Stöds på
Perf-kartor	Genererar `/tmp/perf-<pid>.map`, som innehåller symbolisk information för dynamiskt genererad kod. Genererar `/tmp/perfinfo-<pid>.map`, som innehåller information om Modulen ReadyToRun (R2R) och används av PerfCollect.	Perf-kartor stöds i alla Linux-kernelversioner.
Jit dumpar	Jit dump-formatet ersätter perf-kartor och innehåller mer detaljerad symbolisk information. När det är aktiverat matas jit-dumpar ut till `/tmp/jit-<pid>.dump` filer.	Linux-kernelversioner 5.4 eller senare.

	Inställningsnamn	Värden
runtimeconfig.json	Saknas	Saknas
Miljövariabel	`COMPlus_PerfMapEnabled` eller `DOTNET_PerfMapEnabled`	`0` -Inaktiverad `1` - perf maps och jit dumpar båda aktiverade `2` – jit dumpar aktiverade `3` – perf-kartor aktiverade

Perf-loggmarkörer

Aktiverar eller inaktiverar den angivna signalen som ska accepteras och ignoreras som en markör i perf-loggarna.
Om du utelämnar den här inställningen ignoreras inte den angivna signalen. Detta motsvarar att ange värdet till 0.

	Inställningsnamn	Värden
runtimeconfig.json	Saknas	Saknas
Miljövariabel	`COMPlus_PerfMapIgnoreSignal` eller `DOTNET_PerfMapIgnoreSignal`	`0` -Inaktiverad `1` -Aktiverat