vxfsstat - display VxFS file system statistics

vxfsstat [ -aCgsvxz ] [ -e columns ] [ -c count ]
[-t seconds ] mount_point

vxfsstat [ -abi ] [-c count ] [-t seconds ] mount_point

vxfsstat [ -w outfile ] [-c count ] [-t seconds ] mount_point

vxfsstat -r infile [ -aCgsvxz ] [ -e columns ]

VRTSvxfs

vxfsstat is a statistical reporter to aid in performance tuning and determining performance anomalies. vxfsstat gathers buffer cache, inode cache, DNLC (directory name lookup cache), per-CPU statistics, per-file system statistics for local and cluster mounted file system, and global cluster file system counters.

The mount_point specifies any VxFS file system mount point. mount_point is used as an ioctl entry point to access the statistics maintained by the VxFS kernel.

The vxfsstat command was introduced to provide a diagnostic and tuning tool for knowledgeable VxFS file system users. The command is still under development and may undergo significant additions and changes. There is a strong possibility that functionality introduced and modified in future versions will not be completely backward compatible. Take this into account when you begin using this command and incorporating it into scripts. As an alternative, consider using the static interfaces vxfsu_get_bc_counters and vxfsu_get_dnlc_counter. These APIs are in the vxfsutil.h header file.

Some options can be used only on cluster mounted file systems. Read the option descriptions for details on whether the option is valid for local mounts.

-a	Displays absolute values.
-b	Displays buffer cache statistics.
-c count	Specifies the number of samples to take.
-C	Displays per-CPU statistics.
-e columns	Selects the number of column entries to display per line of output. The default is two columns. -e does not affect all output formats.
-g	Displays cluster file system global statistics. Not valid on non-cluster (local) mounted file systems.
-i	Displays inode cache and DNLC statistics. -i is the default output format.
-r infile	Replays output from the specified file infile. You can create output files using the -w option.
-v	Displays VxFS shared counters and statistics.
-s	Displays per-file system statistics for cluster file systems. Not valid on non-cluster (local) mounted file systems.
-t seconds	Specifies the duration of the sampling interval in seconds.
-w outfile	Appends output to the specified file outfile. vxfsstat can be invoked multiple times with the same file to collect multiple samples. The -w option can only be used with the -c and -t options.
-x	Displays per-file system VxFS statistics.
-z	Displays only non-zero values.

The following examples show the output of vxfsstat using various options. The following command displays buffer cache statistics:

# vxfsstat -b -c 5 /mount_point


0:43:44.091  Mon Apr 15 2002 -- absolute sample


buffer cache statistics
    36992 Kbyte current      377456 maximum      
688187425 lookups            99.98% hit rate     
    37165 sec reuse age [not limited by maximum]


10:43:54.121  Mon Apr 15 2002 -- delta (10.029 sec sample)


buffer cache statistics
    36992 Kbyte current      377456 maximum      
    29793 lookups            99.10% hit rate     
    37175 sec reuse age [not limited by maximum]


10:44:04.131  Mon Apr 15 2002 -- delta (10.010 sec sample)


buffer cache statistics
    36992 Kbyte current      377456 maximum      
    29199 lookups            99.15% hit rate     
    37185 sec reuse age [not limited by maximum]

The following command displays shared counters and statistics kept by VxFS:

# vxfsstat -v  /mount_point


10:49:10.791  Mon Apr 15 2002 -- absolute sample


vxi_alloc_emap          127699050  vxi_alloc_expand_retry   891125
vxi_alloc_find_retry       153857  vxi_alloc_findfail    225394263
vxi_alloc_findfix          889319  vxi_alloc_mapflush            2
vxi_alloc_prev           14581575  vxi_alloc_search       59147260
vxi_alloc_smap                  0  vxi_alloc_sumclean            0














































































      .
      .
      .
vxi_cbuf_cache_hit              0  vxi_cbuf_cache_miss           0
vxi_cgetblk_pbhit               0  vxi_cgetblk_pbmiss            0
vxi_cbuf_initlock               0  vxi_send_vrtinit              0
vxi_send_vrtmnt                 0  vxi_send_vrtunmnt             0
vxi_send_vrtremnt               0

The following command displays the inode cache and DNLC statistics:

# vxfsstat -i  /mount_point


10:52:54.051  Mon Apr 15 2002 -- absolute sample


Lookup & DNLC Statistics
   174944 maximum entries in dnlc
 22798260 total lookups            88.02% fast lookup  
 24065082 total dnlc lookup        83.39% dnlc hit rate
  2649796 total enters              7.57  hit per enter


inode cache statistics
   127577 inodes current     127577 peak               174931
maximum      
  3764456 lookups            43.72% hit rate     
   127757 inodes alloced
      921 sec recycle age [not limited by maximum]
4294967295 sec free age

The following command displays all shared counters that are non-zero:

# vxfsstat -vz  /mount_point


10:53:56.471  Mon Apr 15 2002 -- absolute sample


vxi_alloc_emap       127970901 vxi_alloc_expand_retry  891135
vxi_alloc_find_retry    153918 vxi_alloc_findfail    25474427
vxi_alloc_findfix       889319 vxi_alloc_mapflush           2
vxi_alloc_prev        14598090 vxi_alloc_search      59282134
vxi_alloc_sumsum      31483425 vxi_alloc_try         73892402





















































      .
      .
      .
vxi_write_dio          4030035 vxi_write_donetran      645551
vxi_write_logged       5708641 vxi_write_only           75826
vxi_write_rand       145197162 vxi_write_seq          9729784
vxi_clone_create            73 vxi_clone_remove           120
vxi_clone_convnodata        33 vxi_clone_dispose           32

The following command saves two samples of the per-file system counters taken at 10-second intervals to a file named statfile, then displays only the non-zero values, one per line:

# vxfsstat -w /tmp/statfile -t 10 -c 2  /mount_point 
# vxfsstat -vz -e 1 -r /tmp/statfile


11:01:42.481  Mon Apr 15 2002 -- absolute sample


vxi_bawrite                       4
vxi_bcache_curkbyte             128
vxi_bcache_maxkbyte           37898
vxi_bcache_recycleage          3569
vxi_bc_hits                      41
vxi_bc_lookups                   74
vxi_bc_reuse                     29
vxi_bc_waits                      2
vxi_bdwrite                       3
vxi_bmap                        438
vxi_bmap_cache                  407
vxi_bread                        29
vxi_brelse                        5
vxi_bwrite                        3
vxi_dnlc_size                 19940
vxi_eau_unexpand                  1
vxi_iaccess                       9
vxi_icache_allocedino            27
vxi_icache_curino                27
vxi_icache_inuseino              27
vxi_icache_maxino             19937
vxi_icache_peakino               27
vxi_ifree_timelag               600
vxi_iget                         28
vxi_iget_loop                    55
vxi_inopage                       1
vxi_log                           1
vxi_log_blks                      6
vxi_log_flush                     1
vxi_log_idle                      1
vxi_log_write                     3
vxi_lread                        57
vxi_lwrite                        6
vxi_physmem_mbyte               511
vxi_superwrite                    3
vxi_tran_commit                   1
vxi_tran_low                      1
vxi_tran_space                    5
vxi_tran_subfuncs                 2
vxi_tranlogflush                  2


04:09:48.804  Sun Apr 14 2002 -- delta (10.010 sec sample)


vxi_bcache_curkbyte             128
vxi_bcache_maxkbyte           37898
vxi_bcache_recycleage          3569
vxi_dnlc_size                 19940
vxi_icache_curino                27
vxi_icache_maxino             19937
vxi_icache_peakino               27
vxi_ifree_timelag               600

sar(1), iostat(1M), vmstat(1M), fs_vxfs(4)