Samla in dumpar vid krasch

Du konfigurerar programmet för att samla in en dump vid krasch genom att ange specifika miljövariabler. Detta är användbart när du vill få en förståelse för varför en krasch inträffade. Om du till exempel samlar in en dump när ett undantag utlöses kan du identifiera ett problem genom att undersöka appens tillstånd när det kraschade.

I följande tabell visas de miljövariabler som du kan konfigurera för att samla in dumpar vid en krasch.

Miljövariabel	beskrivning	Standardvärde
DOTNET_DbgEnableMiniDump	Om värdet är 1 aktiverar du generering av kärndumpar.	0
DOTNET_DbgMiniDumpType	Typ av dump som ska samlas in. Mer information finns i Typer av minidumpar.	2 (Heap)
DOTNET_DbgMiniDumpName	Sökväg till en fil som dumpen ska skrivas till. Kontrollera att användaren som dotnet-processen körs under har skrivbehörighet till den angivna katalogen.	/tmp/coredump.<pid>
DOTNET_CreateDumpDiagnostics	Om värdet är 1 aktiverar du diagnostikloggning av dumpprocessen.	0
DOTNET_DbgCreateDumpToolPath	Endast (.NET 11+ NativeAOT) Sökväg till katalogen där verktyget createdump finns. Runtime kommer att leta efter createdump-binärfilen i den här katalogen. Den här variabeln är användbar i scenarier där createdump inte levereras med runtime och du behöver ta med ditt eget verktyg för skapande av dumpfiler. Den här miljövariabeln stöds bara i NativeAOT-program och ignoreras annars.
DOTNET_EnableCrashReport	(stöds inte i Windows.) Om värdet är 1 genererar körningen en JSON-formaterad kraschrapport som innehåller information om trådarna och stackramarna i det kraschande programmet. Kraschrapportens namn är dumpsökvägen eller namnet med .crashreport.json bifogad.
DOTNET_CreateDumpVerboseDiagnostics	Om värdet är 1 aktiverar du utförlig diagnostisk loggning av dumpprocessen.	0
DOTNET_CreateDumpLogToFile	Sökvägen till filen som diagnostikmeddelandena ska skrivas till.	Om det inte anges skrivs diagnostikmeddelandena till konsolen för det kraschande programmet.

Filsökvägsmallar

Från och med .NET 5 DOTNET_DbgMiniDumpName kan du även inkludera formateringsmallsspecificerare som fylls i dynamiskt:

Specificerare	Värde
%%	Ett enskilt % tecken
%p	PID för dumpad process
%e	Körbart filnamn för processen
%h	Värdnamn returneras av gethostname()
%t	Tiden för dumpning, uttryckt som sekunder sedan epoken, 1970-01-01 00:00:00 +0000 (UTC)

Typer av minidumpar

I följande tabell visas alla värden som du kan använda för DOTNET_DbgMiniDumpType. Till exempel innebär inställningen DOTNET_DbgMiniDumpType 1 att Mini typdump samlas in vid en krasch.

Värde	Namn	beskrivning
1	Mini	En liten dump som innehåller modullistor, trådlistor, undantagsinformation och alla staplar.
2	Heap	En stor och relativt omfattande dump som innehåller modullistor, trådlistor, alla staplar, undantagsinformation, hantera information och allt minne förutom mappade bilder.
3	Triage	Samma som Mini, men tar bort personlig användarinformation, till exempel sökvägar och lösenord.
4	Full	Den största dumpen som innehåller allt minne, inklusive modulbilderna.

Endast fullständiga dumpar stöds av appmodellerna single-file och Native AOT.