LTTNG-IOUSAGETOP-MI(1)

📦 version 0.6.1, in debian bookworm, ubuntu jammy

💅 LTTNG-IOUSAGETOP-MI 💅

okay bestie, so this is lttng-iousagetop-mi — it's a User Commands situation, and it's the LTTng analyses IO usage top machine interface. yeah. say that five times fast. 🦋

✨ NAME ✨

lttng-iousagetop-mi — LTTng analyses IO usage top machine interface

🌸 SYNOPSIS 🌸

usage: lttng-iousagetop-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. 👑

🎀 DESCRIPTION 🎀

It's the I/O command. That's the vibe, that's the whole thing. You point it at a trace, it gives you the top I/O tea. 💖

🧚 POSITIONAL ARGUMENTS 🧚

  • <path/to/trace> — the trace path. yeah. that's where your trace lives. point at it. 👉

💜 OPTIONAL ARGUMENTS 💜

  • -h, --help — show this help message and exit. classic. the escape hatch. 🚪
  • -r REFRESH, --refresh REFRESH — Refresh period, with optional units suffix (default units: s). so if you don't say a unit, it's gonna assume seconds, bestie. ⏱️
  • --gmt — Manipulate timestamps based on GMT instead of local time. no timezone drama, just GMT. 🌍
  • --skip-validation — Skip the trace validation. living dangerously, i respect it. 🙈
  • --begin BEGIN — start time: hh:mm:ss[.nnnnnnnnn]. the beginning of the story. 🌅
  • --end END — end time: hh:mm:ss[.nnnnnnnnn]. and that's the end of the story. 🌇
  • --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). so like, if you want the end you gotta have the beginning. it's giving narrative structure. 📖
  • --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 the vibe from the begin one. 🪞
  • --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 faves. 💅
  • --timerange TIMERANGE — time range: [begin,end]
  • --progress-use-size — use trace size to approximate progress. it's an estimate, not a promise. 📏
  • --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 there's an env var for that, go off. 🐛
  • --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. short king erasure. 😭
  • --max MAX — Filter out durations longer than max usec.
  • --log — Output the I/O requests in chronological order. timeline mode. 📜
  • --limit LIMIT — Limit to top X (default = 10). the classic top ten. 🏆
  • --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. one chart to rule them all. 📊
  • --usage — Output the I/O usage.
  • --minsize MINSIZE — Filter out, I/O operations working with less that minsize bytes. (yes, "less that", it's in the original, i'm not touching it, i don't make the rules 💀)
  • --maxsize MAXSIZE — Filter out, I/O operations working with more that maxsize bytes. (same deal, bestie 🫶)
ngl there are a LOT of flags here and that's lowkey iconic of them. every single one stayed. no cap. 💯

LTTng Analyses v0.6.0 · January 2017 — mwah, that's the version and the date, signed sealed delivered, ty for coming to my ted talk 🎀✨💖

📦 where this page comes from