vxfsstat(1M)vxfsstat(1M)NAMEvxfsstat - display VxFS file system statistics
SYNOPSIS
columns] sample_count] seconds] mount_point
sample_count] seconds] mount_point
outfile] sample_count] seconds] mount_point
columns]
DESCRIPTION
is a statistical reporter to aid in performance tuning and determining
performance anomalies. gathers buffer cache, inode cache, DNLC (direc‐
tory name lookup cache), per-CPU statistics, per-file system statistics
for local and cluster mounted file system, and global cluster file sys‐
tem 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.
Options
recognizes the following options:
Displays absolute values.
Displays buffer cache statistics.
Specifies the number of samples to take.
Displays per-CPU statistics.
Selects the number of column entries to display per line of output.
The default is two columns. 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.
is the default output format.
Replays output from the specified file
infile. You can create output files using the option.
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.
Displays VxFS shared counters and statistics.
Appends output to the specified file
outfile. can be invoked multiple times with the same file
to collect multiple samples. The option can only be used
with the and options.
Displays per-file system VxFS statistics.
Displays only non-zero values.
Operands
recognizes the following operand:
mount_point Name of 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 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
and These APIs are in the header file.
EXAMPLES
The following examples show the output of 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 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 ALSOiostat(1), vmstat(1), sar(1M).
vxfsstat(1M)
