ZPOOL-IOSTAT-VIZ(1)

📦 version 2021-11, in nixos 26.05, nixpkgs unstable

💅 ZPOOL-IOSTAT-VIZ 💅

Okay bestie, so you know how zpool(8) can show you latency if you run it as zpool -r? Well this iconic little tool, zpool-iostat-viz, is here to make that data actually make sense. It's giving intuitive, it's giving readable, it's giving main character energy. ✨

🌸 SYNOPSIS 🌸

zpool-iostat-viz [-d, --diff] [--by d|m] [-f file, --from-file file]
                 [--pt palette, --pal-time palette]
                 [--pc palette, --pal-count palette] [--digits]
                 [--symbols] [--help-colors] [parts ...]

🦋 DESCRIPTION 🦋

So like, zpool-iostat-viz displays ZFS pool latency info in a way that's so much more intuitive than running zpool(8) as zpool -r. Think of it as a glow-up for your latency data. 💖

The vibes? Latency information is shown in a matrix — shorter latency times up at the top, longer times down at the bottom, and columns for whatever pools you picked or the devices those pools are made of. It's literally so organized. 👑

  • --by d|m — Slice the data by device (--by d) or by measurement (--by m). Then use the ← and → arrow keys on your keyboard to flip between the available screens. So easy. 🎀
  • -d, --diff — Shows the histogram for 3 seconds intervals instead of counts cumulated over the run-time of the program. And get this — you can adjust the sampling period with the ↑ and ↓ arrow keys. Iconic. 🔥
  • --digits — Uses ".0123456789#" as histogram values. Numbers, but make it fancy. 🔢
  • -f file, --from-file file — Reads values from a file that contains the output of:
zpool iostat -wvHp

So you can be like "bestie I already have the data" and this tool is like "say less." 💅

  • --help-colors — Lists all the available color palettes for the --pc and --pt options. Because sometimes you just need to see your options, y'know? 🌈
  • --pt palette, --pal-time palette — Selects a color palette for displaying the time buckets. Time to make it cute. ⏰
  • --pc palette, --pal-count palette — Selects a color palette for displaying the bucket populations. (Yes, the original says "populationss" with the extra s — we don't fix typos here, we preserve them. It's called archival accuracy, bestie. 📚)
  • --symbols — Uses " .:;*#" as histogram values. For when you want your data to look like a lil piece of art. 🎨
  • parts — Selects parts or vdevs to display. By default? Everything. All devices (including cache and ZIL devices), the logical elements the pools consist of (mirror, raidz1, ...), and all pools are displayed. No cap, it shows you the whole squad. 👯‍♀️

💀 EXIT STATUS 💀

The zpool-iostat-viz program always returns an exit status of 0. Like, it literally cannot fail. It's just that confident. Periodt. ✨

🍓 EXAMPLES 🍓

Here's what typical usage looks like, bestie:

zpool-iostats-viz -d

zpool-iostats-viz --by d --symbols tank

(Yes, the example says zpool-iostats-viz with an extra s and the command is zpool-iostat-viz — we're keeping it exactly as the original wrote it. Historical accuracy, iykyk. 🫶)

👑 SEE ALSO 👑

zpool(8) — go check it out, it's the OG.

🧚 AUTHORS 🧚

The zpool-iostat-viz program was written by Chad Miller <chad@cornsilk.net>. Shoutout to Chad for this absolute gift to the ZFS community. 🙌

And that's the whole vibe, bestie! This page is from the Debian manual, dated November, 6 2021 — so like, a little vintage but still slaying. Go forth and visualize those latencies. You got this. 💖✨🎀🦋💅

📦 where this page comes from