Összefoglaló üzenetfájl

Az összefoglaló üzenetfájl egy olyan szöveges fájl, amely a szoftver nyomkövetésével kapcsolatos információkat tartalmazza. A Tracefmt egy összefoglaló üzenetfájlt (.sum) hoz létre, miután feldolgozta az üzeneteket egy nyomkövetési naplóban vagy nyomkövetési munkamenetben.

Az összefoglaló üzenetfájl a következő adatokat tartalmazza egy statisztikai összegzésben:

• A feldolgozott pufferek száma

• A feldolgozott és elveszett üzenetek száma

• A nyomkövetési munkamenet eltelt ideje mikroszekundumban

A statisztikai összegzést követve egy táblázat látható, amely egy sorból áll a nyomkövetési üzenetben szereplő összes nyomkövetési üzenethez. A tábla minden oszlopa a következő információkat tartalmazza a nyomkövetési üzenetről:

EventCount
A nyomkövetési üzenet példányainak száma a nyomkövetésben.

EventName
A nyomkövetési üzenetek GUID azonosítójának barátságos neve. Alapértelmezés szerint egy üzenet GUID barátságos neve annak a könyvtárnak a neve, amelyben a nyomkövetési szolgáltató készült, de a -p paraméterrel megadhat egy másik barátságos nevet a RUN_WPP vagy Tracewpp.exeszámára. További információ: Run_WPP Beállítások. (Az EventName értéke megegyezik a nyomkövetési üzenet előtagjának %1 változó értékével.)

EventType
A nyomkövetési üzenet barátságos neve. Alapértelmezés szerint a nyomkövetési üzenet rövid neve a forrásfájl neve és a nyomkövetési üzenetet létrehozó kód sorszáma. (Az EventType értéke megegyezik a nyomkövetési üzenet előtagjának %2 változó értékével.)

GUID
A nyomkövetési üzenetek GUID-ja.

Az alábbi példa egy összegző üzenetfájlt mutat be a tracedrv által létrehozott testtrace.etl nyomkövetési naplóhoz, amely egy nyomkövetési mintaillesztő. A Szoftverkövetéshez tervezett TraceDrv mintaillesztő a GitHub windowsos illesztőprogram-mintatárából érhető el.

Files Processed:
d:\DDK Tools\tracetools\testtrace.etl
Total Buffers Processed 4
Total Events  Processed 1718
Total Events  Lost      4
Elapsed Time            122 sec
+---------------------------------------------------------------------------------+
|EventCount    EventName    EventType         Guid                                |
+---------------------------------------------------------------------------------+
|         1    Header       Header            68fdd900-4a3e-11d1-84f4-0000f80464e3|
|      1700    tracedrv     tracedrv_c264     37753236-c81f-505e-d40a-128d3bb2b5ff|
|        17    tracedrv     tracedrv_c258     37753236-c81f-505e-d40a-128d3bb2b5ff|
+---------------------------------------------------------------------------------+

Az előző összegzés azt mutatja, hogy a Tracedrv fejlécüzenetet és két nyomkövetési üzenetet hoz létre. Az egyik nyomkövetési üzenetet egy DoTraceMessage utasítás hozza létre a 264-es sorban, a másikat pedig egy DoTraceMessage utasítás hozza létre a 258. sorban. Ebben a nyomkövetési naplóban az első nyomkövetési üzenet 1700 példánya és a második nyomkövetési üzenet 17 példánya található.

Az összefoglaló üzenetfájl elsősorban a szoftverkövetés hibakeresésére szolgál, formátuma változhat.