iotop

This article is a stub. Please help out by expanding it - how to get started.

Resources

iotop is a top-like utility that monitors system input/output.

Installation

Kernel

The CONFIG_TASK_IO_ACCOUNTING variable must be enabled in the Linux kernel for the iotop command to work properly. It can be found at this location:

KERNEL Kernel configuration for iotop

General setup -> CPU/Task time and stats accounting

  [*]   Enable per-task delay accounting Search for <code>CONFIG_TASK_DELAY_ACCT</code> to find this item.
  [*]   Enable extended accounting over taskstats Search for <code>CONFIG_TASK_XACCT</code> to find this item.
  [*]     Enable per-task storage I/O accounting Search for <code>CONFIG_TASK_IO_ACCOUNTING</code> to find this item.
  [*] Enable VM event counters for /proc/vmstat (EXPERT)

Additionally, "delayacct" must be added to the kernel command-line such as GRUB_CMDLINE_LINUX for grub.

Emerge

Install the package:

root #emerge --ask sys-process/iotop

Usage

Invocation

root #iotop --help

Expand

Usage: iotop [OPTIONS]

DISK READ and DISK WRITE are the block I/O bandwidth used during the sampling
period. SWAPIN and IO are the percentages of time the thread spent respectively
while swapping in and waiting on I/O more generally. PRIO is the I/O priority at
which the thread is running (set using the ionice command).

Controls: left and right arrows to change the sorting column, r to invert the
sorting order, o to toggle the --only option, p to toggle the --processes
option, a to toggle the --accumulated option, i to change I/O priority, q to
quit, any other key to force a refresh.

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -o, --only            only show processes or threads actually doing I/O
  -b, --batch           non-interactive mode
  -n NUM, --iter=NUM    number of iterations before ending [infinite]
  -d SEC, --delay=SEC   delay between iterations [1 second]
  -p PID, --pid=PID     processes/threads to monitor [all]
  -u USER, --user=USER  users to monitor [all]
  -P, --processes       only show processes, not all threads
  -a, --accumulated     show accumulated I/O instead of bandwidth
  -k, --kilobytes       use kilobytes instead of a human friendly unit
  -t, --time            add a timestamp on each line (implies --batch)
  -q, --quiet           suppress some lines of header (implies --batch)

External resources