*** UNIX MANUAL PAGE BROWSER ***

advfsstat(8) System Manager's Manual advfsstat(8) NAME advfsstat - Displays AdvFS performance statistics SYNOPSIS /sbin/advfs/advfsstat [options] [stats-type] domain /sbin/advfs/advfsstat [options] -f 0 | 1 | 2 domain fileset Specifies the name of an existing domain. Specifies the name of an ex- isting fileset. FLAGS 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 flags -i 1 and -c 10 would produce 10 reports at 1 second intervals. If count is omitted, advfsstat returns one report. Displays raw sta- tistics 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 sta- tistics 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 de- tailed lock statistics. Displays namei cache statistics. Displays buffer cache pin statistics. Displays buffer cache ref statistics. Displays volume read/write statistics. Displays detailed volume sta- tistics. Displays volume I/O queue statistics. Displays BMT Record read statistics. Displays BMT Record write/update statistics. DESCRIPTION The advfsstat command displays a wide selection of AdvFS performance statistics. It reports in units of one disk block (512 bytes) per in- terval, with the default being one second. Any number of options (listed in the FLAGS 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 FLAGS section) may be specified with the command. The -f, -l, -v, and -B stats-types require parameters. For the -f stats-type, the fileset parameter must also be specified. Depending on which flags you specify, the following values are dis- played: No flags specified: tab(@); lfHB lfHB l lw(2.5i). _ Heading@Definition _ Deref@T{ number of refs T} Unpin@T{ number of unpins T} Lazy@T{ number of unpin lazys T} Refhit@T{ number of ref hits T} Pinhit@T{ number of pin hits T} Log@T{ number of unpin logs T} Ubchit@T{ number of Unified Buffer Cache hits T} UnpinMeta@T{ number of unpin meta hits T} DerefMeta@T{ number of ref meta hits T} Refhitwait@T{ number of ref hit waits T} Pinhitwait@T{ number of pin hit waits T} Blocking@T{ number of unpin blocking T} Unconsol@T{ number of unconsolidated hits T} Unpin- Ftx@T{ number of unpin flyweight transactions hits T} DerefFtx@T{ num- ber of ref flyweight transactions hits T} R_ahead@T{ number of read- ahead buffers queued T} Pinread@T{ number of pin reads T} Clean@T{ num- ber of unpin cleans T} ConsolAbort@T{ number of consol aborts T} Unpin- Data@T{ number of unpin data hits T} DerefData@T{ number of ref data hits T} Disk@T{ incremental volume count T} Reads@T{ number of reads on volume T} Writes@T{ number of writes on volume T} Rglobs@T{ number of consolidated reads on volume T} AveRglob@T{ average number of consoli- dated reads on volume T} Wglobs@T{ number of consolidated writes on volume T} AveWgolb@T{ average number of consolidated writes on volume T} _ Buffer cache information (-b flag): tab(@); lfHB lfHB l l. _ 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): tab(@); lfHB lfHB l l. _ Heading@Definition _ lookup@number of file lookups create@number of file creates close@num- ber 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 re- trieved putpage@number of pages returned _ Fileset lookup information (-f 1 flag): tab(@); lfHB lfHB l l. _ 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): tab(@); lfHB lfHB l l. _ 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 flag): tab(@); lfHB lfHB l l. _ 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: tab(@); lfHB lfHB l l. _ 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: tab(@); lfHB lfHB l l. _ 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: tab(@); lfHB lfHB l lw(3.0i). _ Heading@Definition _ LOG_DESC@T{ log descriptors locks T} LOG_READ_STREAM @T{ log read stream locks T} BF_STATE@T{ bitfile state locks T} BF_XTNT_MAP@T{ bit- file extents locks T} BF_COW@T{ bitfile copy on write locks T} BF_MCELL_LIST@T{ bitfile metadata cell list locks T} BF_FLUSH@T{ bit- file flush locks T} BUFFER@T{ buffer locks T} BF_SET_TBL@T{ set table locks T} BF_SET_TAG_DIR@T{ set tag directory locks T} VD_STG_MAP@T{ virtual disk storage map locks T} VD_MCELLS@T{ virtual disk metadata cell locks T} VD_PAGE0_MCELLS@T{ virtual disk page zero metadata cell locks T} VD_MIG_MCELLS@T{ virtual disk migrate metadata cell locks T} VD_DEV_BUSY@T{ virtual disk device busy locks T} VD_ACTIVE@T{ virtual disk active locks T} VD_LAZY_BLOCK@T{ virtual disk lazy blocking locks T} WIRED_FREE@T{ wired free locks T} RAW_BUF_FREE@T{ raw buffer free locks T} INIT@T{ initialization locks T} FS_BF_GET@T{ fileset bitfile get locks T} unused22@T{ not used T} unused23@T{ not used T} un- used24@T{ not used T} FS_CONTEXT_SEM@T{ fileset context SEM locks T} DQ_LOCK@T{ disk quota locks T} FILE_SET_LK@T{ fileset locks T} DO- MAIN_TBL@T{ domain table locks T} BF_SET_STATE@T{ bitfile set state locks T} SERVICE_CLASS_TBL@T{ service class table locks T} BF_SHLV@T{ bitfile shelving locks T} FS_FILE@T{ fileset file locks T} ZAP_MCELLS@T{ delete metadata cell locks T} MOVE_METADATA@T{ move meta- data locks T} MIG_TRUNC@T{ migrate truncation locks T} DDL_ACTIVE@T{ deferred delete list active locks T} DDL_ACTIVE_WAIT@T{ deferred delete list active wait locks T} QUOTA_FILE_LOCK@T{ quota file locks T} FRAG_BF@T{ fragment bitfile locks T} BF_SET_SHLV@T{ bitfile set shelv- ing locks T} LKU_MSS_PQD@T{ HSM shelving pseudo queuer device locks T} LKU_MSS_PQD_LOWPRI@T{ HSM shelving pseudo queuer device low priority locks T} _ Namei information (-n flag): tab(@); lfHB lfHB l l. _ 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): tab(@); lfHB lfHB l lw(3.0i). _ Heading@Definition _ pin cnt@T{ total number of pins T} pin hit@T{ number of pin hits T} pin hitw@T{ number of pin hit waits T} pin read@T{ number of pin reads T} pin lazy@T{ number of unpin lazys T} pin blk@T{ number of unpin block- ing T} pin cln@T{ number of unpin cleans T} pin log@T{ number of unpin logs T} data bsFtx@T{ number of bitfile access subsystem flyweight transactions T} data fsFtx@T{ number of file access subsystem flyweight transactions T} data other@T{ number of other flyweight transactions T} _ Buffer cache ref information (-r flag): tab(@); lfHB lfHB l lw(3.0i). _ Heading@Definition _ ref cnt@T{ total number of refs T} ref hit@T{ number of ref hits T} ref hitw@T{ number of ref hit waits T} data bsFtx@T{ number of bitfile ac- cess subsystem flyweight transactions T} data fsFtx@T{ number of file access subsystem flyweight transactions T} data other@T{ number of other flyweight transactions T} _ Volume read/write information (-v 0 flag): tab(@); lfHB lfHB l l. _ Heading@Definition _ rd@number of reads on volume wr@number of writes on volume _ Detailed volume information (-v 1 flag): tab(@); lfHB lfHB l l. _ 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 con- solidated 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): tab(@); lfHB lfHB l l. _ 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 consoli- dated read on volume wg@number of consolidated writes on volume awg@av- erage 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 _ EXAMPLES The following example specifies no flags: # 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 re- quested domain on the system providing three reports in one second in- tervals: # 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 read- link 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 NOTES The following lock information is hardcoded to zero: tab(@); lfHB lfHB l l. _ 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. to- tal@rwait is hard coded to 0. _ The following lock information is incomplete: tab(@); lfHB lfHB l l. _ Heading@Limitation _ mutex@only lock field returned. total@lock field is not returned. _ RELATED INFORMATION Commands: iostat(1) delim off advfsstat(8)