dstat(1)
NAME
dstat - versatile tool for generating system resource statistics
SYNOPSIS
dstat [-afv] [options..] [delay [count]]
DESCRIPTION
Dstat is a versatile replacement for vmstat, iostat and ifstat. Dstat
overcomes some of the limitations and adds some extra features.
Dstat allows you to view all of your system resources instantly, you
can eg. compare disk usage in combination with interrupts from your IDE
controller, or compare the network bandwidth numbers directly with the
disk throughput (in the same interval).
Dstat also cleverly gives you the most detailed information in columns
and clearly indicates in what magnitude and unit the output is
displayed. Less confusion, less mistakes, more efficient.
Dstat is unique in letting you aggregate block device throughput for a
certain diskset or network bandwidth for a group of interfaces, ie. you
can see the throughput for all the block devices that make up a single
filesystem or storage system.
Dstat allows its data to be directly written to a CSV file to be
imported and used by OpenOffice, Gnumeric or Excel to create graphs.
Note
Users of Sleuthkit might find Sleuthkit's dstat being renamed to
datastat to avoid a name conflict. See Debian bug #283709 for more
information.
OPTIONS
- -c, --cpu
- enable cpu stats
- -C 0,3,total
- include cpu0, cpu3 and total
- -d, --disk
- enable disk stats
- -D total,hda
- include hda and total
- -g, --page
- enable page stats
- -i, --int
- enable interrupt stats
- -I 5,10
- include interrupt 5 and 10
- -l, --load
- enable load stats
- -m, --mem
- enable memory stats
- -n, --net
- enable network stats
- -N eth1,total
- include eth1 and total
- -p, --proc
- enable process stats
- -s, --swap
- enable swap stats
- -S swap1,total
- include swap1 and total
- -t, --time
- enable time/date output
- -T, --epoch
- enable time counter (seconds since epoch)
- -y, --sys
- enable system stats
- --ipc enable ipc stats
- --lock enable lock stats
- --raw enable raw stats
- --tcp enable tcp stats
- --udp enable udp stats
- --unix enable unix stats
- -M stat1,stat2
- enable internal stats and external plugin stats
- Possible internal stats are
- cpu, cpu24, disk, disk24, disk24old, epoch, int, int24, ipc,
load, lock, mem, net, page, page24, proc, raw, swap, swapold,
sys, tcp, time, udp, unix - Possible external plugin stats can be listed using
- dstat -M list
- -a, --all
- equals -cdngy (default)
- -f, --full
- expand -C, -D, -I, -N and -S discovery lists
- -v, --vmstat
- equals -pmgdsc -D total
- --integer
- show integer values
- --nocolor
- disable colors (implies --noupdate)
- --noheaders
- disable repetitive headers
- --noupdate
- disable intermediate updates when delay > 1
- --output file
- write CSV output to file
ARGUMENTS
delay is the delay in seconds between each update
count is the number of updates to display before exiting
The default delay is 1 and count is unspecified (unlimited)
INTERMEDIATE UPDATES
When invoking dstat with a delay greater than 1 and without the
--noupdate option, it will show intermediate updates, ie. the first
time a 1 sec average, the second update a 2 second average, etc. until
the delay has been reached.
So in case you specified a delay of 10, the 9 intermediate updates are
NOT snapshots, they are averages over the time that passed since the
last final update. The end result is that you get a 10 second average
on a new line, just like with vmstat.
USAGE
Using dstat to relate disk-throughput with network-usage (eth0), total
CPU-usage and system counters:
dstat -dnyc -N eth0 -C total -f 5
Checking dstat's behaviour and the system's impact on dstat:
dstat -taf --debug
Using the time plugin together with cpu, net, disk, system, load, proc
and topcpu plugins:
dstat -tcndylp -M topcpu
this is identical to
dstat -M time,cpu,net,disk,sys,load,proc,topcpu
Using dstat to relate cpu stats with interrupts per device:
dstat -tcyif
BUGS
Since it's practically impossible to test dstat on every possible
permutation of kernel, python or distribution version, I need your help
and your feedback to fix the remaining problems. If you have
improvements or bugreports, please send them to: [1]dag@wieers.com
Note
Please see the TODO file for known bugs and future plans.
FILES
Paths that may contain external dstat_* plugins:
~/.dstat/
(path of binary)/plugins/
/usr/share/dstat/
/usr/local/share/dstat/
SEE ALSO
- Performance tools
- ifstat(1), iftop(8), iostat(1), mpstat(1), netstat(1), nfsstat(1), nstat, vmstat(1), xosview(1)
- Debugging tools
- htop, lslk(1), lsof(8), top(1)
- Process tracing
- ltrace(1), pmap(1), ps(1), pstack(1), strace(1)
- Binary debugging
- ldd(1), file(1), nm(1), objdump(1), readelf(1)
- Memory usage tools
- free(1), memusage, memusagestat, slabtop(1)
- Accounting tools
- dump-acct, dump-utmp, sa(8)
- Hardware debugging tools
- dmidecode, ifinfo(1), lsdev(1), lshal(1), lshw(1), lsmod(8), lspci(8), lsusb(8), smartctl(8), x86info(1)
- Application debugging
- mailstats(8), qshape(1)
- Xorg related tools
- xdpyinfo(1), xrestop(1)
- Other useful info
- proc(5)
AUTHOR
Written by Dag Wieers [1]dag@wieers.com
Homepage at [2]http://dag.wieers.com/home-made/dstat/
This manpage was initially written by Andrew Pollock
[3]apollock@debian.org for the Debian GNU/Linux system, and updated by
Dag Wieers [1]dag@wieers.com
REFERENCES
- 1. dag@wieers.com
- mailto:dag@wieers.com
- 2. http://dag.wieers.com/home-made/dstat/
http://dag.wieers.com/home-made/dstat/ - 3. apollock@debian.org
mailto:apollock@debian.org