LTTNG-SCHEDLOG(1)

💖 NAME 💖

lttng-schedlog — LTTng analyses Scheduler log. bestie this is the sched one, the scheduler log reader, and she is thriving ✨

🦋 DESCRIPTION 🦋

okay so real talk, here's how you call her:

lttng-schedlog [-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. that's the whole vibe, that's what she does 💅

🎀 positional arguments 🎀

• <path/to/trace> — the trace path, aka where your data lives, bestie. point her at it and she'll do the rest 🫶

✨ optional arguments ✨

• -h, --help — show this help message and exit. classic, iconic, never fails you 💖
• -r REFRESH, --refresh REFRESH — Refresh period, with an optional units suffix (default units: s) ⏰
• --gmt — Manipulate timestamps based on GMT instead of local time. timezone girlies rise 🌍
• --skip-validation — Skip the trace validation. living dangerously, we respect it 🙈
• --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. heads up: this one requires --period-begin, she will not go alone 👑
• --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 the LTTNG_ANALYSES_DEBUG environment variable) 🐛
• --no-color — Disable colored output. sad beige mode, no thank u 🎀
• --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)

ngl the flag list is long but she's just thorough, ok? not a red flag, it's a green one 🌈

LTTng Analyses v0.6.0, January 2017 — mwah, love that for her, periodt 💜✨