LTTNG-SCHEDSTATS-MI(1)

🎀 NAME 🎀

lttng-schedstats-mi — bestie, it's the LTTng analyses Scheduler statistics machine interface. iykyk. 💖

✨ DESCRIPTION ✨

okay so literally what this does: you feed it a trace, and it gives you the scheduler tea. here's the whole vibe, usage style:

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>

and the whole point of it? The sched command. that's it, that's the mission. 🫶

🦋 positional arguments 🦋

• <path/to/trace> — the trace path, bestie. hand over the trace and let's go. 💅

🌸 optional arguments 🌸

• -h, --help — show this help message and exit. classic, iconic, always there for you.
• -r REFRESH, --refresh REFRESH — refresh period, with an optional units suffix (default units: s). no cap.
• --gmt — manipulate timestamps based on GMT instead of local time. timezone moment. 🌍
• --skip-validation — skip the trace validation. living dangerously, love that for you.
• --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). yes it needs its partner, they're a package deal. 🫶
• --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. it just copies its bestie's notes fr fr.
• --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). spill the tea, program.
• --no-color — disable colored output. (sad, honestly. but valid.)
• --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. obsessed. 📊
• --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. main character energy only. 👑
• --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).

that's the whole page bestie, every flag accounted for, nothing skipped, no crumbs left. 💜

LTTng Analyses v0.6.0 — January 2017 — LTTNG-SCHEDSTATS-MI(1) 🎀✨🦋 that's a wrap, periodt. 💅