LTTNG-IOLATENCYFREQ(1)

💅 NAME 💅

lttng-iolatencyfreq — it's the LTTng analyses girlie that does your I/O latency frequency, bestie. She's literally built for it.

🌸 DESCRIPTION 🌸

okay so the way you run her is like this, no cap:

usage: lttng-iolatencyfreq [-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>

and yeah — it's the I/O command. that's the whole vibe. ✨

📍 positional arguments

• <path/to/trace> — the trace path. like, where your trace is living. point her at it. 🫶

✨ optional arguments

• -h, --help — show this help message and exit. the classic. she'll tell you what's up and then dip. 👑
• -r REFRESH, --refresh REFRESH — Refresh period, with an optional units suffix. default units are s (seconds, bb). 💖
• --gmt — manipulate timestamps based on GMT instead of local time. timezone girlie behavior. 🌍
• --skip-validation — Skip the trace validation. living dangerously, love that for you. 🙈
• --begin BEGIN — start time, formatted like hh:mm:ss[.nnnnnnnnn]. ⏰
• --end END — end time, also 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 bestie: this one requires --period-begin to be there too.
• --period-begin-key PERIOD_BEGIN_KEY — Optional: list of event field names used to match period markers. default is cpu_id. 🎀
• --period-end-key PERIOD_END_KEY — Optional: list of event field names used to match period marker. if you don't specify any, she just uses the same --period-begin-key. recycling is iconic. ♻️
• --period-key-value PERIOD_KEY_VALUE — Optional: define a fixed key value that a period must correspond to in order to be considered.
• --cpu CPU — Filter the results only for this list of CPU IDs. cpu girlies only. 💻
• --timerange TIMERANGE — time range, written as [begin,end]. 📅
• --progress-use-size — use trace size to approximate progress. approximation is a lifestyle. 📏
• --no-intersection — disable stream intersection mode. turning it OFF, periodt. 🚫
• -V, --version — show program's version number and exit. she'll tell you her age. 💅
• --debug — Enable debug mode. you can also just set the LTTNG_ANALYSES_DEBUG environment variable instead, if that's more your thing. 🐛
• --no-color — Disable colored output. 🎨 no fun allowed mode (jk jk, some terminals need it).
• --no-progress — Don't display the progress bar. 🚫📊
• --min MIN — Filter out durations shorter than min usec. tiny things, begone. 🧚
• --max MAX — Filter out durations longer than max usec. bye slowpokes. 🐌
• --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. ranking szn. 🏆
• --stats — Output the I/O latency statistics. numbers, my beloved. 📈
• --freq — Output the I/O latency frequency distribution. the main character of this whole manpage tbh. 👑
• --freq-resolution FREQ_RESOLUTION — Frequency distribution resolution. default is 20. 🔍
• --freq-uniform — Use a uniform resolution across distributions. consistency ate. ⚖️
• --freq-series — Consolidate the 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 than minsize bytes. 📉
• --maxsize MAXSIZE — Filter out I/O operations working with more than maxsize bytes. 📈

lowkey reminder bestie: that's literally every single flag she has. nothing skipped, nothing invented. iykyk. 💖

and that's the page!! this was LTTng Analyses v0.6.0, dated January 2017 — yeah she's a 2017 girlie and she still eats. mwah, love u, go analyze some I/O latency. 🎀💜🦋✨