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

Futásidejű konfigurációs beállítások hibakereséshez és profilkészítéshez

  • Cikk

Ez a cikk a .NET-hibakeresés és -profilkészítés konfigurálásához használható beállításokat ismerteti.

Megjegyzés:

A .NET 6 az előtagon DOTNET_ szabványosítja a .NET futásidejű viselkedést konfiguráló 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.

Diagnosztika engedélyezése

  • Konfigurálja, hogy a hibakereső, a profilkészítő és az EventPipe diagnosztika engedélyezve van-e vagy le van-e tiltva.
  • Ha kihagyja ezt a beállítást, a diagnosztika engedélyezve van. Ez egyenértékű az érték 1beállításával.
A beállítás neve Értékek
runtimeconfig.json N.A. N.A.
Környezeti változó COMPlus_EnableDiagnostics vagy DOTNET_EnableDiagnostics 1 -Engedélyezve
0 -Tiltva

Profilkészítés engedélyezése

  • Konfigurálja, hogy a profilkészítés engedélyezve van-e az aktuálisan futó folyamathoz.
  • Ha kihagyja ezt a beállítást, a profilkészítés le van tiltva. Ez egyenértékű az érték 0beállításával.
A beállítás neve Értékek
runtimeconfig.json N.A. N.A.
Környezeti változó CORECLR_ENABLE_PROFILING 0 -Tiltva
1 -Engedélyezve

Profiler GUID

  • Megadja a profilkészítőnek az aktuálisan futó folyamatba betöltendő GUID-azonosítóját.
A beállítás neve Értékek
runtimeconfig.json N.A. N.A.
Környezeti változó CORECLR_PROFILER sztring-guid

Profilkészítő helye

  • Megadja a profilkészítő DLL elérési útját a jelenleg futó folyamatba (vagy 32 bites vagy 64 bites folyamatba) való betöltéséhez.
  • Ha egynél több változó van beállítva, a bitness-specifikus változók elsőbbséget élveznek. Megadják a profilkészítő betöltendő bitképességét.
  • További információ: A profilkészítő kódtár megkeresése.
A beállítás neve Értékek
Környezeti változó CORECLR_PROFILER_PATH sztring-elérési út
Környezeti változó CORECLR_PROFILER_PATH_32 sztring-elérési út
Környezeti változó CORECLR_PROFILER_PATH_64 sztring-elérési út

Perf térképek és jit-memóriaképek exportálása

  • Engedélyezi vagy letiltja a perf térképek vagy jit-memóriaképek szelektív engedélyezését. Ezek a fájlok lehetővé teszik a külső eszközök, például a Linux perf eszköz számára a dinamikusan létrehozott kód és az előre összeállított ReadyToRun (R2R) modulok hívási helyeinek azonosítását.
  • Ha kihagyja ezt a beállítást, a perf map és a jit dump fájlok írása is le van tiltva. Ez egyenértékű az érték 0beállításával.
  • Ha a perf térképek le vannak tiltva, nem minden felügyelt hívási webhely lesz megfelelően feloldva.
  • A Linux kernel verziójától függően az eszköz mindkét formátumot támogatja perf .
  • A perf térképek vagy jit memóriaképek engedélyezése 10-20%-os többletterhelést okoz. A teljesítményre gyakorolt hatás minimalizálása érdekében ajánlott szelektíven engedélyezni a perf térképeket vagy a jit-memóriaképeket, de mindkettőt nem.

Az alábbi táblázat a perf térképeket és a jit-térképeket hasonlítja össze.

Format Leírás Támogatott:
Perf térképek Kibocsát, /tmp/perf-<pid>.mapamely szimbolikus információkat tartalmaz a dinamikusan létrehozott kódhoz.
Bocsát ki /tmp/perfinfo-<pid>.map, amely tartalmazza a ReadyToRun (R2R) modul szimbólumadatait, és amelyet a PerfCollect használ.		 A perf térképek minden Linux kernelverzióban támogatottak.
Jit-memóriaképek A jit memóriakép formátuma felülírja a perf térképeket, és részletesebb szimbolikus információkat tartalmaz. Ha engedélyezve van, a jit memóriaképek fájlokat eredményeznek /tmp/jit-<pid>.dump . Linux kernel 5.4-ös vagy újabb verziói.
A beállítás neve Értékek
runtimeconfig.json N.A. N.A.
Környezeti változó COMPlus_PerfMapEnabled vagy DOTNET_PerfMapEnabled 0 -Tiltva
1 - a perf térképek és a jit memóriaképek engedélyezve
2 - jit memóriaképek engedélyezve
3 - a perf térképek engedélyezve

Perf naplójelölők

  • Engedélyezi vagy letiltja a megadott jel elfogadását és figyelmen kívül hagyását a perf naplók jelölőjeként.
  • Ha kihagyja ezt a beállítást, a rendszer nem hagyja figyelmen kívül a megadott jelet. Ez egyenértékű az érték 0beállításával.
A beállítás neve Értékek
runtimeconfig.json N.A. N.A.
Környezeti változó COMPlus_PerfMapIgnoreSignal vagy DOTNET_PerfMapIgnoreSignal 0 -Tiltva
1 -Engedélyezve

Megjegyzés:

Ez a beállítás figyelmen kívül lesz hagyva, ha a DOTNET_PerfMapEnabled nincs megadva vagy be van állítva 0 (azaz le van tiltva).