LTTNG-SCHEDTOP-MI(1)

📦 version 0.6.1, in debian bookworm, ubuntu jammy

💖 LTTNG-SCHEDTOP-MI 💖

okay bestie, so this one is from the LTTng analyses family — it's the Scheduler top machine interface, aka the thing that stares at your scheduler and tells you which sched switches are being dramatic. the manual page name is LTTNG-SCHEDTOP-MI(1), lowercase the vibes, uppercase the importance. let's get into it 🦋

✨ NAME ✨

lttng-schedtop-mi — LTTng analyses Scheduler top machine interface 💅

🌸 DESCRIPTION 🌸

here's how you run it, fr fr:

usage: lttng-schedtop-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 like, it's the sched command. that's literally what it says. iconic. ✨

🎀 positional arguments 🎀

  • <path/to/trace> — the trace path, bestie. point it at your trace. that's the whole job. 🫶

💅 optional arguments 💅

  • -h, --help — shows this help message and then dips. exits, babes. 👋
  • -r REFRESH, --refresh REFRESH — how often to refresh, with an optional units suffix. default units are s (seconds). ⏱️
  • --gmt — manipulate timestamps based on GMT instead of local time. timezone girlies rise 🕰️
  • --skip-validation — skip the trace validation. bold move, but okay 😭
  • --begin BEGIN — start time, formatted hh:mm:ss[.nnnnnnnnn]
  • --end END — end time, formatted 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, no cap)
  • --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, it uses 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, formatted [begin,end]
  • --progress-use-size — use trace size to approximate progress 📏
  • --no-intersection — disable stream intersection mode
  • -V, --version — show the program's version number and exit. flex the version, queen 👑
  • --debug — enable debug mode (or set the LTTNG_ANALYSES_DEBUG environment variable) 🐛
  • --no-color — disable colored output. no 🌈 for you, sad!
  • --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) — this is the default
  • --per-prio — group results per-prio (applies to stats and freq)
ok so lowkey important: --period-end requires --period-begin. don't come for me, that's just what the page says 💀

that's the whole thing, bestie. go forth and sched-top your little heart out. no cap, this is genuinely useful. periodt. 💖✨🎀

LTTng Analyses v0.6.0 — January 2017 🦋 sending u this from the archive, love u, bye!! 🌸

📦 where this page comes from