The tracerpt command parses Event Trace Logs, log files generated by Performance Monitor, and real-time Event Trace providers. It also generates dump files, report files, and report schemas.
Syntax
tracerpt <[-l] <value [value [...]]>|-rt <session_name [session_name [...]]>> [options]
Parameters
| Parameters | Description |
|---|---|
:::no-loc text="-config"::: <filename> |
Specifies which settings file to load, which includes your command options. |
| :::no-loc text="-y"::: | Specifies to answer yes to all questions, without prompting. |
| :::no-loc text="-f"::: `<XML | HTML>` |
| :::no-loc text="-of"::: `<CSV | EVTX |
:::no-loc text="-df"::: <filename> |
Specifies to create a Microsoft-specific counting/reporting schema file. |
:::no-loc text="-int"::: <filename> |
Specifies to dump the interpreted event structure to the specified file. |
| :::no-loc text="-rts"::: | Specifies to add the report raw timestamp in the event trace header. Can only be used with -o. It's not supported with -report or -summary. |
:::no-loc text="-tmf"::: <filename> |
Specifies which Trace Message Format definition file to use. |
:::no-loc text="-tp"::: <value> |
Specifies the TMF file search path. Multiple paths may be used, separated by a semicolon (;). |
:::no-loc text="-i"::: <value> |
Specifies the provider image path. The matching PDB will be located in the Symbol Server. Multiple paths can be used, separated by a semicolon (;). |
:::no-loc text="-pdb"::: <value> |
Specifies the symbol server path. Multiple paths can be used, separated by a semicolon (;). |
| :::no-loc text="-gmt"::: | Specifies to convert WPP payload timestamps to Greenwich Mean Time. |
:::no-loc text="-rl"::: <value> |
Specifies the System Report Level from 1 to 5. Default is 1. |
| :::no-loc text="-summary"::: [filename] | Specifies to create a summary report text file. The filename, if not specified, is summary.txt. |
| :::no-loc text="-o"::: [filename] | Specifies to create a text output file. The filename, if not specified, is dumpfile.xml. |
| :::no-loc text="-report"::: [filename] | Specifies to create a text output report file. The filename, if not specified, is workload.xml. |
| :::no-loc text="-lr"::: | Specifies to be less restrictive. This uses best efforts for events that don't match the events schema. |
| :::no-loc text="-export"::: [filename] | Specifies to create an Event Schema export file. The filename, if not specified, is schema.man. |
:::no-loc text="[-l]"::: <value [value […]]> |
Specifies the Event Trace log file to process. |
:::no-loc text="-rt"::: <session_name [session_name […]]> |
Specifies the Real-time Event Trace Session data sources. |
| :::no-loc text="-?"::: | Displays help at the command prompt. |
Examples
To create a report based on the two event logs logfile1.etl and logfile2.etl, and to create the dump file logdump.xml in XML format, type:
tracerpt logfile1.etl logfile2.etl -o logdump.xml -of XML
To create a report based on the event log logfile.etl, to create the dump file logdmp.xml in XML format, to use best efforts to identify events not in the schema, and to produce a summary report file logdump.txt and a report file, logrpt.xml, type:
tracerpt logfile.etl -o logdmp.xml -of XML -lr -summary logdmp.txt -report logrpt.xml
To use the two event logs logfile1.etl and logfile2.etl to produce a dump file, and to report file with the default filenames, type:
tracerpt logfile1.etl logfile2.etl -o -report
To use the event log logfile.etl and the performance log counterfile.blg to produce the report file logrpt.xml and the Microsoft-specific XML schema file schema.xml, type:
tracerpt logfile.etl counterfile.blg -report logrpt.xml -df schema.xml
To read the real-time Event Trace Session NT Kernel Logger and to produce the dump file logfile.csv in CSV format, type:
tracerpt -rt NT Kernel Logger -o logfile.csv -of CSV
Related links
Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
