Skip to content

toplev CSV output fields

Andi Kleen edited this page Oct 21, 2020 · 1 revision

Standard output -o output with -x, (CSV mode)

Column Optional Description
Timestamp (optional) Time stamp in seconds relative to measurement start (with -Ixxx)
CPUs - CPUs this applies too. This can be a Socket (Sx) or a core (Cx) or a thread Tx, or a combination of those (Sx-Cx-Tx). Not output with --single-thread
Area toplev node or metric that is being reported
Unit Unit of the measurement. % means it's a ratio in percent, optionally followed by another unit. Slots is pipeline slots defined by the pipeline width (see the TopDown paper for more details)
Description (optional) Description of the node or metric. Usually only printed once. Can be more verbose with --long-desc
Sample (optional) List of sample events that can be used to sample for the particular bottleneck
Stddev (optional) Only with -rX for perf rerunning measurements. Report the standard deviation of the results over the reruns.
Multiplex (optional) Multiplex ratio. When perf has to multiplex the measurements because it needs more performance counters than available this reports the percentage the group(s) measuring the events were active.
Bottleneck (optional) Contains <== if the node is the critical bottleneck for the given thread and time interval, otherwise empty.
Idle (optional) Contains Y if the CPU appears to be idle (normally less than 5% of the busiest CPU), so could be ignored.

Note that for further processing it can be useful to run the data through interval-normalize. This will put each event into its own column. --xnormal supports this automatically in a separate tab of the xlsx sheet.

ValCSV output --valcsv FILE

Lower level output format containing the counter values

Column Description
Timestamp Timestamp in seconds relative to measurement start
CPU Linux CPU number
Group Number of measurement group
Event Name of the measurement perfmon event
Value Measured value for interval
Perf-event Event in perf format
Index Index number of measured event
STDDEV Standard deviation of measurement (only with -rX)
MULTI Multiplex ratio (see above)
Nodes Names of all nodes or metrics that use the measured value for their computations

Raw perf output --perf-output FILE

This is the raw perf stat output. See the man perf-stat manpage for details on the fields.