---
name: "lttng-schedstats-mi"
section: "1"
platform: "linux"
package: "python3-lttnganalyses"
version: "0.6.1-3"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/lttng-schedstats-mi"
---

# lttng-schedstats-mi(1)

LTTng analyses Scheduler statistics machine interface

## NAME

lttng-schedstats-mi - LTTng analyses Scheduler statistics machine interface

## DESCRIPTION

usage: lttng-schedstats-mi \[-h\] \[-r REFRESH\] \[--gmt\] \[--skip-validation\]

- \[--begin BEGIN\] \[--end END\] \[--period PERIOD\]

  \[--period-captures PERIOD\_CAPTURES\] \[--period-begin PERIOD\_BEGIN\] \[--period-end PERIOD\_END\] \[--period-begin-key PERIOD\_BEGIN\_KEY\] \[--period-end-key PERIOD\_END\_KEY\] \[--period-key-value PERIOD\_KEY\_VALUE\] \[--cpu CPU\] \[--timerange TIMERANGE\] \[--progress-use-size\] \[--no-intersection\] \[-V\] \[--debug\] \[--no-color\] \[--no-progress\] \[--min MIN\] \[--max MAX\] \[--procname PROCNAME\] \[--tid TID\] \[--freq\] \[--freq-resolution FREQ\_RESOLUTION\] \[--freq-uniform\] \[--freq-series\] \[--limit LIMIT\] \[--top\] \[--log\] \[--stats\] \[--total\] \[--per-tid\] \[--per-prio\] \<path/to/trace\>

The sched command.

### positional arguments:

- \<path/to/trace\>

  trace path

### optional arguments:

- **-h**, **--help**

  show this help message and exit

- **-r** REFRESH, **--refresh** REFRESH

  Refresh period, with optional units suffix (default units: s)

- **--gmt**

  Manipulate timestamps based on GMT instead of local time

- **--skip-validation**

  Skip the trace validation

- **--begin** BEGIN

  start time: hh:mm:ss\[.nnnnnnnnn\]

- **--end** END

  end time: hh:mm:ss\[.nnnnnnnnn\]

- **--period** PERIOD

  Period definition

- **--period-captures** PERIOD\_CAPTURES

  Period captures definition

- **--period-begin** PERIOD\_BEGIN

  Analysis period start marker event name

- **--period-end** PERIOD\_END

  Analysis period end marker event name (requires **--period-begin**)

- **--period-begin-key** PERIOD\_BEGIN\_KEY

  Optional, list of event field names used to match period markers (default: cpu\_id)

- **--period-end-key** PERIOD\_END\_KEY

  Optional, list of event field names used to match period marker. If none specified, use the same **--period-begin-key**

- **--period-key-value** PERIOD\_KEY\_VALUE

  Optional, define a fixed key value to which a period must correspond to be considered.

- **--cpu** CPU

  Filter the results only for this list of CPU IDs

- **--timerange** TIMERANGE

  time range: \[begin,end\]

- **--progress-use-size**

  use trace size to approximate progress

- **--no-intersection**

  disable stream intersection mode

- **-V**, **--version**

  show program's version number and exit

- **--debug**

  Enable debug mode (or set LTTNG\_ANALYSES\_DEBUG environment variable)

- **--no-color**

  Disable colored output

- **--no-progress**

  Don't display the progress bar

- **--min** MIN

  Filter out durations shorter than min usec

- **--max** MAX

  Filter out durations longer than max usec

- **--procname** PROCNAME

  Filter the results only for this list of process names

- **--tid** TID

  Filter the results only for this list of TIDs

- **--freq**

  Output the frequency distribution of sched switch latencies

- **--freq-resolution** FREQ\_RESOLUTION

  Frequency distribution resolution (default 20)

- **--freq-uniform**

  Use a uniform resolution across distributions

- **--freq-series**

  Consolidate frequency distribution histogram as a single one

- **--limit** LIMIT

  Limit to top X (default = 10)

- **--top**

  Output the top sched switch latencies

- **--log**

  Output the sched switches in chronological order

- **--stats**

  Output sched switch statistics

- **--total**

  Group all results (applies to stats and freq)

- **--per-tid**

  Group results per-TID (applies to stats and freq) (default)

- **--per-prio**

  Group results per-prio (applies to stats and freq)