Megosztás a következőn keresztül:

Memóriaképek gyűjtése összeomlás után

  • Cikk

Az alkalmazás konfigurálása összeomlási memóriakép gyűjtésére adott környezeti változók beállításával történik. Ez akkor hasznos, ha szeretné megtudni, hogy miért történt összeomlás. Ha például kivétel esetén rögzít egy memóriaképet, azzal azonosíthatja a problémát, ha megvizsgálja az alkalmazás összeomlásának állapotát.

Az alábbi táblázat az összeomlási memóriaképek gyűjtésére konfigurálható környezeti változókat mutatja be.

Környezeti változó Leírás Alapértelmezett érték
COMPlus_DbgEnableMiniDump vagy DOTNET_DbgEnableMiniDump Ha 1 értékre van állítva, engedélyezze az alapvető memóriakép létrehozását. 0
COMPlus_DbgMiniDumpType vagy DOTNET_DbgMiniDumpType Gyűjtendő memóriakép típusa. További információkért lásd a miniképek típusait. 2 (Heap)
COMPlus_DbgMiniDumpName vagy DOTNET_DbgMiniDumpName Egy fájl elérési útja a memóriakép írásához. Győződjön meg arról, hogy a dotnet-folyamatot futtató felhasználó írási engedélyekkel rendelkezik a megadott könyvtárhoz. /tmp/coredump.<pid>
COMPlus_CreateDumpDiagnostics vagy DOTNET_CreateDumpDiagnostics Ha 1 értékre van állítva, engedélyezi a memóriaképi folyamat diagnosztikai naplózását. 0
COMPlus_EnableCrashReport vagy DOTNET_EnableCrashReport (.NET 6 vagy újabb verziót igényel, Windows rendszeren nem támogatott.)
Ha 1 értékre van állítva, a futtatókörnyezet létrehoz egy JSON formátumú összeomlási jelentést, amely információkat tartalmaz az összeomló alkalmazás szálairól és veremkereteiről. Az összeomlási jelentés neve a memóriakép elérési útja vagy neve .crashreport.json hozzáfűzve.
COMPlus_CreateDumpVerboseDiagnostics vagy DOTNET_CreateDumpVerboseDiagnostics (.NET 7 vagy újabb verziót igényel.)
Ha 1 értékre van állítva, engedélyezi a memóriakép folyamat részletes diagnosztikai naplózását.		 0
COMPlus_CreateDumpLogToFile vagy DOTNET_CreateDumpLogToFile (.NET 7 vagy újabb verziót igényel.)
Annak a fájlnak az elérési útja, amelyhez a diagnosztikai üzeneteket meg kell írni.		 Ha a rendszer nem eteti, a rendszer az összeomló alkalmazás konzoljára írja a diagnosztikai üzeneteket.

Feljegyzés

A .NET 7 szabványosítja az előtagot DOTNET_ a környezeti változók helyett COMPlus_ . Az COMPlus_ előtag azonban továbbra is működni fog. Ha a .NET-futtatókörnyezet egy korábbi verzióját használja, akkor is használja a COMPlus_ környezeti változók előtagját.

Fájlútvonal-sablonok

A .NET 5-től DOTNET_DbgMiniDumpName kezdve a dinamikusan kitöltendő formázási sablonjelölőket is tartalmazhat:

Kijelölő Érték
%% Egyetlen % karakter
%p A dömpingelt folyamat PID-je
%e A folyamat végrehajtható fájlneve
%h A gazdagép neve a következő szerint tér vissza: gethostname()
%t A memóriakép ideje, a korszak óta másodpercben kifejezve, 1970-01-01 00:00:00 +0000 (UTC)

Mini memóriaképek típusai

Az alábbi táblázat az összes használható DOTNET_DbgMiniDumpTypeértéket megjeleníti. Az 1 értékre állítás DOTNET_DbgMiniDumpType például azt jelenti, hogy Mini a rendszer egy összeomláskor gyűjti össze a típusképet.

Érték Név Leírás
0 Mini Egy kis memóriakép, amely modullistákat, szállistákat, kivételadatokat és minden vermet tartalmaz.
2 Heap Nagy és viszonylag átfogó memóriakép, amely modullistákat, szállistákat, minden vermet, kivételadatokat, információkat és minden memóriát tartalmaz, kivéve a leképezett képeket.
3 Triage Ugyanaz, mint Minia , de eltávolítja a személyes felhasználói adatokat, például az útvonalakat és a jelszavakat.
4 Full A legnagyobb memóriakép, amely tartalmazza az összes memóriát, beleértve a modulképeket is.

Az egyfájlos és natív AOT-alkalmazásmodellek csak a teljes memóriaképeket támogatják.