1DSTAT(1) DSTAT(1)
2
6 dstat - versatile tool for generating system resource statistics
7
9 dstat [-afv] [options..] [delay [count]]
10
13 Dstat is a versatile replacement for vmstat, iostat and ifstat. Dstat
14 overcomes some of the limitations and adds some extra features.
15 Dstat allows you to view all of your system resources instantly, you
17 can eg. compare disk usage in combination with interrupts from your IDE
18 controller, or compare the network bandwidth numbers directly with the
19 disk throughput (in the same interval).
20 Dstat also cleverly gives you the most detailed information in columns
22 and clearly indicates in what magnitude and unit the output is
23 displayed. Less confusion, less mistakes, more efficient.
24 Dstat is unique in letting you aggregate block device throughput for a
26 certain diskset or network bandwidth for a group of interfaces, ie. you
27 can see the throughput for all the block devices that make up a single
28 filesystem or storage system.
29 Dstat allows its data to be directly written to a CSV file to be
31 imported and used by OpenOffice, Gnumeric or Excel to create graphs.
32 Note
35 Users of Sleuthkit might find Sleuthkit's dstat being renamed to
36 datastat to avoid a name conflict. See Debian bug #283709 for more
37 information.
38
41 -c, --cpu
42 enable cpu stats
43 -C 0,3,total
45 include cpu0, cpu3 and total
46 -d, --disk
48 enable disk stats
49 -D total,hda
51 include hda and total
52 -g, --page
54 enable page stats
55 -i, --int
57 enable interrupt stats
58 -I 5,10
60 include interrupt 5 and 10
61 -l, --load
63 enable load stats
64 -m, --mem
66 enable memory stats
67 -n, --net
69 enable network stats
70 -N eth1,total
72 include eth1 and total
73 -p, --proc
75 enable process stats
76 -s, --swap
78 enable swap stats
79 -S swal1,total
81 include swap1 and total
82 -t, --time
84 enable time/date output
85 -T, --epoch
87 enable time counter (seconds since epoch)
88 -y, --sys
90 enable system stats
91 --ipc enable ipc stats
93 --lock enable lock stats
95 --raw enable raw stats
97 --tcp enable tcp stats
99 --udp enable udp stats
101 --unix enable unix stats
103 -M stat1,stat2
105 enable internal stats and external plugin stats
106 Possible internal stats are
108 cpu, cpu24, disk, disk24, disk24old, epoch, int, int24, ipc,
109 load, lock, mem, net, page, page24, proc, raw, swap, swapold,
110 sys, tcp, time, udp, unix
111 Possible external plugin stats can be listed using
113 dstat -M list
114 -a, --all
116 equals -cdngy (default)
117 -f, --full
119 expand -C, -D, -I, -N and -S discovery lists
120 -v, --vmstat
122 equals -pmgdsc -D total
123 --integer
125 show integer values
126 --nocolor
128 disable colors (implies --noupdate)
129 --noheaders
131 disable repetitive headers
132 --noupdate
134 disable intermediate updates when delay > 1
135 --output file
137 write CSV output to file
138
140 delay is the delay in seconds between each update
141 count is the number of updates to display before exiting
143 The default delay is 1 and count is unspecified (unlimited)
145
148 When invoking dstat with a delay greater than 1 and without the
149 --noupdate option, it will show intermediate updates, ie. the first
150 time a 1 sec average, the second update a 2 second average, etc. until
151 the delay has been reached.
152 So in case you specified a delay of 10, the 9 intermediate updates are
154 NOT snapshots, they are averages over the time that passed since the
155 last final update. The end result is that you get a 10 second average
156 on a new line, just like with vmstat.
157
160 Using dstat to relate disk-throughput with network-usage (eth0), total
161 CPU-usage and system counters:
162 dstat -dnyc -n eth0 -C total -f 5
164 Checking dstat's behaviour and the system's impact on dstat:
166 dstat -taf --debug
168 Using the external clock and app plugins together with normal system
170 resources:
171 dstat -M clock,app -cndylp
173
175 Since it's practically impossible to test dstat on every possible
176 permutation of kernel, python or distribution version, I need your help
177 and your feedback to fix the remaining problems. If you have
178 improvements or bugreports, please send them to: [1]dag@wieers.com
179 Note
182 Please see the TODO file for known bugs and future plans.
183
186 Paths that may contain external dstat_* plugins:
187 ~/.dstat/
190 (path of binary)/plugins/
191 /usr/share/dstat/
192 /usr/local/share/dstat/
193
195 Performance tools
196 ifstat(1), iftop(8), iostat(1), mpstat(1), netstat(1), nfsstat(1), nstat, vmstat(1), xosview(1)
197 Debugging tools
199 htop, lslk(1), lsof(8), top(1)
200 Process tracing
202 ltrace(1), pmap(1), ps(1), pstack(1), strace(1)
203 Binary debugging
205 ldd(1), file(1), nm(1), objdump(1), readelf(1)
206 Memory usage tools
208 free(1), memusage, memusagestat, slabtop(1)
209 Accounting tools
211 dump-acct, dump-utmp, sa(8)
212 Hardware debugging tools
214 dmidecode, ifinfo(1), lsdev(1), lshal(1), lshw(1), lsmod(8), lspci(8), lsusb(8), smartctl(8), x86info(1)
215 Application debugging
217 mailstats(8), qshape(1)
218 Xorg related tools
220 xdpyinfo(1), xrestop(1)
221 Other useful info
223 proc(5)
224
226 Written by Dag Wieers [1]dag@wieers.com
227 Homepage at [2]http://dag.wieers.com/home-made/dstat/
229 This manpage was initially written by Andrew Pollock
231 [3]apollock@debian.org for the Debian GNU/Linux system, and updated by
232 Dag Wieers [1]dag@wieers.com
233
236 1. dag@wieers.com
237 mailto:dag@wieers.com
238 2. http://dag.wieers.com/home-made/dstat/
240 http://dag.wieers.com/home-made/dstat/
241 3. apollock@debian.org
243 mailto:apollock@debian.org
244 04/28/2007 DSTAT(1)