1dsstat(1M) System Administration Commands dsstat(1M)
2
6 dsstat - report Sun StorageTek Availability Suite I/O statistics
7
9 dsstat -m mode [-r report-options] [-d display-options]
10 [-s volume-sets] [-f | -F] [-z] [interval [count]]
11
14 The dsstat command collects and reports I/O statistics for the Sun
15 StorageTek Availability Suite products.
16
18 The dsstat supports the following options:
19 -m mode
21 Specifies the mode(s) of operation. Valid modes are:
23 cache
25 Cache statistics
27 ii
30 Point-in-Time Copy statistics
32 sndr
35 Remote Mirror statistics
37 To display statistics for multiple services simultaneously, use the
39 -m switch to specify each of the modes required. For example:
40 % dsstat -m ii -m sndr
42 % dsstat -m ii -m sndr -m cache
43 To determine which statistics are being reported from which ser‐
46 vice, use the role field, described below. When cache statistics
47 are requested as one of the multiple services, the rkps and wkps
48 statistics is further divided into crkps, drkps, cwkps, and dwkps.
49 If no -m switch is specified, then dsstat displays default statis‐
50 tics for all of the valid modes as described above. See "Field
51 Descriptions," below for descriptions of these fields.
52 -r report-options
55 Specifies the volume components to be displayed. Each item is rep‐
57 resented by a single character, and multiple items can be selected.
58 The report-options vary based on the mode(s) specified above. This
59 option is not used for cache mode.
60 Valid report-options for ii mode are:
62 m Master volume statistics.
64 o For the "report-options for ii mode": m, s,
66 b, o
67 o For the "report-options for sndr mode": b,
69 n
70 o For the "display-options for cache mode":
72 r, w, d, c, s, f
73 o For the "display-options for ii mode": r,
75 w, t, s, p, f
76 s Shadow volume statistics.
79 b Bitmap volume statistics.
82 o Overflow volume statistics, if attached.
85 Valid report-options for sndr mode are:
87 b Bitmap volume statistics.
89 n Network volume statistics.
92 -d display-options
96 Specifies the statistics to be displayed. The types of statistics
98 are represented by a single character; multiple types can be speci‐
99 fied.
100 For cache mode, the valid display-options are:
102 r Detailed read statistics.
104 w Detailed write statistics.
107 s Summary statistics.
110 f Cache behavior flags.
113 The following display-options are available only for cache mode,
115 they need to be combined with the mode options (-m)
116 d Destaged data statistics.
118 c Write cancellation statistics.
121 The default display-options for cache are sf.
123 For ii mode, the valid display-options are:
125 r
127 Detailed read statistics.
129 w
132 Detailed write statistics.
134 t
137 Timing statistics.
139 s
142 Summary statistics.
144 p
147 Percentage of volume requiring sync.
149 f
152 Volume type/status flags.
154 The default display-options for ii are spf. For sndr mode, the
156 valid display-options are:
157 r Detailed read statistics.
159 w Detailed write statistics.
162 t Timing statistics.
165 s Summary statistics.
168 p Percentage of volume requiring sync.
171 f Volume type/status flags.
174 q Asynchronous queue statistics.
177 The following display-option is only available for sndr mode, and
179 needs to be combined with the mode options (-m).
180 q Asynchronous queue statistics.
182 The default display-options for sndr are spf.
184 Specifying the summary display-option causes r w t display-options
186 to be ignored.
187 -s volume-sets Filters the output to include only the specified
190 volume-sets, where volume-sets is a comma-delimited
191 list of volume names. When displaying Remote Mirror
192 statistics, the name specified is compared to the
193 Remote Mirror primary volume to determine if they
194 match. Additionally, an Remote Mirror volume should
195 be specified as <host>:<volume> where <host> is the
196 primary or secondary host and <volume> is the vol‐
197 ume name by which that host recognizes the volume
198 set. When specifying multiple Remote Mirror volumes
199 sets, be aware that each volume set specified is
200 evaluated individually, using the rules above. When
201 displaying Point-in-Time Copy statistics, the vol‐
202 ume name specified is compared to the Point-in-Time
203 Copy shadow volume to determine if they match.
204 -f Output field headers at every reporting cycle.
207 -F Output field headers once, when reporting begins.
210 -z Suppress report lines that have zero values or no
213 activity.
214
217 The dsstat command line supports the following operands:
218 interval
220 Specifies the interval for each report, in seconds. If no interval
222 is specified, a single report with a one second interval is output.
223 Due to the varying number of entries in a given set and the varying
225 number of sets, header information might appear in the middle of a
226 set being reported. To avoid this, use the -f or -F options to dis‐
227 play the header information at the desired time.
228 count
231 Specifies the number of reports to generate. If no count is speci‐
233 fied, output continues until interrupted.
234 Field Descriptions
237 Unless otherwise specified, all fields are per-second averages based on
238 the data collected during the specified interval.
239 name Name of the entity being reported
241 t Volume type
244 s Volume status
247 r Cache read behavior
250 w Cache write behavior
253 pct Percentage of volume requiring sync
256 role Role of the item being reported
259 tps Total number of reads + writes
262 rtps Number of reads
265 wtps Number of writes
268 kps Total kilobytes read + written
271 rkps Kilobytes read
274 wkps Kilobytes written
277 crkps Kilobytes read from cache
280 drkps Kilobytes read from disk
283 cwkps Kilobytes written to cache
286 dwkps Kilobytes written to disk
289 ckps Kilobytes transferred to or from cache
292 dkps Kilobytes transferred to or from disk
295 svt Service time per operation
298 hit Read hits during interval
301 ds/s Kilobytes destaged from cache
304 cn/s Number of write cancellations
307 q Type of asynchronous queuing being used
310 qi Number of items currently queued
313 qk Kilobytes currently queued
316 qhwi High water mark of queued items
319 qhwk High water mark of queued kilobytes
322 The name field displays only the last 16 characters of the name.
326 Valid cache behaviors for cache are:
329 C Cache reads/writes
331 D Disk reads/writes
334 Valid volume types for ii are:
338 I Independent shadow volume
340 D Dependent shadow volume
343 Valid volume status for ii is:
347 C Copy in progress
349 - No copy in progress
352 Valid volume types for sndr are:
356 P This is the primary host of this volume set
358 S This is the secondary host of this volume set
361 Valid volume status for sndr is:
365 L Changes to this volume are being logged
367 Q Volume are in queuing mode
370 R Replicating changes to secondary
373 SY Synchronization in progress. Sending data.
376 RS Reverse synchronization in progress. Receiving data.
379 SN Synchronization needed
382 RN Reverse synchronization needed
385 VF Volume failed
388 BF Bitmap failed
391 QF Queue failed
394 Valid queue types for sndr are:
398 D Disk-based queuing enabled
400 M Memory-based queuing enabled
403 Volume roles for sndr are:
407 net Network volume statistics
409 bmp Bitmap volume statistics
412 Volume roles for ii are:
416 mst Master volume statistics
418 shd Shadow volume statistics
421 bmp Bitmap volume statistics
424 ovr Overflow volume statistics
427
430 Example 1 Report Cache Statistics
431 The following example shows the display of Report Cache statistics,
434 with detailed breakdowns of read and writes to cache/disk. Reports are
435 generated at five second intervals. Reporting is limited to the set
436 /dev/rdsk/c1t1d0s0.
437 # dsstat -m cache -d rw -s /dev/rdsk/c1t1d0s0 5
440 - read - - write -
441 name ckps dkps hit ckps dkps hit
442 dev/rdsk/c1t1d0s0 0 0 0.00 0 0 0.00
443 dev/rdsk/c1t1d0s0 3 2396 0.13 983 763 100.00
444 dev/rdsk/c1t1d0s0 2399 799 75.00 2815 2686 100.00
445 dev/rdsk/c1t1d0s0 3200 800 80.00 2755 2908 100.00
446 dev/rdsk/c1t1d0s0 3999 799 83.33 2809 2868 100.00
447 dev/rdsk/c1t1d0s0 4800 800 85.71 2867 2931 100.00
448 Example 2 Report Master, Shadow and Bitmap Statistics
451 Report master, shadow and bitmap statistics for Point-in-Time Copy,
454 using default output. Generate reports at two second intervals.
455 # dsstat -m ii -r msb 2
458 name t s pct role kps tps svt
459 dev/rdsk/c0t1d0s5 I C 96.15 mst 19921 38 22
460 dev/rdsk/c0t1d0s6 shd 9960 19 20
461 dev/rdsk/c0t1d0s7 bmp 39 77 2
462 dev/rdsk/c0t1d0s5 I C 94.24 mst 19623 38 22
463 dev/rdsk/c0t1d0s6 shd 9939 19 20
464 dev/rdsk/c0t1d0s7 bmp 39 77 2
465 dev/rdsk/c0t1d0s5 I C 92.34 mst 19969 39 22
466 dev/rdsk/c0t1d0s6 shd 9984 19 20
467 dev/rdsk/c0t1d0s7 bmp 39 78 2
468 Example 3 Report Network Statistics for Remote Mirror
471 Report network statistics for Remote Mirror, using detailed read, write
474 statistics. Report includes volume type/status flags and percentages.
475 Generate reports at two second intervals. Limit reporting to the set
476 /dev/rdsk/c0t1d0s0.
477 # dsstat -m sndr -r n -d rwpf -s /dev/rdsk/c0t1d0s0 2
480 name t s pct role rkps rtps wkps wtps
481 dev/rdsk/c0t1d0s0 P L 100.00 sec 0 0 0 0
482 dev/rdsk/c0t1d0s0 P SY 99.90 sec 0 0 288 9
483 dev/rdsk/c0t1d0s0 P SY 97.90 sec 0 0 5296 165
484 dev/rdsk/c0t1d0s0 P SY 95.81 sec 0 0 5184 161
485 dev/rdsk/c0t1d0s0 P SY 93.81 sec 0 0 5280 164
486 dev/rdsk/c0t1d0s0 P SY 91.71 sec 0 0 5198 162
487
490 The following exit values are returned:
491 0 Successful completion.
493 1 Successful completion, no statistics to report.
496 2 An invalid argument has been encountered.
499 3 No memory is available to create kstat statistics.
502 4 An unknown error has occurred.
505
508 See attributes(5) for descriptions of the following attributes:
509 ┌─────────────────────────────┬─────────────────────────────┐
514 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
515 ├─────────────────────────────┼─────────────────────────────┤
516 │Availability │SUNWscmr, SUNWscmu │
517 ├─────────────────────────────┼─────────────────────────────┤
518 │Interface Stability │Evolving │
519 └─────────────────────────────┴─────────────────────────────┘
520
522 dscfg(1M), svadm(1M), ds.log(4), rdc.cf(4), attributes(5)
523SunOS 5.11 2 Oct 2007 dsstat(1M)