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 simultaneously, 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.

-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.

• For the “report-options for ii mode”: m, s, b, o

• For the “report-options for sndr mode”: b, n

• For the “display-options for cache mode”: r, w, d, c, s, f

• 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; multiple types can be specified.

For cache mode, the valid display-options are:

r

Detailed read statistics.

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:

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 compared to the Remote Mirror primary volume to determine if they match. Additionally, an Remote Mirror volume should be specified as <host>:<volume> where <host> is the primary or secondary host and <volume> 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.

-f

Output field headers at every reporting cycle.

-F

Output field headers once, when reporting 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 averages based on the data collected during the specified interval.

name

Name of the entity being reported

t

Volume type

s

Volume status

r

Cache read behavior

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

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

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

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.

# 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 intervals. 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 statistics.

4

An unknown error has occurred.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

dscfg(1M), svadm(1M), ds.log(4), rdc.cf(4), attributes(5)