Datei mit zusammengefassten Meldungen

Eine Zusammenfassungsmeldungsdatei ist eine Textdatei, die die wichtigen Informationen zu einem Software-Trace enthält. Tracefmt erstellt nach der Verarbeitung der Nachrichten in einem Ablaufverfolgungsprotokoll oder einer Ablaufverfolgungssitzung eine Zusammenfassungsmeldungsdatei (.sum).

Die Zusammenfassungsmeldungsdatei enthält die folgenden Daten in einer statistischen Zusammenfassung:

• Die Anzahl der verarbeiteten Puffer

• Die Anzahl der verarbeiteten und verloren gegangenen Nachrichten

• Die verstrichene Zeit in Mikrosekunden der Sitzung zur Ablaufverfolgung

Nach der statistischen Zusammenfassung folgt eine Tabelle, die aus einer Zeile für jede Trace-Nachricht besteht, die im Trace enthalten ist. Jede Spalte der Tabelle enthält die folgenden Informationen über die Ablaufverfolgungsmeldung.

EventCount
Die Anzahl der Vorkommen der Protokollnachricht im Trace.

EventName
Der Anzeigename der Nachrichten-GUID der Tracing-Meldungen. Standardmäßig ist der Anzeigename einer Nachrichten-GUID der Name des Verzeichnisses, in dem der Ablaufverfolgungsanbieter erstellt wurde. Sie können jedoch einen alternativen Anzeigenamen festlegen, indem Sie den Parameter "-p" für RUN_WPP oder Tracewpp.exeverwenden. Weitere Informationen finden Sie unter Run_WPP Optionen. (EventName hat denselben Wert wie die %1-Variable im Ablaufverfolgungsnachrichten-Präfix.)

EventType
Der Anzeigename der Ablaufverfolgungsnachricht. Standardmäßig ist der freundliche Name einer Tracenachricht der Name der Quelldatei und die Zeilennummer des Codes, der die Tracenachricht generiert hat. (EventType hat denselben Wert wie die Variable %2 im Präfix der Protokollnachricht.)

GUID
Die Nachrichten-GUID der Tracing-Nachrichten.

Das folgende Beispiel zeigt eine Zusammenfassungsmeldungsdatei für das testtrace.etl-Ablaufverfolgungsprotokoll, das von Tracedrv generiert wird, einem Beispieltreiber, der für die Ablaufverfolgung instrumentiert ist. TraceDrv, ein Beispieltreiber, der für die Softwareablaufverfolgung entwickelt wurde, ist im Windows-Treiberbeispiel-Repository auf GitHub verfügbar.

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|
+---------------------------------------------------------------------------------+

Die vorherige Zusammenfassung zeigt, dass Tracedrv eine Header-Nachricht und zwei Trace-Meldungen generiert. Eine Ablaufverfolgungsnachricht wird von einer DoTraceMessage-Anweisung in Zeile 264 generiert, und die andere wird von einer DoTraceMessage-Anweisung in Zeile 258 generiert. In diesem Ablaufverfolgungsprotokoll gibt es 1700 Instanzen der ersten Ablaufverfolgungsnachricht und 17 Instanzen der zweiten Ablaufverfolgungsnachricht.

Die Nachrichtenzusammenfassungsdatei wird hauptsächlich zum Debuggen der Softwareablaufverfolgung verwendet, und das Format kann geändert werden.