 |
Index for
Section 8 |
|
 |
Alphabetical
listing for A |
|
 |
Bottom of
page |
|
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
-i sec
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.
-c count
Specifies the number of reports. If a count of 0 is specified then a
count of 1 is assumed. If count is omitted, advfsstat returns one
report.
-s Displays raw statistics for the interval.
-R Displays the percent ratio of the returned statistics. (Use only with
the -b,-p, or -r flags.)
The following are the stats-type flags:
-b Displays the buffer cache statistics for the selected domain.
-f 0
Displays all fileset vnop statistics for the selected fileset.
-f 1
Displays all fileset lookup statistics for the selected fileset.
-f 2
Displays common fileset vnop statistics.
-l 0
Displays basic lock statistics.
-l 1
Displays lock statistics.
-l 2
Displays detailed lock statistics.
-n Displays namei cache statistics.
-p Displays buffer cache pin statistics.
-r Displays buffer cache ref statistics.
-S Displays smoothsync queue statistics.
-v 0
Displays volume read/write statistics.
-v 1
Displays detailed volume statistics.
-v 2
Displays volume I/O queue statistics as a snapshot of everything that
is currently on the queue.
-v 3
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.
-B r
Displays BMT Record read statistics.
-B w
Displays BMT Record write/update statistics.
OPERANDS
domain
Specifies the name of an existing domain.
fileset
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
AveWglob
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
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 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
volume
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
1. 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
2. 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
3. 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
4. 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
5. 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
6. 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 ubcr flsh wiz sms rlz con dev
0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 2 0 0 2 120 15 0 0 23K 23K 0 0 0
0 63 0 0 59 233 15 0 0 9K 9K 16K 16K 849
0 55 0 0 53 252 2 0 0 1K 1K 1K 1K 836
0 52 0 0 51 241 3 0 0 1K 1K 1K 1K 768
0 53 0 0 52 242 3 0 0 1K 1K 1K 1K 787
0 73 0 0 72 238 3 0 7K 1K 1K 1K 1K 1K
0 41 0 0 40 235 0 0 7K 128 128 4 0 590
0 51 0 0 51 235 0 0 0 0 0 0 0 750
0 60 0 0 56 232 0 0 0 0 0 0 4 816
7. The following example shows the results of using the BMT read
operation with a count of six reports at five second intervals.
# ./advfsstat -i 5 -c 6 -B r q_domain
BMTR_FS_STAT= 0
BMTR_FS_STAT= 0
BMTR_FS_STAT= 0
BMTR_FS_STAT= 0
BMTR_FS_STAT= 0
BMTR_FS_STAT= 0
8. The following example shows the results of using the BMT write/update
operation with a count of seven reports at five second intervals.
# ./advfsstat -i 5 -c 7 -B w q_domain
BMTR_FS_STAT= 0
BMTR_FS_STAT= 0
BMTR_FS_STAT= 0
BMTR_FS_STAT= 208 BSR_ATTR= 17 BSR_BFS_ATTR= 103 BSR_BF_INHERIT_ATTR= 17
BMTR_FS_STAT= 328 BSR_ATTR= 61 BSR_BFS_ATTR= 174 BSR_BF_INHERIT_ATTR= 61
BMTR_FS_STAT= 341 BSR_ATTR= 11 BSR_BFS_ATTR= 304 BSR_BF_INHERIT_ATTR= 11
BMTR_FS_STAT= 299 BSR_ATTR= 62 BSR_BFS_ATTR= 61 BSR_BF_INHERIT_ATTR= 62
SEE ALSO
Commands: iostat(1)
|
Index for
Section 8 |
|
|
Alphabetical
listing for A |
|
 |
Top of
page |
|