Intel® SoC Watch Command-line Tool Options
- The specified run time has elapsed. This occurs only if the--timeoption was included in the command.
- The program has exited. This occurs only if the--programoption was included in the command.
- Ctrl+C was entered.
Basic Command Options
Display text describing tool options and usage.
cpu: CPU C-state and P-State residencies
gfx: Graphics C-state and P-state residencies
device: Device low power state residencies
temp: Core and SoC temperatures
sys: Many system metrics, including the above groups and more.
Specify the features to collect. This option can be use dmultiple times in the same command to collect many features at the same time. See the
Intel SoC Watch User's Guidefor your operating system to learn about feature names for all platforms. Use the
--helpoption to discover features supported for the current platform.
Collect all data available for each specified feature.
Specify a name under which the collection of data files is grouped. If this option is not specified, the default name is
Specify the name of an executable to be started automatically prior to collection. The name can be followed by zero or more arguments that are passed to the program. This option must be specified at the end of the command because everything following the executable name is treated as an argument.
Specify a number of seconds to wait before starting data collection.
Specify the collection duration in seconds.
sum: Generate a summary report of all collected metrics (
int: Generate a trace (timeline) report of all collected metrics (
trace.csv). Use the
-moption with this option.
vtune: Generate a file that can be to be imported into
json: Generate a detail report that can be viewed in Intel System Studio (
Specify the type of result to be generated. This option can be used multiple times in the same command to produce multiple types of reports.
Specify the filename without the file extension of an existing collection. This option is used to generate additional reports for an existing collection.
Detailed reports collected over a long period of time can take several minutes to generate. Do not specify
jsonresult formats with the collection command. If you decide you need that detail after viewing the summary result, use the
--inputoption to generate additional report formats.
socwatch -t 30 -f cpu -f sstate
socwatch -t 30 -f sys -o run1
socwatch -t 60 -f sys -m -r int -o sysDetail/run1
socwatch -t 30 -f sys -r vtune -m -o run1