System Administration Commands dsstat(1M)
NAME
dsstat - report Sun StorageTek Availability Suite I/O
statistics
SYNOPSIS
dsstat -m mode [-r report-options] [-d display-options]
[-s volume-sets] [-f -F] [-z] [interval [count]
DESCRIPTION
The dsstat command collects and reports I/O statistics for
the Sun StorageTek Availability Suite products.
OPTIONS
The dsstat supports the following options:
-m mode
Specifies the mode(s) of operation. Valid modes are:
cache
Cache statistics
ii
Point-in-Time Copy statistics
sndr
Remote Mirror statistics
To display statistics for multiple services simultane-
ously, use the -m switch to specify each of the modes
required. For example:
% dsstat -m ii -m sndr
% dsstat -m ii -m sndr -m cache
To determine which statistics are being reported from
which service, use the role field, described below. When
cache statistics are requested as one of the multiple
services, the rkps and wkps statistics is further
divided into crkps, drkps, cwkps, and dwkps. If no -m
switch is specified, then dsstat displays default
statistics for all of the valid modes as described
above. See "Field Descriptions," below for descriptions
of these fields.
SunOS 5.11 Last change: 2 Oct 2007 1
System Administration Commands dsstat(1M)
-r report-options
Specifies the volume components to be displayed. Each
item is represented by a single character, and multiple
items can be selected. The report-options vary based on
the mode(s) specified above. This option is not used for
cache mode.
Valid report-options for ii mode are:
m Master volume statistics.
o For the "report-options for ii
mode": m, s, b, o
o For the "report-options for sndr
mode": b, n
o For the "display-options for cache
mode": r, w, d, c, s, f
o For the "display-options for ii
mode": r, w, t, s, p, f
s Shadow volume statistics.
b Bitmap volume statistics.
o Overflow volume statistics, if attached.
Valid report-options for sndr mode are:
b Bitmap volume statistics.
n Network volume statistics.
-d display-options
Specifies the statistics to be displayed. The types of
statistics are represented by a single character; multi-
ple types can be specified.
For cache mode, the valid display-options are:
r Detailed read statistics.
SunOS 5.11 Last change: 2 Oct 2007 2
System Administration Commands dsstat(1M)
w Detailed write statistics.
s Summary statistics.
f Cache behavior flags.
The following display-options are available only for
cache mode, they need to be combined with the mode
options (-m)
d Destaged data statistics.
c Write cancellation statistics.
The default display-options for cache are sf.
For ii mode, the valid display-options are:
r
Detailed read statistics.
w
Detailed write statistics.
t
Timing statistics.
s
Summary statistics.
p
Percentage of volume requiring sync.
f
Volume type/status flags.
The default display-options for ii are spf. For sndr
mode, the valid display-options are:
SunOS 5.11 Last change: 2 Oct 2007 3
System Administration Commands dsstat(1M)
r Detailed read statistics.
w Detailed write statistics.
t Timing statistics.
s Summary statistics.
p Percentage of volume requiring sync.
f Volume type/status flags.
q Asynchronous queue statistics.
The following display-option is only available for sndr
mode, and needs to be combined with the mode options (-
m).
q Asynchronous queue statistics.
The default display-options for sndr are spf.
Specifying the summary display-option causes r w t
display-options to be ignored.
-s volume-sets Filters the output to include only the
specified volume-sets, where volume-sets
is a comma-delimited list of volume
names. When displaying Remote Mirror
statistics, the name specified is com-
pared to the Remote Mirror primary
volume to determine if they match. Addi-
tionally, an Remote Mirror volume should
be specified as : where
is the primary or secondary host
and is the volume name by which
that host recognizes the volume set.
When specifying multiple Remote Mirror
volumes sets, be aware that each volume
set specified is evaluated individually,
using the rules above. When displaying
Point-in-Time Copy statistics, the
volume name specified is compared to the
Point-in-Time Copy shadow volume to
determine if they match.
SunOS 5.11 Last change: 2 Oct 2007 4
System Administration Commands dsstat(1M)
-f Output field headers at every reporting
cycle.
-F Output field headers once, when report-
ing begins.
-z Suppress report lines that have zero
values or no activity.
OPERANDS
The dsstat command line supports the following operands:
interval
Specifies the interval for each report, in seconds. If
no interval is specified, a single report with a one
second interval is output.
Due to the varying number of entries in a given set and
the varying number of sets, header information might
appear in the middle of a set being reported. To avoid
this, use the -f or -F options to display the header
information at the desired time.
count
Specifies the number of reports to generate. If no count
is specified, output continues until interrupted.
Field Descriptions
Unless otherwise specified, all fields are per-second aver-
ages based on the data collected during the specified inter-
val.
name Name of the entity being reported
t Volume type
s Volume status
r Cache read behavior
SunOS 5.11 Last change: 2 Oct 2007 5
System Administration Commands dsstat(1M)
w Cache write behavior
pct Percentage of volume requiring sync
role Role of the item being reported
tps Total number of reads ] writes
rtps Number of reads
wtps Number of writes
kps Total kilobytes read ] written
rkps Kilobytes read
wkps Kilobytes written
crkps Kilobytes read from cache
drkps Kilobytes read from disk
cwkps Kilobytes written to cache
dwkps Kilobytes written to disk
ckps Kilobytes transferred to or from cache
dkps Kilobytes transferred to or from disk
svt Service time per operation
hit Read hits during interval
SunOS 5.11 Last change: 2 Oct 2007 6
System Administration Commands dsstat(1M)
ds/s Kilobytes destaged from cache
cn/s Number of write cancellations
q Type of asynchronous queuing being used
qi Number of items currently queued
qk Kilobytes currently queued
qhwi High water mark of queued items
qhwk High water mark of queued kilobytes
The name field displays only the last 16 characters of the
name.
Valid cache behaviors for cache are:
C Cache reads/writes
D Disk reads/writes
Valid volume types for ii are:
I Independent shadow volume
D Dependent shadow volume
Valid volume status for ii is:
C Copy in progress
- No copy in progress
SunOS 5.11 Last change: 2 Oct 2007 7
System Administration Commands dsstat(1M)
Valid volume types for sndr are:
P This is the primary host of this volume set
S This is the secondary host of this volume set
Valid volume status for sndr is:
L Changes to this volume are being logged
Q Volume are in queuing mode
R Replicating changes to secondary
SY Synchronization in progress. Sending data.
RS Reverse synchronization in progress. Receiving
data.
SN Synchronization needed
RN Reverse synchronization needed
VF Volume failed
BF Bitmap failed
QF Queue failed
Valid queue types for sndr are:
D Disk-based queuing enabled
M Memory-based queuing enabled
SunOS 5.11 Last change: 2 Oct 2007 8
System Administration Commands dsstat(1M)
Volume roles for sndr are:
net Network volume statistics
bmp Bitmap volume statistics
Volume roles for ii are:
mst Master volume statistics
shd Shadow volume statistics
bmp Bitmap volume statistics
ovr Overflow volume statistics
EXAMPLES
Example 1 Report Cache Statistics
The following example shows the display of Report Cache
statistics, with detailed breakdowns of read and writes to
cache/disk. Reports are generated at five second intervals.
Reporting is limited to the set /dev/rdsk/c1t1d0s0.
# dsstat -m cache -d rw -s /dev/rdsk/c1t1d0s0 5
- read - - write -
name ckps dkps hit ckps dkps hit
dev/rdsk/c1t1d0s0 0 0 0.00 0 0 0.00
dev/rdsk/c1t1d0s0 3 2396 0.13 983 763 100.00
dev/rdsk/c1t1d0s0 2399 799 75.00 2815 2686 100.00
dev/rdsk/c1t1d0s0 3200 800 80.00 2755 2908 100.00
dev/rdsk/c1t1d0s0 3999 799 83.33 2809 2868 100.00
dev/rdsk/c1t1d0s0 4800 800 85.71 2867 2931 100.00
Example 2 Report Master, Shadow and Bitmap Statistics
Report master, shadow and bitmap statistics for Point-in-
Time Copy, using default output. Generate reports at two
second intervals.
SunOS 5.11 Last change: 2 Oct 2007 9
System Administration Commands dsstat(1M)
# dsstat -m ii -r msb 2
name t s pct role kps tps svt
dev/rdsk/c0t1d0s5 I C 96.15 mst 19921 38 22
dev/rdsk/c0t1d0s6 shd 9960 19 20
dev/rdsk/c0t1d0s7 bmp 39 77 2
dev/rdsk/c0t1d0s5 I C 94.24 mst 19623 38 22
dev/rdsk/c0t1d0s6 shd 9939 19 20
dev/rdsk/c0t1d0s7 bmp 39 77 2
dev/rdsk/c0t1d0s5 I C 92.34 mst 19969 39 22
dev/rdsk/c0t1d0s6 shd 9984 19 20
dev/rdsk/c0t1d0s7 bmp 39 78 2
Example 3 Report Network Statistics for Remote Mirror
Report network statistics for Remote Mirror, using detailed
read, write statistics. Report includes volume type/status
flags and percentages. Generate reports at two second inter-
vals. Limit reporting to the set /dev/rdsk/c0t1d0s0.
# dsstat -m sndr -r n -d rwpf -s /dev/rdsk/c0t1d0s0 2
name t s pct role rkps rtps wkps wtps
dev/rdsk/c0t1d0s0 P L 100.00 sec 0 0 0 0
dev/rdsk/c0t1d0s0 P SY 99.90 sec 0 0 288 9
dev/rdsk/c0t1d0s0 P SY 97.90 sec 0 0 5296 165
dev/rdsk/c0t1d0s0 P SY 95.81 sec 0 0 5184 161
dev/rdsk/c0t1d0s0 P SY 93.81 sec 0 0 5280 164
dev/rdsk/c0t1d0s0 P SY 91.71 sec 0 0 5198 162
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 Successful completion, no statistics to report.
2 An invalid argument has been encountered.
3 No memory is available to create kstat statis-
tics.
4 An unknown error has occurred.
SunOS 5.11 Last change: 2 Oct 2007 10
System Administration Commands dsstat(1M)
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWscmr, SUNWscmu
Interface Stability Evolving
SEE ALSO
dscfg(1M), svadm(1M), ds.log(4), rdc.cf(4), attributes(5)
SunOS 5.11 Last change: 2 Oct 2007 11
|
