---
name: "seekwatcher"
section: "1"
platform: "linux"
package: "seekwatcher"
version: "0.12+hg20091016-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/seekwatcher"
---

# seekwatcher(1)

utility to visualize block I/O patterns

## NAME

seekwatcher - utility to visualize block I/O patterns

## SYNOPSIS

**seekwatcher** \[*options*\]

## OPTIONS

- **-h**, **--help**

  show this help message and exit

- **-d** DEVICE, **--device**=*DEVICE*

  Device for blktrace

- **-D** BLKTRACE\_DESTINATION, **--blktrace-destination**=*BLKTRACE\_DESTINATION*

  Destination for blktrace

- **-t** TRACE, **--trace**=*TRACE*

  blktrace file

- **-p** PROG, **--prog**=*PROG*

  exec program

- **--full-trace**

  Don't filter blktrace events

- **-a** ADJUST, **--adjust**=*ADJUST*

  Adjust plot placement: left=0.125,right=0.79,bottom=0.1,top=0.9,wspace=0.2,hspace=0.8

- **-c** COLORS, **--colors**=*COLORS*

  List of colors to use in plot

- **-C** COLUMNS, **--columns**=*COLUMNS*

  Number of columns for subplots

- **-z** ZOOM, **--zoom**=*ZOOM*

  Zoom range min:max (in MB)

- **-x** XZOOM, **--xzoom**=*XZOOM*

  Time range min:max (seconds)

- **-o** OUTPUT, **--output**=*OUTPUT*

  output file

- **-l** LABEL, **--label**=*LABEL*

  label

- **--dpi**=*DPI*

  dpi

- **--io-graph-dots**=*IO\_GRAPH\_DOTS*

  Disk IO dot style

- **--io-graph-marker-size**=*IO\_GRAPH\_MARKER\_SIZE*

  Disk IO dot size

- **--io-graph-cell-multi**=*IO\_GRAPH\_CELL\_MULTI*

  Multiplier for cells

- **-O** ONLY\_GRAPH, **--only-graph**=*ONLY\_GRAPH*

  Add a single graph to the output (io, tput, seek, iops, stats)

- **-N** NO\_GRAPH, **--no-graph**=*NO\_GRAPH*

  Remove a single graph (io, tput, seek, iops, stats)

- **-s**, **--only-io-graph-seeks**

  Only plot seeks on the IO graph

- **-r** ROLLING\_AVG, **--rolling-avg**=*ROLLING\_AVG*

  Rolling average for seeks and throughput (in seconds)

- **-i**, **--interactive**

  Use matplotlib interactive

- **--backend**=*BACKEND*

  matplotlib backend (Qt4Agg, TkAgg, GTKAgg) case sensitive

- **-T** TITLE, **--title**=*TITLE*

  Graph Title

- **-R**, **--reads-only**

  Graph only reads

- **-W**, **--writes-only**

  Graph only writes

- **-F** FIGURE\_SIZE, **--figure-size**=*FIGURE\_SIZE*

  Figure size (8x6)

- **-P**, **--tag-process**

  Tag IO graph by process

- **-M** MERGE, **--merge**=*MERGE*

  Merge process pids for a process

- **--legend**=*LEGEND*

  Legend position 1.01,0.5

- **--legend-columns**=*LEGEND\_COLUMNS*

  Legend columns

- **-m**, **--movie**

  Generate an IO movie

- **--movie-frames**=*MOVIE\_FRAMES*

  Number of frames per second

- **--movie-length**=*MOVIE\_LENGTH*

  Movie length in seconds

- **--movie-cell-size**=*MOVIE\_CELL\_SIZE*

  Size in pixels of the IO cells

- **--movie-vbitrate**=*MOVIE\_VBITRATE*

  Mencoder vbitrate option (default 16000)

## SEE ALSO

Examples of usage in **/usr/share/doc/seekwatcher/README.html**