LTTNG-IOLATENCYTOP(1)

💅 LTTNG-IOLATENCYTOP 💅

okay bestie, gather round, because this is lttng-iolatencytop — the LTTng analyses IO latency top tool, living in the User Commands section of your manual, and she is serving.

✨ NAME ✨

lttng-iolatencytop — LTTng analyses IO latency top. that's it, that's the whole vibe. the I/O command. 🦋

🌸 DESCRIPTION 🌸

so the usage goes a little something like this, and yes you're gonna want to read the whole thing because there are so many flags:

usage: lttng-iolatencytop [-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] [--log]
       [--limit LIMIT] [--top] [--stats] [--freq] [--freq-resolution
       FREQ_RESOLUTION] [--freq-uniform] [--freq-series] [--usage]
       [--minsize MINSIZE] [--maxsize MAXSIZE] <path/to/trace>

🎀 positional arguments 🎀

• <path/to/trace> — the trace path, babe. that's where your trace lives. point her at it. 👑

🧚 optional arguments 🧚

• -h, --help — shows this help message and then dips. show this help message and exit. iconic behaviour honestly.
• -r REFRESH, --refresh REFRESH — Refresh period, with optional units suffix (default units: s). so if you don't say a unit she's gonna assume seconds, periodt.
• --gmt — Manipulate timestamps based on GMT instead of local time. timezone girlie hours 🌍
• --skip-validation — Skip the trace validation. no vibe check for the trace today, we trust her 🙈
• --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). yeah she's not optional-optional, you need the begin one too, 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, use the same --period-begin-key. she's a copycat and we love that for her 💖
• --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. pick your fave cores 💅
• --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). yes bestie there's an env var, go off 🌈
• --no-color — Disable colored output. (sad, but sometimes you need plain text, we get it)
• --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
• --log — Output the I/O requests in chronological order. chronological order?? she's so organized ✨
• --limit LIMIT — Limit to top X (default = 10)
• --top — Output the top I/O latencies by category
• --stats — Output the I/O latency statistics
• --freq — Output the I/O latency frequency distribution
• --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
• --usage — Output the I/O usage
• --minsize MINSIZE — Filter out, I/O operations working with less that minsize bytes
• --maxsize MAXSIZE — Filter out, I/O operations working with more that maxsize bytes

🫶 quick reminder bestie: --period-end literally will not work without --period-begin. don't come crying to me, come crying to the manpage, because it said it first.

and that's the whole page!! every single flag, argument, default, env var and path accounted for, nothing skipped, nothing invented, fr fr. 💜

this was LTTng Analyses v0.6.0, dated January 2017 — a whole legend from the LTTng Analyses era, still out here doing IO latency top things. mwah. 💋 🎀 🦋 ⭐ 💖