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 ]
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.
Displays buffer cache statistics.
Specifies the number of samples to take.
Selects the number of column entries to display per line of output. The default is two columns. -e does not affect all output formats.
Displays cluster file system global statistics. Not valid on non-cluster (local) mounted file systems.
Displays inode cache and DNLC statistics. -i is the default output format.
Replays output from the specified file infile. You can create output files using the -w option.
Displays VxFS shared counters and statistics.
Displays per-file system statistics for cluster file systems. Not valid on non-cluster (local) mounted file systems.
Specifies the duration of the sampling interval in seconds.
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.
Displays per-file system VxFS statistics.
Displays only non-zero values.
The following examples show the output of vxfsstat using various options. To display buffer cache statistics:
0:43:44.091 Mon Apr 15 2002 -- absolute sample
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)
36992 Kbyte current 377456 maximum
37175 sec reuse age [not limited by maximum]
10:44:04.131 Mon Apr 15 2002 -- delta (10.010 sec sample)
36992 Kbyte current 377456 maximum
37185 sec reuse age [not limited by maximum]
To display shared counters and statistics kept by VxFS:
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
To display the inode cache and DNLC statistics:
10:52:54.051 Mon Apr 15 2002 -- absolute sample
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
127577 inodes current 127577 peak 174931
3764456 lookups 43.72% hit rate
921 sec recycle age [not limited by maximum]
To display all shared counters that are non-zero:
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
To save two samples of the per-file system counters taken at 10-second intervals to a file named statfile, then display 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
04:09:48.804 Sun Apr 14 2002 -- delta (10.010 sec sample)
iostat, sar, vmstat(1M), vmstat(1M), fs_vxfs(4)