Content-type: text/html Man page of advfsstat

advfsstat

Section: Maintenance Commands (8)
Index Return to Main Contents
 

NAME

advfsstat - Displays AdvFS performance statistics  

SYNOPSIS

/sbin/advfs/advfsstat [options] [stats-type] domain

/sbin/advfs/advfsstat [options] -f 0|1|2 domain fileset


 

OPTIONS

The advfsstat command takes the following options: Specifies the time interval (in seconds) between displays. The advfsstat command collects and reports information only for the specified interval. If sec is omitted, advfsstat uses a default interval of one second. Specifies the number of reports. For example, setting the advfsstat command options -i 1 and -c 10 would produce 10 reports at 1 second intervals. If count is omitted, advfsstat returns one report. Displays raw statistics for the interval. Displays the percent ratio of the returned statistics. (Use only with the -b,-p, or -r flags.)

The following are the stats-type flags: Displays the buffer cache statistics for the selected domain. Displays all fileset vnop statistics for the selected fileset. Displays all fileset lookup statistics for the selected fileset. Displays common fileset vnop statistics. Displays basic lock statistics. Displays lock statistics. Displays detailed lock statistics. Displays namei cache statistics. Displays buffer cache pin statistics. Displays buffer cache ref statistics. Displays volume read/write statistics. Displays detailed volume statistics. Displays volume I/O queue statistics. Displays BMT Record read statistics. Displays BMT Record write/update statistics.
 

OPERANDS

Specifies the name of an existing domain. Specifies the name of an existing fileset.
 

DESCRIPTION

The advfsstat command displays a wide selection of AdvFS performance statistics. It reports in units of one disk block (512 bytes) per interval, with the default being one second.

Any number of options (listed in the OPTIONS section) may be used. The -R option may be specified only with the stats-types of -b, -p, and -r. The options -i and -c require parameters.

Only one stats-type (listed in the OPTIONS section) may be specified with the command. The -f, -l, -v, and -B stats-types require parameters. For the -f stats-type, the fileset operand must also be specified.

Depending on which options you specify, the following values are displayed:

No options specified:


HeadingDefinition

Derefnumber of refs
Unpinnumber of unpins
Lazynumber of unpin lazys
Refhitnumber of ref hits
Pinhitnumber of pin hits
Lognumber of unpin logs
Ubchitnumber of Unified Buffer Cache hits
UnpinMetanumber of unpin meta hits
DerefMetanumber of ref meta hits
Refhitwaitnumber of ref hit waits
Pinhitwaitnumber of pin hit waits
Blockingnumber of unpin blocking
Unconsolnumber of unconsolidated hits
UnpinFtx number of unpin flyweight transactions hits
DerefFtx number of ref flyweight transactions hits
R_aheadnumber of read-ahead buffers queued
Pinreadnumber of pin reads
Cleannumber of unpin cleans
ConsolAbortnumber of consol aborts
UnpinDatanumber of unpin data hits
DerefDatanumber of ref data hits
Diskincremental volume count
Readsnumber of reads on volume
Writesnumber of writes on volume
Rglobsnumber of consolidated reads on volume
AveRglob average number of consolidated reads on volume
Wglobsnumber of consolidated writes on volume
AveWgolb average number of consolidated writes on volume

Buffer cache information (-b flag):


HeadingDefinition

pin cnttotal number of pins
pin hitnumber of pin hits
pin hitwnumber of pin hit waits
pin readnumber of pin reads
ref cnttotal number of refs
ref hitnumber of ref hits
ref hitwnumber of ref hit waits
unpin lazynumber of unpin lazys
unpin blknumber of unpin blocking
unpin clnnumber of unpin cleans
unpin lognumber of unpin logs
ranumber of read-ahead buffers queued
ubcnumber of Unified Buffer Cache hits
cons unnumber of unconsolidated hits
cons abrtnumber of consol aborts

Fileset vnop information (-f 0 flag):


HeadingDefinition

lookupnumber of file lookups
createnumber of file creates
closenumber of file closes
getattrnumber of get attributes
setattrnumber of set attributes
readnumber of file reads
writenumber of file writes
mmapnumber of mmaps
fsyncnumber of file syncs
syncdatanumber of data syncs
removenumber of file removes
renamenumber of files renamed
readdirnumber of directory reads
mkdirnumber of make directories
rmdirnumber of remove directories
symlinknumber of symbolic links created
readlinknumber of links read
linknumber of links created
breadnumber of breads
brelsenumber of brelse
page_writenumber of page writes
page_readnumber of page reads
getpagenumber of pages retrieved
putpagenumber of pages returned

Fileset lookup information (-f 1 flag):


HeadingDefinition

lookuptotal number of file lookups
hitnumber of file lookup hits
hit %percentage of lookups which were hits
noentnumber of file lookup noents
noent %percentage of lookups which were noents
missnumber of file lookup misses
miss %percentage of lookups which were misses

Common fileset vnop information (-f 2 flag):


HeadingDefinition

lkupnumber of file lookups
crtnumber of file creates
getanumber of get attributes
readnumber of file reads
writnumber of file writes
fsncnumber of file syncs
dsncnumber of data syncs
rmnumber of file removes
mvnumber of file renamed
rdirnumber of directory reads
mkdnumber of make directories
rmdnumber of remove directories
linknumber of links created

Basic lock information (l 0 option):


HeadingDefinition

mutexnumber of mutex locks
waitnumber of wait locks
signumber of signal locks
bcastnumber of broadcast locks

Lock information (-l 1 flag):

Specifying the -l 1 flag displays a table of lock statistics with the following fields of information:


FieldDefinition

waitnumber of waits on lock
rwaitnumber of re-waits on lock
signlnumber of signals on lock
bcastnumber of broadcasts on lock
locknumber of locks

See the NOTES section for exceptions to the following lock information that is displayed for the fields above:


HeadingDefinition

mutexmutexes
genLkgeneric locks
stateLkstate locks
shrLkshared locks
excLkexclusive locks
bufStateLkbuffer state locks
pinBlkCvpin block condition variable
bfFlushCvbit file flush condition variable
ftxCvflyweight transactions condition variable
msgQCvmessage queue condition variable
totaltotal number

Detailed lock information (-l 2 flag):

Specifying the -l 2 flag repeats the table of lock statistics specified by the -l 1 flag and adds the following:


HeadingDefinition

LOG_DESClog descriptors locks
LOG_READ_STREAMlog read stream locks
BF_STATEbitfile state locks
BF_XTNT_MAPbitfile extents locks
BF_COWbitfile copy on write locks
BF_MCELL_LISTbitfile metadata cell list locks
BF_FLUSHbitfile flush locks
BUFFERbuffer locks
BF_SET_TBLset table locks
BF_SET_TAG_DIRset tag directory locks
VD_STG_MAPvirtual disk storage map locks
VD_MCELLSvirtual disk metadata cell locks
VD_PAGE0_MCELLS virtual disk page zero metadata cell locks
VD_MIG_MCELLSvirtual disk migrate metadata cell locks
VD_DEV_BUSYvirtual disk device busy locks
VD_ACTIVEvirtual disk active locks
VD_LAZY_BLOCKvirtual disk lazy blocking locks
WIRED_FREEwired free locks
RAW_BUF_FREEraw buffer free locks
INITinitialization locks
FS_BF_GETfileset bitfile get locks
unused22not used
unused23not used
unused24not used
FS_CONTEXT_SEMfileset context SEM locks
DQ_LOCKdisk quota locks
FILE_SET_LKfileset locks
DOMAIN_TBLdomain table locks
BF_SET_STATEbitfile set state locks
SERVICE_CLASS_TBLservice class table locks
BF_SHLVbitfile shelving locks
FS_FILEfileset file locks
ZAP_MCELLSdelete metadata cell locks
MOVE_METADATAmove metadata locks
MIG_TRUNCmigrate truncation locks
DDL_ACTIVEdeferred delete list active locks
DDL_ACTIVE_WAITdeferred delete list active wait locks
QUOTA_FILE_LOCKquota file locks
FRAG_BFfragment bitfile locks
BF_SET_SHLVbitfile set shelving locks
LKU_MSS_PQDHSM shelving pseudo queuer device locks
LKU_MSS_PQD_LOWPRI HSM shelving pseudo queuer device low priority locks

Namei information (-n flag):


HeadingDefinition

goodhgood hits, hits that can be used
neghnegative hits, hits that are still useable
badhbad hits, hits that must be dropped
falshfalse hits, hits with id mismatch
missmisses

Buffer cache pin information (-p flag):


HeadingDefinition

pin cnttotal number of pins
pin hitnumber of pin hits
pin hitwnumber of pin hit waits
pin readnumber of pin reads
pin lazynumber of unpin lazys
pin blknumber of unpin blocking
pin clnnumber of unpin cleans
pin lognumber of unpin logs
data bsFtx number of bitfile access subsystem flyweight transactions
data fsFtx number of file access subsystem flyweight transactions
data othernumber of other flyweight transactions

Buffer cache ref information (-r flag):


HeadingDefinition

ref cnttotal number of refs
ref hitnumber of ref hits
ref hitwnumber of ref hit waits
data bsFtx number of bitfile access subsystem flyweight transactions
data fsFtx number of file access subsystem flyweight transactions
data othernumber of other flyweight transactions

Volume read/write information (-v 0 flag):


HeadingDefinition

rdnumber of reads on volume
wrnumber of writes on volume

Detailed volume information (-v 1 flag):


HeadingDefinition

rdnumber of reads on volume
wrnumber of writes on volume
rgnumber of consolidated reads on volume
argaverage number of blocks per consolidated read on volume
wgnumber of consolidated writes on volume
awg average number of blocks per consolidated write on volume

Volume I/O queue information (-v 2 flag):


HeadingDefinition

rdnumber of reads on volume
wrnumber of writes on volume
rgnumber of consolidated reads on volume
argaverage number of blocks per consolidated read on volume
wgnumber of consolidated writes on volume
awg average number of blocks per consolidated write on volume
blkblocking queue requests on volume
wlzwait lazy queue requests on volume
rlzread lazy queue requests on volume
conconsol queue requests on volume
devdevice queue requests on volume


 

NOTES

The following lock information is hardcoded to zero:


HeadingLimitation

shrLkbcast is hard coded to 0.
bufStateLklock is hard coded to 0.
pinBlkCvlock is hard coded to 0.
bfFlushCvlock is hard coded to 0.
ftxCvlock is hard coded to 0.
msgQCvlock is hard coded to 0.
totalrwait is hard coded to 0.

The following lock information is incomplete:


HeadingLimitation

mutexonly lock field returned.
totallock field is not returned.


 

EXAMPLES

The following example specifies no options: # advfsstat test1_domain

Domain -803166491.546298- Stats -

Deref 9 Refhit 9 Refhitwait 0 R_ahead 0 Unpin 0 Pinhit 0 Pinhitwait 0 Pinreads 0 Lazy 0 Log 0 Blocking 0 Clean 0
            Ubchit     0   Unconsol    0    ConsolAbort  0
            UnpinMeta  0   UnpinFtx    0    UnpinData    0
            DerefMeta  9   DerefFtx    9    DerefData    0

Disk Reads Writes Rglobs AveRglob Wglobs AveWglob ---- ----- ------ ------ -------- ------ --------
   1      0       0       0          0        0          0 The following example displays buffer cache statistics for the requested domain on the system providing three reports in one second intervals: # advfsstat -c 3 -b data_domain

pin ref unpin-type misc cons cnt hit hitw read cnt hit hitw lazy blk cln log ra ubc un abrt
  0   0    0    0  10  10    0    0    0   0   0  0   0  0    0
  0   0    0    0   9   9    0    0    0   0   0  0   0  0    0
  0   0    0    0  11  11    0    0    0   0   0  0   0  0    0 The following example displays the raw data for the same example as above: # advfsstat -s -c 3 -b data_domain

pin ref unpin-type misc cons cnt hit hitw read cnt hit hitw lazy blk cln log ra ubc un abrt
 2M  2M  665    0  1M 946K  586   2M 51K  60 87K 37K 128K 2103    0
 2M  2M  667    0  1M 946K  589   2M 51K  60 87K 37K 128K 2104    0
 2M  2M  671    0  1M 946K  595   2M 51K  60 87K 37K 128K 2105    0 The following example shows the vnop statistics for the fileset named data which is part of the domain data_domain. The report is for a one minute interval: # advfsstat -i 60 -f 0 data_domain data

lookup 1419 create 1 close 175 getattr 1009 setattr 1
  read   461     write 15    mmap   2   fsync    0 syncdata 0 remove 2 rename 0 readdir 319 mkdir 0 rmdir 0 ymlink 0 readlink 0 link 0 bread 0 brelse 0 page_write 0 page_read 0 getpage 35 putpage 0 The following example displays basic lock statistics for the domain usr_domain: # advfsstat -l 1 usr_domain


                type  wait rwait signl bcast  lock
               mutex                             0
               genLk     0     0     0     0  3316
             stateLk     0     0     0     0   33K
               shrLk     0     0     0     0   202
               excLk     0     0     0     0    73
          bufStateLk  7319     0  7271    24     0
            pinBlkCv     0     0     0     0     0
           bfFlushCv    88     4   279     0     0
               ftxCv     0     0     0     0     0
              msgQCv   123     0   127     0     0
               total  7530     0  7677    24


 

SEE ALSO

Commands:  iostat(1)


 

Index

NAME
SYNOPSIS
OPTIONS
OPERANDS
DESCRIPTION
NOTES
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:40:42 GMT, October 02, 2010