1DSTAT(1) DSTAT(1)
2
3
4
6 dstat - versatile tool for generating system resource statistics
7
9 dstat [-afv] [options..] [delay [count]]
10
11
13 Dstat is a versatile replacement for vmstat, iostat and ifstat. Dstat
14 overcomes some of the limitations and adds some extra features.
15
16 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
21 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
25 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
30 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
33
34 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
39
41 -c, --cpu
42 enable cpu stats (system, user, idle, wait, hardware interrupt,
43 software interrupt)
44
45 -C 0,3,total
46 include cpu0, cpu3 and total
47
48 -d, --disk
49 enable disk stats (read, write)
50
51 -D total,hda
52 include hda and total
53
54 -g, --page
55 enable page stats (page in, page out)
56
57 -i, --int
58 enable interrupt stats
59
60 -I 5,10
61 include interrupt 5 and 10
62
63 -l, --load
64 enable load average stats (1 min, 5 mins, 15mins)
65
66 -m, --mem
67 enable memory stats (used, buffers, cache, free)
68
69 -n, --net
70 enable network stats (receive, send)
71
72 -N eth1,total
73 include eth1 and total
74
75 -p, --proc
76 enable process stats (runnable, uninterruptible, new)
77
78 -r, --io
79 enable I/O request stats (read, write requests)
80
81 -s, --swap
82 enable swap stats (used, free)
83
84 -S swap1,total
85 include swap1 and total
86
87 -t, --time
88 enable time/date output
89
90 -T, --epoch
91 enable time counter (seconds since epoch)
92
93 -y, --sys
94 enable system stats (interrupts, context switches)
95
96 --aio enable aio stats (asynchronous I/O)
97
98 --fs enable filesystem stats (open files, inodes)
99
100 --ipc enable ipc stats (message queue, semaphores, shared memory)
101
102 --lock enable file lock stats (posix, flock, read, write)
103
104 --raw enable raw stats (raw sockets)
105
106 --socket
107 enable socket stats (total, tcp, udp, raw, ip-fragments)
108
109 --tcp enable tcp stats (listen, established, syn, time_wait, close)
110
111 --udp enable udp stats (listen, active)
112
113 --unix enable unix stats (datagram, stream, listen, active)
114
115 --vm enable vm stats (hard pagefaults, soft pagefaults, allocated,
116 free)
117
118 --stat1 --stat2
119 enable (external) plugins by plugin name, see PLUGINS for
120 options
121
122 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
127 --list list the internal and external plugin names
128
129 -a, --all
130 equals -cdngy (default)
131
132 -f, --full
133 expand -C, -D, -I, -N and -S discovery lists
134
135 -v, --vmstat
136 equals -pmgdsc -D total
137
138 --bw, --blackonwhite
139 change colors for white background terminal
140
141 --float
142 force float values on screen (mutual exclusive with --integer)
143
144 --integer
145 force integer values on screen (mutual exclusive with --float)
146
147 --nocolor
148 disable colors (implies --noupdate)
149
150 --noheaders
151 disable repetitive headers
152
153 --noupdate
154 disable intermediate updates when delay > 1
155
156 --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
165
166 --battery
167 battery in percentage (needs ACPI)
168
169 --battery-remain
170 battery remaining in hours, minutes (needs ACPI)
171
172 --cpufreq
173 CPU frequency in percentage (needs ACPI)
174
175 --dbus number of dbus connections (needs python-dbus)
176
177 --disk-util
178 per disk utilization in percentage
179
180 --fan fan speed (needs ACPI)
181
182 --freespace
183 per filesystem disk usage
184
185 --gpfs GPFS read/write I/O (needs mmpmon)
186
187 --gpfs-ops
188 GPFS filesystem operations (needs mmpmon)
189
190 --helloworld
191 Hello world example dstat plugin
192
193 --innodb-buffer
194 show innodb buffer stats
195
196 --innodb-io
197 show innodb I/O stats
198
199 --innodb-ops
200 show innodb operations counters
201
202 --lustre
203 show lustre I/O throughput
204
205 --memcache-hits
206 show the number of hits and misses from memcache
207
208 --mysql5-cmds
209 show the MySQL5 command stats
210
211 --mysql5-conn
212 show the MySQL5 connection stats
213
214 --mysql5-io
215 show the MySQL5 I/O stats
216
217 --mysql5-keys
218 show the MySQL5 keys stats
219
220 --mysql-io
221 show the MySQL I/O stats
222
223 --mysql-keys
224 show the MySQL keys stats
225
226 --net-packets
227 show the number of packets received and transmitted
228
229 --nfs3 show NFS v3 client operations
230
231 --nfs3-ops
232 show extended NFS v3 client operations
233
234 --nfsd3
235 show NFS v3 server operations
236
237 --nfsd3-ops
238 show extended NFS v3 server operations
239
240 --ntp show NTP time from an NTP server
241
242 --postfix
243 show postfix queue sizes (needs postfix)
244
245 --power
246 show power usage
247
248 --proc-count
249 show total number of processes
250
251 --rpc show RPC client calls stats
252
253 --rpcd show RPC server calls stats
254
255 --sendmail
256 show sendmail queue size (needs sendmail)
257
258 --snooze
259 show number of ticks per second
260
261 --test show test plugin output
262
263 --thermal
264 system temperature sensors
265
266 --top-bio
267 show most expensive block I/O process
268
269 --top-cpu
270 show most expensive CPU process
271
272 --top-cputime
273 show process using the most CPU time (in ms)
274
275 --top-cputime-avg
276 show process with the highest average timeslice (in ms)
277
278 --top-io
279 show most expensive I/O process
280
281 --top-latency
282 show process with highest total latency (in ms)
283
284 --top-latency-avg
285 show process with the highest average latency (in ms)
286
287 --top-mem
288 show process using the most memory
289
290 --top-oom
291 show process that will be killed by OOM the first
292
293 --utmp show number of utmp connections (needs python-utmp)
294
295 --vmk-hba
296 show VMware ESX kernel vmhba stats
297
298 --vmk-int
299 show VMware ESX kernel interrupt stats
300
301 --vmk-nic
302 show VMware ESX kernel port stats
303
304 --vm-memctl
305 show ballooning status inside VMware guests
306
307 --vz-io
308 show CPU usage per OpenVZ guest
309
310 --vz-ubc
311 show OpenVZ user beancounters
312
313 --wifi wireless link quality and signal to noise ratio
314
316 delay is the delay in seconds between each update
317
318 count is the number of updates to display before exiting
319
320 The default delay is 1 and count is unspecified (unlimited)
321
322
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
329 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
334
336 Using dstat to relate disk-throughput with network-usage (eth0), total
337 CPU-usage and system counters:
338
339
340 dstat -dnyc -N eth0 -C total -f 5
341 Checking dstat’s behaviour and the system impact of dstat:
342
343
344 dstat -taf --debug
345 Using the time plugin together with cpu, net, disk, system, load, proc
346 and top_cpu plugins:
347
348
349 dstat -tcndylp --top-cpu
350 this is identical to
351
352
353 dstat --time --cpu --net --disk --sys --load --proc --top-cpu
354 Using dstat to relate cpu stats with interrupts per device:
355
356
357 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
365
366 Note
367 Please see the TODO file for known bugs and future plans.
368
369
371 Paths that may contain external dstat_*.py plugins:
372
373
374 ~/.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
383 Debugging tools
384 htop(1), lslk(1), lsof(8), top(1)
385
386 Process tracing
387 ltrace(1), pmap(1), ps(1), pstack(1), strace(1)
388
389 Binary debugging
390 ldd(1), file(1), nm(1), objdump(1), readelf(1)
391
392 Memory usage tools
393 free(1), memusage, memusagestat, slabtop(1)
394
395 Accounting tools
396 dump-acct, dump-utmp, sa(8)
397
398 Hardware debugging tools
399 dmidecode, ifinfo(1), lsdev(1), lshal(1), lshw(1), lsmod(8), lspci(8), lsusb(8), smartctl(8), x86info(1)
400
401 Application debugging
402 mailstats(8), qshape(1)
403
404 Xorg related tools
405 xdpyinfo(1), xrestop(1)
406
407 Other useful info
408 collectl(1), proc(5), procinfo(8)
409
411 Written by Dag Wieers [1]dag@wieers.com
412
413 Homepage at [2]http://dag.wieers.com/home-made/dstat/
414
415 This manpage was initially written by Andrew Pollock
416 [3]apollock@debian.org for the Debian GNU/Linux system.
417
418
420 1. dag@wieers.com
421 mailto:dag@wieers.com
422
423 2. http://dag.wieers.com/home-made/dstat/
424 http://dag.wieers.com/home-made/dstat/
425
426 3. apollock@debian.org
427 mailto:apollock@debian.org
428
429
430
431 0.7.0 11/25/2009 DSTAT(1)