advfsstat(8) System Manager's Manual advfsstat(8)
NAME
advfsstat - Displays AdvFS performance statistics
SYNOPSIS
/usr/sbin/advfsstat [options] [stats-type] domain
/usr/sbin/advfsstat [options] -f 0 | 1 | 2 domain fileset
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. If a count of- 0 is speci-
fied then a count of 1 is assumed. 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. Dis-
plays 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 smoothsync queue statistics. Displays volume read/write sta-
tistics. Displays detailed volume statistics. Displays volume I/O queue statistics as a snapshot of everything that is currently on the
queue. Displays volume I/O queue statistics for everything that was put onto the queue in the -i option time interval. This is the same
display as for -v 2, with different data. 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 may be used. The -R option may be specified only with the stats-type of -b, -p, and -r. The options -i and -c
require parameters.
Only one stats-type may be specified with the command. The -f, -l, -v, and -B stats-type require parameters. For the -f stats-type, the
fileset operand must also be specified.
The following tables define the attributes displayed under the given heading:
No options specified:
-------------------------------------------------------
Heading Definition
-------------------------------------------------------
Deref number of refs
Unpin number of unpins
Lazy number of unpin lazys
Refhit number of ref hits
Pinhit number of pin hits
Log number of unpin logs
Ubchit number of Unified Buffer Cache hits
UnpinMeta number of unpin meta hits
DerefMeta number of ref meta hits
Refhitwait number of ref hit waits
Pinhitwait number of pin hit waits
Blocking number of unpin blocking
Unconsol number of unconsolidated hits
UnpinFtx number of unpin flyweight transactions
hits
DerefFtx number of ref flyweight transactions
hits
R_ahead number of read-ahead buffers queued
Pinread number of pin reads
Clean number of unpin cleans
ConsolAbort number of consol aborts
UnpinData number of unpin data hits
DerefData number of ref data hits
Disk incremental volume count
Reads number of reads on volume
Writes number of writes on volume
Rglobs number of consolidated reads on volume
AveRglob average number of consolidated reads on
volume
Wglobs number of consolidated writes on volume
AveWgolb average number of consolidated writes on
volume
-------------------------------------------------------
Buffer cache information (-b flag):
-------------------------------------------------
Heading Definition
-------------------------------------------------
pin cnt total number of pins
pin hit number of pin hits
pin hitw number of pin hit waits
pin read number of pin reads
ref cnt total number of refs
ref hit number of ref hits
ref hitw number of ref hit waits
unpin lazy number of unpin lazys
unpin blk number of unpin blocking
unpin cln number of unpin cleans
unpin log number of unpin logs
ra number of read-ahead buffers queued
ubc number of Unified Buffer Cache hits
cons un number of unconsolidated hits
cons abrt number of consol aborts
-------------------------------------------------
Fileset vnop information (-f 0 flag):
----------------------------------------------
Heading Definition
----------------------------------------------
lookup number of file lookups
create number of file creates
close number of file closes
getattr number of get attributes
setattr number of set attributes
read number of file reads
write number of file writes
mmap number of mmaps
fsync number of file syncs
syncdata number of data syncs
remove number of file removes
rename number of files renamed
readdir number of directory reads
mkdir number of make directories
rmdir number of remove directories
symlink number of symbolic links created
readlink number of links read
link number of links created
bread number of breads
brelse number of brelse
page_write number of page writes
page_read number of page reads
getpage number of pages retrieved
putpage number of pages returned
----------------------------------------------
Fileset lookup information (-f 1 flag):
--------------------------------------------------
Heading Definition
--------------------------------------------------
lookup total number of file lookups
hit number of file lookup hits
hit % percentage of lookups that were hits
noent number of file lookup noents
noent % percentage of lookups that were noents
miss number of file lookup misses
miss % percentage of lookups that were misses
--------------------------------------------------
Common fileset vnop information (-f 2 flag):
---------------------------------------
Heading Definition
---------------------------------------
lkup number of file lookups
crt number of file creates
geta number of get attributes
read number of file reads
writ number of file writes
fsnc number of file syncs
dsnc number of data syncs
rm number of file removes
mv number of file renamed
rdir number of directory reads
mkd number of make directories
rmd number of remove directories
link number of links created
---------------------------------------
Basic lock information (l 0 option):
------------------------------------
Heading Definition
------------------------------------
mutex number of mutex locks
wait number of wait locks
sig number of signal locks
bcast number of broadcast locks
------------------------------------
Lock information (-l 1 flag):
-------------------------------------
Field Definition
-------------------------------------
wait number of waits on lock
rwait number of re-waits on lock
signl number of signals on lock
bcast number of broadcasts on lock
lock number of locks
-------------------------------------
See the NOTES section for exceptions to the following lock information that is displayed for the fields above:
-------------------------------------------------------
Heading Definition
-------------------------------------------------------
mutex mutexes
genLk generic locks
stateLk state locks
shrLk shared locks
excLk exclusive locks
bufStateLk buffer state locks
pinBlkCv pin block condition variable
bfFlushCv bit file flush condition variable
ftxCv flyweight transactions condition variable
msgQCv message queue condition variable
total total number
-------------------------------------------------------
Detailed lock information (-l 2 flag) adds the following to the lock statistics specified by the -l 1 flag:
--------------------------------------------------------------
Heading Definition
--------------------------------------------------------------
LOG_DESC log descriptors locks
LOG_READ_STREAM log read stream locks
BF_STATE bitfile state locks
BF_XTNT_MAP bitfile extents locks
BF_COW bitfile copy on write locks
BF_MCELL_LIST bitfile metadata cell list locks
BF_FLUSH bitfile flush locks
BUFFER buffer locks
BF_SET_TBL set table locks
BF_SET_TAG_DIR set tag directory locks
VD_STG_MAP virtual disk storage map locks
VD_MCELLS virtual disk metadata cell locks
VD_PAGE0_MCELLS virtual disk page zero metadata cell
locks
VD_MIG_MCELLS virtual disk migrate metadata cell locks
VD_DEV_BUSY virtual disk device busy locks
VD_ACTIVE virtual disk active locks
VD_LAZY_BLOCK virtual disk lazy blocking locks
WIRED_FREE wired free locks
RAW_BUF_FREE raw buffer free locks
INIT initialization locks
FS_BF_GET fileset bitfile get locks
unused22 not used
unused23 not used
unused24 not used
FS_CONTEXT_SEM fileset context SEM locks
DQ_LOCK disk quota locks
FILE_SET_LK fileset locks
DOMAIN_TBL domain table locks
BF_SET_STATE bitfile set state locks
SERVICE_CLASS_TBL service class table locks
BF_SHLV bitfile shelving locks
FS_FILE fileset file locks
ZAP_MCELLS delete metadata cell locks
MOVE_METADATA move metadata locks
MIG_TRUNC migrate truncation locks
DDL_ACTIVE deferred delete list active locks
DDL_ACTIVE_WAIT deferred delete list active wait locks
QUOTA_FILE_LOCK quota file locks
FRAG_BF fragment bitfile locks
BF_SET_SHLV bitfile set shelving locks
LKU_MSS_PQD HSM shelving pseudo queuer device locks
LKU_MSS_PQD_LOWPRI HSM shelving pseudo queuer device low
priority locks
--------------------------------------------------------------
Namei information (-n flag):
-----------------------------------------------------
Heading Definition
-----------------------------------------------------
goodh good hits, hits that can be used
negh negative hits, hits that are still useable
badh bad hits, hits that must be dropped
falsh false hits, hits with id mismatch
miss misses
-----------------------------------------------------
Buffer cache pin information (-p flag):
------------------------------------------------------------------
Heading Definition
------------------------------------------------------------------
pin cnt total number of pins
pin hit number of pin hits
pin hitw number of pin hit waits
pin read number of pin reads
pin lazy number of unpin lazys
pin blk number of unpin blocking
pin cln number of unpin cleans
pin log number of unpin logs
data bsFtx number of bitfile access subsystem flyweight trans-
actions
data fsFtx number of file access subsystem flyweight transac-
tions
data other number of other flyweight transactions
------------------------------------------------------------------
Buffer cache ref information (-r flag):
------------------------------------------------------------------
Heading Definition
------------------------------------------------------------------
ref cnt total number of refs
ref hit number of ref hits
ref hitw number of ref hit waits
data bsFtx number of bitfile access subsystem flyweight trans-
actions
data fsFtx number of file access subsystem flyweight transac-
tions
data other number of other flyweight transactions
------------------------------------------------------------------
Volume read/write information (-v 0 flag):
-------------------------------------
Heading Definition
-------------------------------------
rd number of reads on volume
wr number of writes on volume
-------------------------------------
Detailed volume information (-v 1 flag):
-------------------------------------------------------------------
Heading Definition
-------------------------------------------------------------------
rd number of reads on volume
wr number of writes on volume
rg number of consolidated reads on volume
arg average number of blocks per consolidated read on volume
wg number of consolidated writes on volume
awg average number of blocks per consolidated write on vol-
ume
-------------------------------------------------------------------
Volume I/O queue information (-v 2 and -v 3 flags):
-------------------------------------------------------------------
Heading Definition
-------------------------------------------------------------------
rd number of reads on volume
wr number of writes on volume
rg number of consolidated reads on volume
arg average number of blocks per consolidated read on volume
wg number of consolidated writes on volume
awg average number of blocks per consolidated write on vol-
ume
blk blocking queue requests on volume
flsh flush queue requests on volume
wlz wait lazy queue requests on volume
sms smooth sync queue requests
rlz ready lazy queue requests on volume
con consol queue requests on volume
dev device queue requests on volume
-------------------------------------------------------------------
NOTES
The following lock information is hardcoded to zero:
---------------------------------------
Heading Limitation
---------------------------------------
shrLk bcast is hard coded to 0.
bufStateLk lock is hard coded to 0.
pinBlkCv lock is hard coded to 0.
bfFlushCv lock is hard coded to 0.
ftxCv lock is hard coded to 0.
msgQCv lock is hard coded to 0.
total rwait is hard coded to 0.
---------------------------------------
The following lock information is incomplete:
--------------------------------------
Heading Limitation
--------------------------------------
mutex only lock field returned.
total lock 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 The following example shows a partial display of I/O queue statistics at 1-second intervals
during a test that writes some data and then does an fsync: # advfsstat -i 1 -v 3 data_domain vol 1
rd wr rg arg wg awg blk flsh wiz sms rlz con dev
0 0 0 0 0 0 0 0 0 0 0 0 0
0 2 0 0 2 120 15 0 23K 23K 0 0 0
0 63 0 0 59 233 15 0 9K 9K 16K 16K 849
0 55 0 0 53 252 2 0 1K 1K 1K 1K 836
0 52 0 0 51 241 3 0 1K 1K 1K 1K 768
0 53 0 0 52 242 3 0 1K 1K 1K 1K 787
0 73 0 0 72 238 3 7K 1K 1K 1K 1K 1K
0 41 0 0 40 235 0 7K 128 128 4 0 590
0 51 0 0 51 235 0 0 0 0 0 0 750
0 60 0 0 56 232 0 0 0 0 0 4 816
SEE ALSO
Commands: iostat(1)
advfsstat(8)