Content-type: text/html
advfsstat - Displays AdvFS performance statistics
/sbin/advfs/advfsstat [options] [stats-type] domain
/sbin/advfs/advfsstat [options] -f 0|1|2 domain fileset
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.
Specifies the name of an existing domain.
Specifies the name of an existing fileset.
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:
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 which were hits |
noent | number of file lookup noents |
noent % | percentage of lookups which were noents |
miss | number of file lookup misses |
miss % | percentage of lookups which 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):
Specifying the -l 1 flag displays a table of lock statistics with the following fields of information:
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):
Specifying the -l 2 flag repeats the table of lock statistics specified by the -l 1 flag and adds the following:
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
transactions
|
data fsFtx |
number of file access subsystem flyweight
transactions
|
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
transactions
|
data fsFtx |
number of file access subsystem flyweight
transactions
|
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 volume
|
Volume I/O queue information (-v 2 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 volume
|
blk | blocking queue requests on volume |
wlz | wait lazy queue requests on volume |
rlz | read lazy queue requests on volume |
con | consol queue requests on volume |
dev | device queue requests on volume |
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. |
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
Commands: iostat(1)