LTTNG-IOLATENCYFREQ-MI(1)

📦 version 0.6.1, in debian bookworm, ubuntu jammy

💖 lttng-iolatencyfreq-mi — the manual, but make it a group chat 💖

okay bestie so this is lttng-iolatencyfreq-mi, aka the LTTng analyses IO latency frequency machine interface. say that five times fast, I dare you. it's the little command that looks at your trace and tells you how your I/O latencies are actually behaving. slay. ✨

🌸 NAME 🌸

lttng-iolatencyfreq-mi — LTTng analyses IO latency frequency machine interface. yes bestie, that's the whole name, it's giving "I couldn't decide which word to drop so I kept them all" and honestly? iconic. 👑

🦋 DESCRIPTION 🦋

so here's how you call it, no cap:

usage: lttng-iolatencyfreq-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. that's literally what the original says and I refuse to elaborate further. 💅

🎀 positional arguments 🎀

like, the one thing you have to give it:

  • <path/to/trace> — the trace path. hand it over. it's not optional bestie, it's the whole point. 🫶

✨ optional arguments ✨

okay this is the long part, grab a snack, hydrate, we're going in. 💖

  • -h, --help — show this help message and exit. the classic. the comfort option. whenever you're lost, she's there. 🙈
  • -r REFRESH, --refresh REFRESH — refresh period, with an optional units suffix (default units: s). so if you just say 5 it means 5s, got it? ⏱️
  • --gmt — manipulate timestamps based on GMT instead of local time. GMT girlies rise up. 🌍
  • --skip-validation — skip the trace validation. living dangerously, love that for you. 💀
  • --begin BEGIN — start time, formatted like hh:mm:ss[.nnnnnnnnn]. the .nnnnnnnnn is nanosecond-level detail, because we're precise in this house. ⭐
  • --end END — end time, same format: hh:mm:ss[.nnnnnnnnn]. ⭐
  • --period PERIOD — period definition. define your period. 🌸
  • --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 bestie: this one requires --period-begin. you can't end a period you never began, that's just math. 📍
  • --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. symmetrical queen. 🔑
  • --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, written as [begin,end]. brackets and all, don't @ me. ⏳
  • --progress-use-size — use trace size to approximate progress. big trace energy. 📊
  • --no-intersection — disable stream intersection mode. 📴
  • -V, --version — show program's version number and exit. the "who even am I" option. 💅
  • --debug — enable debug mode (or set the LTTNG_ANALYSES_DEBUG environment variable). yes, you can do it with a flag or an env var, choose your fighter. 🐛
  • --no-color — disable colored output. for when your terminal is in its minimalist era. 🌈
  • --no-progress — don't display the progress bar. some of us just want peace. 🕊️
  • --min MIN — filter out durations shorter than min usec. little ones, begone. 📏
  • --max MAX — filter out durations longer than max usec. big ones, also begone. 📏
  • --log — output the I/O requests in chronological order. time-ordered, as the universe intended. 📜
  • --limit LIMIT — limit to top X (default = 10). ten. that's the default. don't forget it. 🔟
  • --top — output the top I/O latencies by category. the leaderboard, basically. 🏆
  • --stats — output the I/O latency statistics. numbers girlies, this one's for you. 📈
  • --freq — output the I/O latency frequency distribution. the main character of this whole program, honestly. 👑
  • --freq-resolution FREQ_RESOLUTION — frequency distribution resolution (default 20). 📐
  • --freq-uniform — use a uniform resolution across distributions. consistent. reliable. 🧚
  • --freq-series — consolidate frequency distribution histogram as a single one. one histogram to rule them all. 🔥
  • --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. 🧵
🫶 real talk bestie: that --period-end one needs --period-begin or it's not happening. that's the only gotcha here and I'm telling you up front so you don't text me at 2am. 💖

🌈 SEE ALSO 🌈

...okay so there's genuinely nothing listed here in the original, which is giving "I'm an only child." no cross-references, no siblings. just vibes. 🦋

and that's the whole page, bestie!! you ate. periodt. 💅✨

this was LTTng Analyses v0.6.0, dated January 2017 — yeah she's a vintage icon, a classic, timeless. 👑💖

📦 where this page comes from