Export (0) Print
Expand All

start

Displays logger start options.

xperf [-start [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -on Flags|Groups options ...
or -flush [LoggerName] ...
or -save ProfileFileName!ProfileName|SessionName merged.etl
or -SetProfInt [<n>] [cached]
User provider format for -on: (GUID|KnownProviderName)[:Flags[:Level]]

Examples

The following table shows examples of using the logger start options.

-start LoggerName|ProfileFileName!ProfileName|SessionName

Start a logging session for LoggerName. Or start loggers in profile ProfileName defined in file ProfileFileName. Or start logger SessionName defined in file ProfileFileName.

-update LoggerName|ProfileFileName!ProfileName|SessionName

Update a logging session for LoggerName. Or update loggers in profile ProfileName defined in file ProfileFileName. Or update logger SessionName defined in file ProfileFileName.

-flush LoggerName

Flush a logging session for LoggerName.

-on Flags|Groups

For kernel logging sessions, the sequence of kernel flags and groups to be enabled, separated by '+'. For user logging sessions, the sequence of providers to be enabled, separated by '+'. The accepted provider format is: (GUID|KnownProviderName)[:Flags[:Level]]. Use "xperf -help providers" for a list of valid flags.

-BufferSize Size

Set trace buffer size to Size KB (4 KB - 1024 KB); default: 64 KB.

-MinBuffers n

Set minimum number of trace buffers to n; default: 64.

-MaxBuffers n

Set maximum number of trace buffers to n; default: 320.

-MaxFile Size

Set maximum file size to Size MB.

-FlushTimer n

Set the flush timer to n seconds.

-BootTrace Flags|Groups|off

Configure the Event Tracing For Windows Logger to trace boot. Set flags as off to turn off boot tracing. All logging control can be used in conjunction with this. Use in conjunction with -f to log to a file other than \Perf.etl.

-RealTime

Enable real time tracing.

-Buffering

Enable buffering mode tracing.

-FileMode Mode

Set the File Mode; default: Sequential. Mode: Sequential, Circular, Append, NewFile.

-ClockType ClockType

Set the clock type; default: PerfCounter.Type: Cycle, PerfCounter, SystemTime.

-StackWalk flags|@file

Enable stack walking for the events specified as Flag+Flag+..., or parse 'file' file for flags. Run "xperf -help stackwalk" for more information.

-Pids pid [...]

Apply flags to processes pid [...]. Used in conjunction with private loggers.

-PidNewProcess <command-line>

Apply flags to a new process xperf will start with <command-line>. Used in conjunction with private loggers.

-WaitForNewProcess

Wait for new process created using -pidNewProcess to return before exiting.

-heap

Enable heap tracing in processes specified by Pids and PidNewProcess.

-critsec

Enable critical section tracing in processes specified by Pids and PidNewProcess.

-SetProfInt [<n>] [cached]

Set sampled profile interval to <n> [1221 ..10000000]. If "cached" is specified, intervals are cached in ETW and reapplied whenever new ETW kernel loggers with sampled profile are started. [Default: <n> = 10000; not cached].

-save ProfileFileName!ProfileName|SessionName merged.etl

Flush the loggers in profile ProfileName defined in file ProfileFileName and merge the ETL files to merged.etl. Or flush logger SessionName defined in file ProfileFileName and merge the ETL file to merged.etl. Multiple loggers can be started using multiple -start options, each followed by the options to be applied to that logger. If LoggerName, or -start LoggerName, is omitted, the Kernel Logger is implied. Only a single instance of Kernel Logger can exist at any time. If one of the loggers fails to start, all the already started loggers are stopped.

 

Multiple loggers can be started using multiple -start options, each followed by the options to be applied to that logger. If LoggerName, or -start LoggerName, is omitted, the Kernel Logger is implied. Only a single instance of Kernel Logger can exist at any time. If one of the loggers fails to start, all the already started loggers are stopped.

 

 

Send comments about this topic to Microsoft

Build date: 5/5/2012

Show:
© 2014 Microsoft