biopattern(8)

πŸ“¦ version 0.36.1, in alpine 3.24, nixpkgs unstable, opensuse-leap 16.0

✨ biopattern(8) β€” System Manager's Manual ✨

πŸ’– NAME

biopattern - Identify random/sequential disk access patterns. πŸ¦‹

πŸ“ SYNOPSIS

biopattern [-h] [-d DISK] [interval] [count]

🌸 DESCRIPTION

okay so bestie, this one traces block device I/O (aka disk I/O) and spits out the ratio of random vs sequential I/O πŸ’… for each disk, or just the specified disk if you ask for one. You get the summary either when you hit Ctrl-C or after a given interval in seconds ✨

this works by tracing the kernel tracepoint block:block_rq_complete πŸ”₯

heads up πŸ’€ since this uses BPF, only the root user can use this tool. no cap, you need to be root.

πŸŽ€ REQUIREMENTS

you'll need CONFIG_BPF and bcc 🫢

✨ OPTIONS ✨

  • -h β€” show the help message and exit πŸ’œ
  • -d β€” trace this disk only 🎯
  • interval β€” print output every interval seconds, if any 🌈
  • count β€” number of interval summaries πŸ“

🧚 EXAMPLES

trace access patterns of all disks, and print a summary on Ctrl-C:

# biopattern

trace disk sdb only:

# biopattern -d sdb

print 1 second summaries, 10 times:

# biopattern 1 10

πŸ‘‘ FIELDS

  • TIME β€” time of the output, in HH:MM:SS format ⭐
  • DISK β€” disk device name πŸ’–
  • %RND β€” ratio of random I/O 🌸
  • %SEQ β€” ratio of sequential I/O πŸ¦‹
  • COUNT β€” number of I/O during the interval πŸ”₯
  • KBYTES β€” total Kbytes for these I/O, during the interval πŸ’…

🫧 OVERHEAD

block device I/O usually has a relatively low frequency (< 10,000/s), so the overhead for this tool is expected to be low or negligible. ngl, for high IOPS storage systems, test and quantify before use πŸ™ˆ

🌈 SOURCE

this is from bcc πŸ’œ

https://github.com/iovisor/bcc

also look in the bcc distribution for a companion _examples.txt file containing example usage, output, and commentary for this tool πŸŽ€

πŸ’… OS

Linux 🐧

⚠️ STABILITY

Unstable - in development πŸ™ˆ

πŸ’« AUTHOR

Rocky Xing ✨

πŸ¦‹ SEE ALSO

biosnoop(8), biolatency(8), iostat(1) 🫢


bye bestie, that's the whole tea β˜•πŸŒΈ biopattern(8) from the bcc crew, last updated 2022-02-21, under USER COMMANDS πŸ’– stay iconic 🧚✨