2 .\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH DSSTAT 1M "Oct 2, 2007"
8 dsstat \- report Sun StorageTek Availability Suite I/O statistics
12 \fBdsstat\fR \fB-m\fR \fImode\fR [\fB-r\fR \fIreport-options\fR] [\fB-d\fR \fIdisplay-options\fR]
13 [\fB-s\fR \fIvolume-sets\fR] [\fB-f\fR | \fB-F\fR] [\fB-z\fR] [\fIinterval\fR [\fIcount\fR]]
19 The \fBdsstat\fR command collects and reports I/O statistics for the Sun
20 StorageTek Availability Suite products.
24 The \fBdsstat\fR supports the following options:
28 \fB\fB-m\fR \fB\fImode\fR\fR\fR
32 Specifies the mode(s) of operation. Valid modes are:
50 Point-in-Time Copy statistics
60 Remote Mirror statistics
63 To display statistics for multiple services simultaneously, use the \fB-m\fR
64 switch to specify each of the modes required. For example:
68 % \fBdsstat -m ii -m sndr\fR
69 % \fBdsstat -m ii -m sndr -m cache\fR
74 To determine which statistics are being reported from which service, use the
75 \fIrole\fR field, described below. When cache statistics are requested as one
76 of the multiple services, the \fBrkps\fR and \fBwkps\fR statistics is further
77 divided into \fBcrkps\fR, \fBdrkps\fR, \fBcwkps\fR, and \fBdwkps\fR. If no
78 \fB-m\fR switch is specified, then \fBdsstat\fR displays default statistics for
79 all of the valid modes as described above. See "Field Descriptions," below for
80 descriptions of these fields.
86 \fB\fB-r\fR \fB\fIreport-options\fR\fR\fR
90 Specifies the volume components to be displayed. Each item is represented by a
91 single character, and multiple items can be selected. The \fIreport-options\fR
92 vary based on the mode(s) specified above. This option is not used for
95 Valid \fIreport-options\fR for \fBii\fR mode are:
102 Master volume statistics.
107 For the "report-options for ii mode": \fBm\fR, \fBs\fR, \fBb\fR, \fBo\fR
113 For the "report-options for sndr mode": \fBb\fR, \fBn\fR
119 For the "display-options for cache mode": \fBr\fR, \fBw\fR, \fBd\fR, \fBc\fR,
126 For the "display-options for ii mode": \fBr\fR, \fBw\fR, \fBt\fR, \fBs\fR,
137 Shadow volume statistics.
146 Bitmap volume statistics.
155 Overflow volume statistics, if attached.
158 Valid \fIreport-options\fR for \fBsndr\fR mode are:
165 Bitmap volume statistics.
174 Network volume statistics.
182 \fB\fB-d\fR \fIdisplay-options\fR\fR
186 Specifies the statistics to be displayed. The types of statistics are
187 represented by a single character; multiple types can be specified.
189 For \fBcache\fR mode, the valid \fIdisplay-options\fR are:
196 Detailed read statistics.
205 Detailed write statistics.
223 Cache behavior flags.
226 The following \fIdisplay-options\fR are available only for cache mode, they
227 need to be combined with the mode options (\fB-m\fR)
234 Destaged data statistics.
243 Write cancellation statistics.
246 The default \fIdisplay-options\fR for \fBcache\fR are \fBsf\fR.
248 For \fBii\fR mode, the valid \fIdisplay-options\fR are:
256 Detailed read statistics.
266 Detailed write statistics.
296 Percentage of volume requiring sync.
306 Volume type/status flags.
309 The default \fIdisplay-options\fR for \fBii\fR are \fBspf\fR. For \fBsndr\fR
310 mode, the valid \fIdisplay-options\fR are:
317 Detailed read statistics.
326 Detailed write statistics.
353 Percentage of volume requiring sync.
362 Volume type/status flags.
371 Asynchronous queue statistics.
374 The following \fIdisplay-option\fR is only available for \fBsndr\fR mode, and
375 needs to be combined with the mode options (\fB-m\fR).
382 Asynchronous queue statistics.
385 The default \fIdisplay-options\fR for \fBsndr\fR are \fBspf\fR.
387 Specifying the summary \fIdisplay-option\fR causes \fBr\fR \fBw\fR \fBt\fR
388 \fIdisplay-options\fR to be ignored.
394 \fB\fB-s\fR \fB\fIvolume-sets\fR\fR\fR
397 Filters the output to include only the specified \fIvolume-sets\fR, where
398 \fIvolume-sets\fR is a comma-delimited list of volume names. When displaying
399 Remote Mirror statistics, the name specified is compared to the Remote Mirror
400 primary volume to determine if they match. Additionally, an Remote Mirror
401 volume should be specified as \fI<host>\fR:\fI<volume>\fR where \fI<host>\fR is
402 the primary or secondary host and \fI<volume>\fR is the volume name by which
403 that host recognizes the volume set. When specifying multiple Remote Mirror
404 volumes sets, be aware that each volume set specified is evaluated
405 individually, using the rules above. When displaying Point-in-Time Copy
406 statistics, the volume name specified is compared to the Point-in-Time Copy
407 shadow volume to determine if they match.
416 Output field headers at every reporting cycle.
425 Output field headers once, when reporting begins.
434 Suppress report lines that have zero values or no activity.
440 The \fBdsstat\fR command line supports the following operands:
448 Specifies the \fIinterval\fR for each report, in seconds. If no \fIinterval\fR
449 is specified, a single report with a one second \fIinterval\fR is output.
451 Due to the varying number of entries in a given set and the varying number of
452 sets, header information might appear in the middle of a set being reported. To
453 avoid this, use the \fB-f\fR or \fB-F\fR options to display the header
454 information at the desired time.
464 Specifies the number of reports to generate. If no \fIcount\fR is specified,
465 output continues until interrupted.
468 .SS "Field Descriptions"
471 Unless otherwise specified, all fields are per-second averages based on the
472 data collected during the specified \fIinterval\fR.
479 Name of the entity being reported
524 Percentage of volume requiring sync
533 Role of the item being reported
542 Total number of reads + writes
569 Total kilobytes read + written
596 Kilobytes read from cache
605 Kilobytes read from disk
614 Kilobytes written to cache
623 Kilobytes written to disk
632 Kilobytes transferred to or from cache
641 Kilobytes transferred to or from disk
650 Service time per operation
659 Read hits during \fIinterval\fR
668 Kilobytes destaged from cache
677 Number of write cancellations
686 Type of asynchronous queuing being used
695 Number of items currently queued
704 Kilobytes currently queued
713 High water mark of queued items
722 High water mark of queued kilobytes
727 The \fBname\fR field displays only the last 16 characters of the name.
730 Valid cache behaviors for \fBcache\fR are:
751 Valid volume types for \fBii\fR are:
758 Independent shadow volume
767 Dependent shadow volume
772 Valid volume status for \fBii\fR is:
793 Valid volume types for \fBsndr\fR are:
800 This is the primary host of this volume set
809 This is the secondary host of this volume set
814 Valid volume status for \fBsndr\fR is:
821 Changes to this volume are being logged
830 Volume are in queuing mode
839 Replicating changes to secondary
848 Synchronization in progress. Sending data.
857 Reverse synchronization in progress. Receiving data.
866 Synchronization needed
875 Reverse synchronization needed
907 Valid queue types for \fBsndr\fR are:
914 Disk-based queuing enabled
923 Memory-based queuing enabled
928 Volume roles for \fBsndr\fR are:
935 Network volume statistics
944 Bitmap volume statistics
949 Volume roles for \fBii\fR are:
956 Master volume statistics
965 Shadow volume statistics
974 Bitmap volume statistics
983 Overflow volume statistics
988 \fBExample 1 \fRReport Cache Statistics
991 The following example shows the display of Report Cache statistics, with
992 detailed breakdowns of read and writes to cache/disk. Reports are generated at
993 five second intervals. Reporting is limited to the set
994 \fB/dev/rdsk/c1t1d0s0\fR.
999 # dsstat -m cache -d rw -s /dev/rdsk/c1t1d0s0 5
1001 name ckps dkps hit ckps dkps hit
1002 dev/rdsk/c1t1d0s0 0 0 0.00 0 0 0.00
1003 dev/rdsk/c1t1d0s0 3 2396 0.13 983 763 100.00
1004 dev/rdsk/c1t1d0s0 2399 799 75.00 2815 2686 100.00
1005 dev/rdsk/c1t1d0s0 3200 800 80.00 2755 2908 100.00
1006 dev/rdsk/c1t1d0s0 3999 799 83.33 2809 2868 100.00
1007 dev/rdsk/c1t1d0s0 4800 800 85.71 2867 2931 100.00
1012 \fBExample 2 \fRReport Master, Shadow and Bitmap Statistics
1015 Report master, shadow and bitmap statistics for Point-in-Time Copy, using
1016 default output. Generate reports at two second intervals.
1021 # dsstat -m ii -r msb 2
1022 name t s pct role kps tps svt
1023 dev/rdsk/c0t1d0s5 I C 96.15 mst 19921 38 22
1024 dev/rdsk/c0t1d0s6 shd 9960 19 20
1025 dev/rdsk/c0t1d0s7 bmp 39 77 2
1026 dev/rdsk/c0t1d0s5 I C 94.24 mst 19623 38 22
1027 dev/rdsk/c0t1d0s6 shd 9939 19 20
1028 dev/rdsk/c0t1d0s7 bmp 39 77 2
1029 dev/rdsk/c0t1d0s5 I C 92.34 mst 19969 39 22
1030 dev/rdsk/c0t1d0s6 shd 9984 19 20
1031 dev/rdsk/c0t1d0s7 bmp 39 78 2
1036 \fBExample 3 \fRReport Network Statistics for Remote Mirror
1039 Report network statistics for Remote Mirror, using detailed read, write
1040 statistics. Report includes volume type/status flags and percentages. Generate
1041 reports at two second intervals. Limit reporting to the set
1042 \fB/dev/rdsk/c0t1d0s0\fR.
1047 # dsstat -m sndr -r n -d rwpf -s /dev/rdsk/c0t1d0s0 2
1048 name t s pct role rkps rtps wkps wtps
1049 dev/rdsk/c0t1d0s0 P L 100.00 sec 0 0 0 0
1050 dev/rdsk/c0t1d0s0 P SY 99.90 sec 0 0 288 9
1051 dev/rdsk/c0t1d0s0 P SY 97.90 sec 0 0 5296 165
1052 dev/rdsk/c0t1d0s0 P SY 95.81 sec 0 0 5184 161
1053 dev/rdsk/c0t1d0s0 P SY 93.81 sec 0 0 5280 164
1054 dev/rdsk/c0t1d0s0 P SY 91.71 sec 0 0 5198 162
1061 The following exit values are returned:
1068 Successful completion.
1077 Successful completion, no statistics to report.
1086 An invalid argument has been encountered.
1095 No memory is available to create \fBkstat\fR statistics.
1104 An unknown error has occurred.
1110 See \fBattributes\fR(5) for descriptions of the following attributes:
1118 ATTRIBUTE TYPE ATTRIBUTE VALUE
1120 Interface Stability Evolving
1126 \fBdscfg\fR(1M), \fBsvadm\fR(1M), \fBds.log\fR(4), \fBrdc.cf\fR(4),