Freigeben über


Processing

Displays trace post-processing options.

xperf -i <trace file>... 
     [-o output] 
     [-symbols ...] 
     [-target {human|machine}] 
     [-a action ...[-a action ...] ...]
     [-quiet]
     [-tle]
     [-tli]

Parameters

-i trace file

The trace file to be processed.

-o output file

Optional, the name of the file that output goes to. If not given, stdout is used.

-symbols [options]

Enable and configure symbol decoding support. See "xperf -help symbols" for detailed help

-target {human|machine}

Select the target audience of the output. Default is human.

-a action ...

Optional, the actions to take. Default action is to dump the event in text form.

-quiet

Do not print progress information.

-tle

Process the trace even in the presence of lost events.

Lost events generally happen because the buffers for the trace sessions were too small or too few. If this happens, you should increase the ETW session sizes instead of using the -tle parameter. For more information, see Using Event Tracing.

Note

You must use -tle parameter only when a trace with missing events must be processed. If the parameter is specified and events were indeed lost, none of the calculations and aggregations produced by XPerf can be considered accurate.

-tti

Process the trace even in the presence of time inversions.

On some systems, the time source may not be completely reliable. Although XPerf handles small time inversions by default, it issues a warning only in those cases where time inversions were too large or frequent.

Note

You must use -tti parameter only when a trace on a system with large time inversions must be processed. As a workaround, you may want to switch to another hardware platform whenever your trace sessions encounter time inversions.

Examples

xperf -i trace.etl -o out.csv
dump the events in trace.etl to file out.csv
xperf -help registry
print help on action registry
xperf -i trace.etl -a registry
print registry access statistics to stdout
xperf -i trace32.etl trace64.etl -o out.csv
dump the events in trace32.etl and trace64.etl to file o

Available Actions

Action Meaning
boot
Show boot and shutdown statistics
Bootprefetch
Show boot-time prefetching information
cpudisk
Show CPU/Disk activity report
cswitch
Show Context Switch data
diskio
Show Disk IO Statistics
dpcisr
Show DPC/ISR Statistics
drvdelay
Show Driver delays
drvdelay
Show Driver delays
dumper
Dump events in the trace in text form
filename
Show File Names in the trace
focuschange
Show the Windows thread focus change events in the trace
hardfault
Show hard fault statistics by process and file.
marks
Show Marks Information
pagefault
Show page fault information in the trace
perfctrs
Show process performance counters
pnp
Show PnP events in the trace
prefetch
Show Prefetch Information
process
Show process, thread, image information
profile
Show Sampled profiler data
readyBoot
Show ReadyBoot statistics
registry
Show Registry Access Statistics
services
Show service status information
shutdown
Show shutdown statistics
stack
Show stack information
suspend
Show suspend transition information
sysconfig
Show system configuration information
tracestats
Show trace statistics
winlogon
Show Winlogon events in the trace

Use xperf -help <action> [<action> ...] for detailed help. If no action is present, Dumper will be invoked.