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.
21 and turbostat displays statistics every 5 seconds interval.
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.
46 		'delta' shows the difference in values during the measurement interval.
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 \fB--TCC temperature\fP sets the Thermal Control Circuit temperature for systems which do not expor…
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 …he measurement interval were collected.  This column is disabled by default, and can be enabled wi…
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…
100 \fBBusy%\fP percent of the measurement interval that the CPU executes instructions, aka. % of time …
102 \fBTSC_MHz\fP average MHz that the TSC ran during the entire interval.
103 \fBIRQ\fP The number of interrupts serviced by that CPU during the measurement interval.  The syste…
104 …ment Interrupts  serviced CPU during the measurement interval.  While this counter is actually per…
105 …interval.  The system summary line shows the sum for all CPUs.  These are C-state names as exporte…
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.
110 …f time the GPU is in the "render C6" state, rc6, during the measurement interval. From /sys/class/…
111 \fBGFXMHz\fP Instantaneous snapshot of what sysfs presents at the end of the measurement interval. …
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 …interval that RAPL throttling was active on the Package.  Note that the system summary is the sum …
118 \fBRAM_%\fP percent of the interval that RAPL throttling was active on DRAM.
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
154 .SH PERIODIC INTERVAL EXAMPLE
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
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
276 turbostat will then start the next 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.
284 SIGUSR1 will end current interval,
285 end-of-interval data will be collected and displayed before turbostat
286 starts a new interval.
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 --
310 to systems lacking a non-stop TSC.
332 The APERF, MPERF MSRs are defined to count non-halted cycles.