x86/turbostat/turbostat.8

3 turbostat \- Report processor frequency and idle statistics
12 .RB [ "\--interval seconds" ]
15 idle power-state statistics, temperature and power on X86 processors.
19 in one-shot upon its completion.
22 The 5-second interval can be changed using the --interval option.
26 Options can be specified with a single or double '-', and only as much of the option
27 name as necessary to disambiguate it from others is necessary.  Note that options are case-sensitiv…
29 \fB--add attributes\fP add column with counter having specified 'attributes'.  The 'location' attri…
41 		MSRs are read as 64-bits, u32 truncates the displayed value to 32-bits.
51 		Any string that does not match a key-word above is used
55 …--cpu cpu-set\fP limit output to system summary plus the specified cpu-set.  If cpu-set is the str…
57 …fB--hide column\fP do not show the specified built-in columns.  May be invoked multiple times, or …
59 \fB--enable column\fP show the specified built-in columns, which are otherwise disabled, by default…
60 The column name "all" can be used to enable all disabled-by-default built-in counters.
62 \fB--show column\fP show only the specified built-in columns.  May be invoked multiple times, or wi…
64 \fB--Dump\fP displays the raw counter values.
66 \fB--quiet\fP Do not decode and print the system configuration header information.
68 \fB--interval seconds\fP overrides the default 5.0 second measurement interval.
70 \fB--num_iterations num\fP number of the measurement iterations.
72 \fB--out output_file\fP turbostat output is written to the specified output_file.
75 \fB--help\fP displays usage for the most common parameters.
77 \fB--Joules\fP displays energy in Joules, rather than dividing Joules by time to print power in Wat…
79 \fB--list\fP display column header names available for use by --show and --hide, then exit.
81 \fB--Summary\fP limits output to a 1-line System Summary for each interval.
83 …--TCC temperature\fP sets the Thermal Control Circuit temperature for systems which do not export …
85 \fB--version\fP displays the version.
91 …--quiet is not used) is followed by statistics.  The first row of the statistics labels the conten…
94 …on, including thread migration -- if any.  This counter is disabled by default, and is enabled wit…
95 …s column is disabled by default, and can be enabled with "--enable Time_Of_Day_Seconds" or "--debu…
96 …umber.  Note that multiple CPUs per core indicate support for Intel(R) Hyper-Threading Technology …
97 …it is okay that on many systems the CPUs are not listed in numerical order -- for efficiency reaso…
98 \fBPackage\fP processor package number -- not present on systems with a single processor package.
99 \fBAvg_MHz\fP number of cycles executed divided by time elapsed.  Note that this includes idle-time…
101 \fBBzy_MHz\fP average clock rate while the CPU was not idle (ie. in "c0" state).
104 …ced CPU during the measurement interval.  While this counter is actually per-CPU, SMI are triggere…
105 …idle state during the measurement interval.  The system summary line shows the sum for all CPUs.  …
107 \fBCPU%c1, CPU%c3, CPU%c6, CPU%c7\fP show the percentage residency in hardware core idle states.  T…
108 \fBCoreTmp\fP Degrees Celsius reported by the per-core Digital Thermal Sensor.
109 \fBPkgTmp\fP Degrees Celsius reported by the per-package Package Thermal Monitor.
112 \fBPkg%pc2, Pkg%pc3, Pkg%pc6, Pkg%pc7\fP percentage residency in hardware package idle states.  The…
115 \fBGFXWatt\fP Watts consumed by the Graphics part of the package -- available only on client proces…
116 \fBRAMWatt\fP Watts consumed by the DRAM DIMMS -- available only on server processors.
117 …-package system.  Note that the meaning of this field is model specific.  For example, some hardwa…
121 By default, turbostat dumps all possible information -- a system configuration header, followed by …
122 This is ideal for remote debugging, use the "--out" option to save everything to a text file, and g…
124 …--quiet" option will skip the configuration information, and turbostat will show only the counter …
126 … for --show and --hide, the "--list" option is available.  For convenience, the special strings "s…
128 sudo ./turbostat --show sysfs --quiet sleep 10
146 Output can instead be saved to a file using the --out option.
150 [root@hsw]# ./turbostat -o ts.out sleep 10
156 Periodic output goes to stdout, by default, unless --out is used to specify an output file.
157 The 5-second interval can be changed with the "-i sec" option.
159 sudo ./turbostat --quiet --hide sysfs,IRQ,SMI,CoreTmp,PkgTmp,GFX%rc6,GFXMHz,PkgWatt,CorWatt,GFXWatt
161 	-	-	488	12.52	3900	3498	12.50	0.00	0.00	74.98
171 	-	-	491	12.59	3900	3498	12.42	0.00	0.00	74.99
181 This example also shows the use of the --hide option to skip columns that are not wanted.
184 because its cpu4's activity on shared hardware keeps it from entering a deeper C-state.
189 before taking measurements.  In the example above, "--quiet" is used
192 turbostat version 2017.02.15 - Len Brown <lenb@kernel.org>
194 CPUID(1): SSE3 MONITOR - EIST TM2 TSC MSR ACPI-TM TM
195 CPUID(6): APERF, TURBO, DTS, PTM, No-HWP, No-HWPnotify, No-HWPwindow, No-HWPepp, No-HWPpkg, EPB
196 cpu4: MSR_IA32_MISC_ENABLE: 0x00850089 (TCC EIST No-MWAIT PREFETCH TURBO)
197 CPUID(7): No-SGX
198 cpu4: MSR_MISC_PWR_MGMT: 0x00400000 (ENable-EIST_Coordination DISable-EPB DISable-OOB)
203 cpu4: MSR_IA32_POWER_CTL: 0x0004005d (C1E auto-promotion: DISabled)
214 …R_PKG_CST_CONFIG_CONTROL: 0x1e000400 (UNdemote-C3, UNdemote-C1, demote-C3, demote-C1, UNlocked: pk…
215 cpu4: POLL: CPUIDLE CORE POLL IDLE
221 cpu4: MSR_MISC_FEATURE_CONTROL: 0x00000000 (L2-Prefetch L2-Prefetch-pair L1-Prefetch L1-IP-Prefetch)
223 …E_PERF_LIMIT_REASONS, 0x31200000 (Active: ) (Logged: Transitions, MultiCoreTurbo, Amps, Auto-HWP, )
227 cpu0: MSR_PKG_POWER_INFO: 0x000002a0 (84 W TDP, RAPL 0 - 0 W, 0.000000 sec.)
239 cpu0: MSR_IA32_THERM_STATUS: 0x884c0000 (24 C +/- 1)
240 cpu1: MSR_IA32_THERM_STATUS: 0x88510000 (19 C +/- 1)
241 cpu2: MSR_IA32_THERM_STATUS: 0x884e0000 (22 C +/- 1)
242 cpu3: MSR_IA32_THERM_STATUS: 0x88510000 (19 C +/- 1)
249 frequency of the processor -- this should match the brand string
253 depending on the number of idle cores.  Note that not all information is
256 Here we limit turbostat to showing just the CPU number for cpu0 - cpu3.
257 We add a counter showing the 32-bit raw value of MSR 0x199 (MSR_IA32_PERF_CTL),
261 sudo ./turbostat --quiet --cpu 0-3 --show CPU --add msr0x199,u32,raw,PRF_CTRL sleep .1
264 -	0x00000000
274 For interval-mode, turbostat will immediately end the current interval
277 Control-C will be send a SIGINT to turbostat,
281 SIGINT will interrupt interval-mode.
282 The end-of-interval data will be collected and displayed before turbostat exits.
285 end-of-interval data will be collected and displayed before turbostat
291 Alternatively, non-root users can be enabled to run turbostat this way:
303 may work poorly on Linux-2.6.20 through 2.6.29,
304 as \fBacpi-cpufreq \fPperiodically cleared the APERF and MPERF MSRs
308 number of elapsed cycles divided by the entire sample interval --
309 including idle time.  Note that this calculation is resilient
310 to systems lacking a non-stop TSC.
316 the TSC stops in idle, TSC_MHz will drop
332 The APERF, MPERF MSRs are defined to count non-halted cycles.