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 (system, user, idle, wait, hardware interrupt,
43 software interrupt)
44 -C 0,3,total
46 include cpu0, cpu3 and total
47 -d, --disk
49 enable disk stats (read, write)
50 -D total,hda
52 include hda and total
53 -g, --page
55 enable page stats (page in, page out)
56 -i, --int
58 enable interrupt stats
59 -I 5,10
61 include interrupt 5 and 10
62 -l, --load
64 enable load average stats (1 min, 5 mins, 15mins)
65 -m, --mem
67 enable memory stats (used, buffers, cache, free)
68 -n, --net
70 enable network stats (receive, send)
71 -N eth1,total
73 include eth1 and total
74 -p, --proc
76 enable process stats (runnable, uninterruptible, new)
77 -r, --io
79 enable I/O request stats (read, write requests)
80 -s, --swap
82 enable swap stats (used, free)
83 -S swap1,total
85 include swap1 and total
86 -t, --time
88 enable time/date output
89 -T, --epoch
91 enable time counter (seconds since epoch)
92 -y, --sys
94 enable system stats (interrupts, context switches)
95 --aio enable aio stats (asynchronous I/O)
97 --fs enable filesystem stats (open files, inodes)
99 --ipc enable ipc stats (message queue, semaphores, shared memory)
101 --lock enable file lock stats (posix, flock, read, write)
103 --raw enable raw stats (raw sockets)
105 --socket
107 enable socket stats (total, tcp, udp, raw, ip-fragments)
108 --tcp enable tcp stats (listen, established, syn, time_wait, close)
110 --udp enable udp stats (listen, active)
112 --unix enable unix stats (datagram, stream, listen, active)
114 --vm enable vm stats (hard pagefaults, soft pagefaults, allocated,
116 free)
117 --stat1 --stat2
119 enable (external) plugins by plugin name, see PLUGINS for
120 options
121 Possible internal stats are
123 aio, cpu, cpu24, disk, disk24, disk24old, epoch, fs, int, int24,
124 io, ipc, load, lock, mem, net, page, page24, proc, raw, socket,
125 swap, swapold, sys, tcp, time, udp, unix, vm
126 --list list the internal and external plugin names
128 -a, --all
130 equals -cdngy (default)
131 -f, --full
133 expand -C, -D, -I, -N and -S discovery lists
134 -v, --vmstat
136 equals -pmgdsc -D total
137 --bw, --blackonwhite
139 change colors for white background terminal
140 --float
142 force float values on screen (mutual exclusive with --integer)
143 --integer
145 force integer values on screen (mutual exclusive with --float)
146 --nocolor
148 disable colors (implies --noupdate)
149 --noheaders
151 disable repetitive headers
152 --noupdate
154 disable intermediate updates when delay > 1
155 --output file
157 write CSV output to file
158
160 While anyone can create their own dstat plugins (and contribute them)
161 dstat ships with a number of plugins already that extend its
162 capabilities greatly. Here is an overview of the plugins dstat ships
163 with:
164 --battery
167 battery in percentage (needs ACPI)
168 --battery-remain
170 battery remaining in hours, minutes (needs ACPI)
171 --cpufreq
173 CPU frequency in percentage (needs ACPI)
174 --dbus number of dbus connections (needs python-dbus)
176 --disk-util
178 per disk utilization in percentage
179 --fan fan speed (needs ACPI)
181 --freespace
183 per filesystem disk usage
184 --gpfs GPFS read/write I/O (needs mmpmon)
186 --gpfs-ops
188 GPFS filesystem operations (needs mmpmon)
189 --helloworld
191 Hello world example dstat plugin
192 --innodb-buffer
194 show innodb buffer stats
195 --innodb-io
197 show innodb I/O stats
198 --innodb-ops
200 show innodb operations counters
201 --lustre
203 show lustre I/O throughput
204 --memcache-hits
206 show the number of hits and misses from memcache
207 --mysql5-cmds
209 show the MySQL5 command stats
210 --mysql5-conn
212 show the MySQL5 connection stats
213 --mysql5-io
215 show the MySQL5 I/O stats
216 --mysql5-keys
218 show the MySQL5 keys stats
219 --mysql-io
221 show the MySQL I/O stats
222 --mysql-keys
224 show the MySQL keys stats
225 --net-packets
227 show the number of packets received and transmitted
228 --nfs3 show NFS v3 client operations
230 --nfs3-ops
232 show extended NFS v3 client operations
233 --nfsd3
235 show NFS v3 server operations
236 --nfsd3-ops
238 show extended NFS v3 server operations
239 --ntp show NTP time from an NTP server
241 --postfix
243 show postfix queue sizes (needs postfix)
244 --power
246 show power usage
247 --proc-count
249 show total number of processes
250 --rpc show RPC client calls stats
252 --rpcd show RPC server calls stats
254 --sendmail
256 show sendmail queue size (needs sendmail)
257 --snooze
259 show number of ticks per second
260 --test show test plugin output
262 --thermal
264 system temperature sensors
265 --top-bio
267 show most expensive block I/O process
268 --top-cpu
270 show most expensive CPU process
271 --top-cputime
273 show process using the most CPU time (in ms)
274 --top-cputime-avg
276 show process with the highest average timeslice (in ms)
277 --top-io
279 show most expensive I/O process
280 --top-latency
282 show process with highest total latency (in ms)
283 --top-latency-avg
285 show process with the highest average latency (in ms)
286 --top-mem
288 show process using the most memory
289 --top-oom
291 show process that will be killed by OOM the first
292 --utmp show number of utmp connections (needs python-utmp)
294 --vmk-hba
296 show VMware ESX kernel vmhba stats
297 --vmk-int
299 show VMware ESX kernel interrupt stats
300 --vmk-nic
302 show VMware ESX kernel port stats
303 --vm-memctl
305 show ballooning status inside VMware guests
306 --vz-io
308 show CPU usage per OpenVZ guest
309 --vz-ubc
311 show OpenVZ user beancounters
312 --wifi wireless link quality and signal to noise ratio
314
316 delay is the delay in seconds between each update
317 count is the number of updates to display before exiting
319 The default delay is 1 and count is unspecified (unlimited)
321
324 When invoking dstat with a delay greater than 1 and without the
325 --noupdate option, it will show intermediate updates, ie. the first
326 time a 1 sec average, the second update a 2 second average, etc. until
327 the delay has been reached.
328 So in case you specified a delay of 10, the 9 intermediate updates are
330 NOT snapshots, they are averages over the time that passed since the
331 last final update. The end result is that you get a 10 second average
332 on a new line, just like with vmstat.
333
336 Using dstat to relate disk-throughput with network-usage (eth0), total
337 CPU-usage and system counters:
338 dstat -dnyc -N eth0 -C total -f 5
341 Checking dstat’s behaviour and the system impact of dstat:
342 dstat -taf --debug
345 Using the time plugin together with cpu, net, disk, system, load, proc
346 and top_cpu plugins:
347 dstat -tcndylp --top-cpu
350 this is identical to
351 dstat --time --cpu --net --disk --sys --load --proc --top-cpu
354 Using dstat to relate cpu stats with interrupts per device:
355 dstat -tcyif
358
360 Since it is practically impossible to test dstat on every possible
361 permutation of kernel, python or distribution version, I need your help
362 and your feedback to fix the remaining problems. If you have
363 improvements or bugreports, please send them to: [1]dag@wieers.com
364 Note
367 Please see the TODO file for known bugs and future plans.
368
371 Paths that may contain external dstat_*.py plugins:
372 ~/.dstat/
375 (path of binary)/plugins/
376 /usr/share/dstat/
377 /usr/local/share/dstat/
378
380 Performance tools
381 ifstat(1), iftop(8), iostat(1), mpstat(1), netstat(1), nfsstat(1), nstat, vmstat(1), xosview(1)
382 Debugging tools
384 htop(1), lslk(1), lsof(8), top(1)
385 Process tracing
387 ltrace(1), pmap(1), ps(1), pstack(1), strace(1)
388 Binary debugging
390 ldd(1), file(1), nm(1), objdump(1), readelf(1)
391 Memory usage tools
393 free(1), memusage, memusagestat, slabtop(1)
394 Accounting tools
396 dump-acct, dump-utmp, sa(8)
397 Hardware debugging tools
399 dmidecode, ifinfo(1), lsdev(1), lshal(1), lshw(1), lsmod(8), lspci(8), lsusb(8), smartctl(8), x86info(1)
400 Application debugging
402 mailstats(8), qshape(1)
403 Xorg related tools
405 xdpyinfo(1), xrestop(1)
406 Other useful info
408 collectl(1), proc(5), procinfo(8)
409
411 Written by Dag Wieers [1]dag@wieers.com
412 Homepage at [2]http://dag.wieers.com/home-made/dstat/
414 This manpage was initially written by Andrew Pollock
416 [3]apollock@debian.org for the Debian GNU/Linux system.
417
420 1. dag@wieers.com
421 mailto:dag@wieers.com
422 2. http://dag.wieers.com/home-made/dstat/
424 http://dag.wieers.com/home-made/dstat/
425 3. apollock@debian.org
427 mailto:apollock@debian.org
428 0.7.0 11/25/2009 DSTAT(1)