LTTNG-IOLATENCYTOP-MI(1)

💖 LTTNG-IOLATENCYTOP-MI 💖

okay so bestie, welcome to lttng-iolatencytop-mi — it's a User Command, and it's the LTTng analyses IO latency top machine interface. yes that's a lot of words, no I will not be shortening it, it's giving "my full government name" energy and honestly? respect. 🎀

✨ NAME ✨

lttng-iolatencytop-mi — LTTng analyses IO latency top machine interface 🦋

🌸 DESCRIPTION 🌸

so the way you run this is literally:

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

The I/O command. periodt. 💅

🎀 positional arguments 🎀

• <path/to/trace> — the trace path. that's it, that's the whole thing, it's where your trace lives bestie 🫶

⭐ optional arguments ⭐

• -h, --help — shows this help message and dips. iconic behaviour honestly 💅
• -r REFRESH, --refresh REFRESH — the refresh period, with an optional units suffix (and if you don't give units, it assumes s by default). ✨
• --gmt — manipulate timestamps based on GMT instead of local time. timezone girlies, this one's for you 🌍
• --skip-validation — skip the trace validation. living dangerously, I respect it 😌
• --begin BEGIN — start time, in the format hh:mm:ss[.nnnnnnnnn] ⏰
• --end END — end time, in the format hh:mm:ss[.nnnnnnnnn] ⏰
• --period PERIOD — period definition
• --period-captures PERIOD_CAPTURES — period captures definition
• --period-begin PERIOD_BEGIN — the analysis period start marker event name
• --period-end PERIOD_END — the analysis period end marker event name. heads up: this one requires --period-begin 👀
• --period-begin-key PERIOD_BEGIN_KEY — optional, a list of event field names used to match period markers (default: cpu_id)
• --period-end-key PERIOD_END_KEY — optional, a list of event field names used to match period marker. if you don't specify any, it just uses the same --period-begin-key. matching set, we love consistency 💞
• --period-key-value PERIOD_KEY_VALUE — optional, defines a fixed key value that a period must correspond to in order to be considered
• --cpu CPU — filter the results to only this list of CPU IDs
• --timerange TIMERANGE — time range, written as [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
• --debug — enable debug mode (or you can set the LTTNG_ANALYSES_DEBUG environment variable instead) 🐛
• --no-color — disable colored output. (sad! 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
• --log — output the I/O requests in chronological order 📜
• --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

ok bestie real talk — that is genuinely every single flag, I did not skip one, I would never do that to you 💖 go read your traces, you're doing amazing sweetie

kisses, and this page was brought to you by LTTng Analyses v0.6.0, dated January 2017 — yeah she's a vintage queen but she still slays 🎀✨ bye bestie!!