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


A .NET-keretrendszer naplózásának szabályozása

A Windows (ETW) eseménykövetésének használatával rögzítheti a gyakori nyelvi futtatókörnyezeti (CLR-) eseményeket. Nyomkövetéseket az alábbi eszközökkel hozhat létre és tekinthet meg:

A CLR eseményinformációinak rögzítéséhez a CLR-szolgáltatót telepíteni kell a számítógépre. A szolgáltató telepítésének megerősítéséhez írja be logman query providers a parancssorba. Megjelenik a szolgáltatók listája. Ennek a listának tartalmaznia kell egy bejegyzést a CLR-szolgáltatóhoz az alábbiak szerint.

Provider                                 GUID
-------------------------------------------------------------------------------
.NET Common Language Runtime    {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}.

Ha a CLR-szolgáltató nem szerepel a listán, a Windows Wevtutil parancssori eszközzel telepítheti Windows Vista és újabb operációs rendszereken. Nyissa meg a parancsablakot rendszergazdaként. Módosítsa a parancssori könyvtárat a .NET-keretrendszer 4 mappára (%WINDIR%\Microsoft.NET\Framework[64]\v4.<). NET-verzió>\ ). Ez a mappa tartalmazza a CLR-ETW.man fájlt. A parancssorba írja be a következő parancsot a CLR-szolgáltató telepítéséhez:

wevtutil im CLR-ETW.man

CLR ETW-események rögzítése

A Logman és xperf parancssori eszközökkel rögzítheti az ETW-eseményeket, a Tracerpt- és Xperf-eszközöket pedig a nyomkövetési események dekódolásához.

A naplózás bekapcsolásához a felhasználónak három dolgot kell megadnia:

  • A szolgáltató, a aki felé kommunikálni szeretne.

  • Egy 64 bites szám, amely kulcsszavak halmazát jelöli. Minden kulcsszó olyan eseményeket jelöl, amelyeket a szolgáltató bekapcsolhat. A szám a bekapcsolni kívánt kulcsszavak együttes készletét jelöli.

  • Egy kis szám, amely a naplózandó szintet (részletességet) jelöli. Az 1. szint a legkevésbé részletes, az 5. szint pedig a legigértőbb. A 0. szint egy alapértelmezett érték, amelynek jelentése szolgáltatóspecifikus.

CLR ETW-események rögzítése a Logman használatával

  1. A parancssorba írja be a következőt:

    logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf

    ahol:

    • A -p paraméter azonosítja a szolgáltató GUID azonosítót.

    • 0x1CCBD meghatározza a felhozandó események kategóriáit.

    • 0x5 a naplózás szintjét állítja be (ebben az esetben részletes (5)).

    • A -ets paraméter utasítja a Logmant, hogy küldjön parancsokat az eseménykövetési munkamenetekbe.

    • A -ct perf paraméter megadja, hogy a QueryPerformanceCounter függvény használatával naplózza az egyes események időbélyegét.

  2. Az események naplózásának leállításához írja be a következőt:

    logman stop clrevents -ets

    Ez a parancs létrehoz egy clrevents.etl nevű bináris nyomkövetési fájlt.

CLR ETW-események rögzítése az Xperf használatával

  1. A parancssorba írja be a következőt:

    xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl

    ahol a GUID a CLR ETW-szolgáltató GUID azonosítója, és 0x1CCBD:5 mindent az 5. szinten és alatt követ nyomon (részletes).

  2. A nyomkövetés leállításához írja be a következőt:

    Xperf -stop clr

    Ez a parancs létrehoz egy clrevents.etl nevű nyomkövetési fájlt.

CLR ETW-események megtekintése

Az alábbi parancsokkal tekintheti meg a CLR ETW-eseményeket. Az események leírásáért lásd a CLR ETW-eseményeket.

CLR ETW-események megtekintése a Tracerpt használatával

  • A parancssorba írja be a következőt:

    tracerpt clrevents.etl

    Ez a parancs két fájlt hoz létre: dumpfile.xml és summary.txt. A dumpfile.xml fájl felsorolja az összes eseményt, és summary.txt az események összegzését tartalmazza.

CLR ETW-események megtekintése az Xperf használatával

  • A parancssorba írja be a következőt:

    xperf clrevents.etl

    Ez a parancs megnyitja az Xperf ETL fájlmegjelenítőt. Ebben a megjelenítőben a CLR-események megjelennek az Általános események nézetben. Ha típus szerint kategorizálva szeretné megjeleníteni az események adatrácsát, válasszon ki egy időrégiót ebben a nézetben, majd kattintson a jobb gombbal, és válassza az Összegzés lehetőséget.

Az .etl-fájl vesszővel tagolt értékfájllá alakítása

  • A parancssorba írja be a következőt:

    xperf -i clrevents.etl -f clrevents.csv

    Ez a parancs miatt az XPerf vesszővel elválasztott értékfájlként (CSV) jeleníti meg az eseményeket. Mivel a különböző események különböző mezőkkel rendelkeznek, ez a CSV-fájl több fejlécsort tartalmaz az adatok előtt. Minden sor első mezője az esemény típusa, amely azt jelzi, hogy melyik fejlécet kell használni a többi mező meghatározásához.

Lásd még