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)

Featured Tech Videos