vxfsstat
NAME
vxfsstat - display VxFS file system statistics
SYNOPSIS
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 ]
AVAILABILITY
VRTSvxfs
DESCRIPTION
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.
NOTES
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.
CLUSTER FILE SYSTEM ISSUES
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.
OPTIONS
-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.
EXAMPLES
The following examples show the output of vxfsstat using various options. To display 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]
To display 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
To display 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
To display 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
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
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
SEE ALSO
sar(1), iostat(1M), vmstat(1M)
|
