Home > Veritas Storage Foundation™ File System Manual Pages

VXFSSTAT (1M)

Maintenance Commands

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
NOTES
Cluster File System Issues
OPTIONS
EXAMPLES
SEE ALSO

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_alloc_sumsum 31413898 vxi_alloc_try 73740912 vxi_async_iupdat 466834 vxi_async_realloc 0 vxi_async_shorten 16433 vxi_bawrite 3113052 vxi_bcache_curkbyte 37120 vxi_bcache_maxkbyte 377456 vxi_bcache_recycleage 37492 vxi_bc_chunksteal 0 vxi_bc_hits 809264587 vxi_bc_lookups 831586029 vxi_bc_reuse 824755 vxi_bc_subflush 1106 vxi_bc_waits 10108161 vxi_bdwrite 322701867 vxi_bdwrite_tflush 15642 vxi_bmap 642027294 vxi_bmap_cache 336007609 vxi_bmap_indirect 126570 vxi_bread 141517 vxi_brelse 121168873 vxi_brelse_tflush 37679 vxi_btwrite 19659 vxi_bufspace_delay 0 vxi_bufspace_tranflush 0 vxi_bwrite 9201755 vxi_clonemap 46950 vxi_cutwrite 201 vxi_dirblk 2126810 vxi_dirlook 2742437 vxi_dirlook_dot 26806 vxi_dirlook_dotdot 10321 vxi_dirlook_notfound 1343557 vxi_fast_lookup 19976655 vxi_dnlc_hit 19978068 vxi_dnlc_enter 2634717 vxi_dnlc_miss 3977448 vxi_dnlc_size 174944 vxi_eau_cleaned 7173 vxi_eau_expand 1183 vxi_eau_unexpand 760 vxi_eau_write 2974 vxi_flush_throttle 3711117 vxi_getblk 0 vxi_iaccess 9623960 vxi_iflush_cut 0 vxi_icache_allocedino 125670 vxi_icache_curino 125490 vxi_icache_inuseino 869 vxi_icache_maxino 174931 vxi_icache_peakino 125490 vxi_icache_recycleage 827 vxi_ifree_timelag 294967295 vxi_iget 3737508 vxi_iget_found 1630190 vxi_iget_loop 3869864 vxi_iinactive 13132171 vxi_iinactive_front 747742 vxi_iinactive_slow 848827 vxi_inofail 0 vxi_inopage 1981878 vxi_ipage 0 vxi_iupdat 7525241 vxi_iupdat_cluster 28888352 vxi_log 97853093 vxi_log_blks 259642524 vxi_log_delayed 97014049 vxi_log_flush 5482719 vxi_log_idle 644 vxi_log_write 5601793 vxi_lread 689242557 vxi_lwrite 331814856 vxi_maj_fault 85953732 vxi_map_write 0 vxi_pagecluster 0 vxi_pagestrategy 0 vxi_pgin 111262487 vxi_pgout 78470639 vxi_pgpgin 230200992 vxi_pgpgout 216688442 vxi_execpgin 0 vxi_execpgout 0 vxi_anonpgin 0 vxi_anonpgout 0 vxi_fspgin 0 vxi_fspgout 0 vxi_physmem_mbyte 4095 vxi_qtrunc 335372 vxi_ra 36242354 vxi_randwrite_throttle 208030 vxi_rapgpgin 155014014 vxi_rasectin 1240112576 vxi_read_dio 90813 vxi_read_rand 136083132 vxi_read_seq 91090753 vxi_sectin 1841735888 vxi_sectout 1733460200 vxi_setattr_nochange 0 vxi_sumupd 2259 vxi_superwrite 20670 vxi_sync_delxwri 0 vxi_sync_inode 0 vxi_sync_page 0 vxi_ntran 115 vxi_tflush_cut 169 vxi_tflush_inode 399964 vxi_tflush_map_async 27323 vxi_tflush_map_clone 37033 vxi_tflush_map_sync 105593 vxi_tran_commit 97875587 vxi_tran_low 861254 vxi_tran_retry 62 vxi_tran_space 315880359 vxi_tran_subfuncs 335682410 vxi_tranidflush 20619624 vxi_tranidflush_flush 33611931 vxi_tranidflush_none 1319155 vxi_tranleft_asyncflush 272018 vxi_tranleft_delay 24617 vxi_tranleft_syncflush 42182 vxi_tranlogflush 168777641 vxi_tranlogflush_flush 1579589 vxi_trunc 1061937 vxi_unlockmap_async 53897 vxi_write_asynccnt 0 vxi_write_dio 4018407 vxi_write_donetran 643816 vxi_write_logged 5692129 vxi_write_logonly 0 vxi_write_only 75014 vxi_write_rand 144987994 vxi_write_seq 9704070 vxi_write_synccnt 0 vxi_clone_create 73 vxi_clone_remove 120 vxi_clone_rename 0 vxi_clone_stat 0 vxi_clone_convnodata 33 vxi_clone_cntl 0 vxi_clone_dispose 32 vxi_read_to_map 0 vxi_virtmem_mbyte 0 vxi_dirc_setups 0 vxi_dirc_purges 0 vxi_dirc_hits 0 vxi_dirc_misses 0 vxi_dirc_spchits 0 vxi_dirc_spcmisses 0 vxi_cbufgrant 0 vxi_cbufrevoke 0 vxi_cbuf_no_grant 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_async_iupdat 467890 vxi_async_shorten 16473 vxi_bawrite 3121957 vxi_bcache_curkbyte 37376 vxi_bcache_maxkbyte 377456 vxi_bcache_recycleage 37778 vxi_bc_hits 810437397 vxi_bc_lookups 832788527 vxi_bc_reuse 826502 vxi_bc_subflush 1106 vxi_bc_waits 10149369 vxi_bdwrite 323169603 vxi_bdwrite_tflush 15642 vxi_bmap 643127318 vxi_bmap_cache 336547682 vxi_bmap_indirect 126877 vxi_bread 141659 vxi_brelse 121378971 vxi_brelse_tflush 37679 vxi_btwrite 19671 vxi_bwrite 9229340 vxi_clonemap 47210 vxi_cutwrite 201 vxi_dirblk 2139375 vxi_dirlook 2759767 vxi_dirlook_dot 27302 vxi_dirlook_dotdot 10549 vxi_dirlook_notfound 1348038 vxi_fast_lookup 20089381 vxi_dnlc_hit 20090819 vxi_dnlc_enter 2651532 vxi_dnlc_miss 3998738 vxi_dnlc_size 174944 vxi_eau_cleaned 7178 vxi_eau_expand 1186 vxi_eau_unexpand 761 vxi_eau_write 2979 vxi_flush_throttle 3713638 vxi_iaccess 9675920 vxi_icache_allocedino 128015 vxi_icache_curino 127835 vxi_icache_inuseino 862 vxi_icache_maxino 174931 vxi_icache_peakino 127835 vxi_icache_recycleage 976 vxi_ifree_timelag 4294967295 vxi_iget 3767132 vxi_iget_found 1647884 vxi_iget_loop 3901834 vxi_iinactive 13209232 vxi_iinactive_front 749595 vxi_iinactive_slow 852399 vxi_inopage 1991466 vxi_iupdat 7545127 vxi_iupdat_cluster 28972200 vxi_log 98067562 vxi_log_blks 260272868 vxi_log_delayed 97226329 vxi_log_flush 5494509 vxi_log_idle 644 vxi_log_write 5613750 vxi_lread 690193623 vxi_lwrite 332310197 vxi_maj_fault 86034987 vxi_pgin 111392201 vxi_pgout 78618544 vxi_pgpgin 230537169 vxi_pgpgout 217206738 vxi_physmem_mbyte 4095 vxi_qtrunc 338120 vxi_ra 36326452 vxi_randwrite_throttle 208030 vxi_rapgpgin 155282892 vxi_rasectin 1242263600 vxi_read_dio 91028 vxi_read_rand 136196781 vxi_read_seq 91237936 vxi_sectin 1844425720 vxi_sectout 1737606568 vxi_sumupd 2263 vxi_superwrite 20799 vxi_ntran 111 vxi_tflush_cut 169 vxi_tflush_inode 400845 vxi_tflush_map_async 27323 vxi_tflush_map_clone 37284 vxi_tflush_map_sync 106037 vxi_tran_commit 98090240 vxi_tran_low 861943 vxi_tran_retry 62 vxi_tran_space 316641525 vxi_tran_subfuncs 336400379 vxi_tranidflush 20676831 vxi_tranidflush_flush 33710522 vxi_tranidflush_none 1323787 vxi_tranleft_asyncflush 272018 vxi_tranleft_delay 24617 vxi_tranleft_syncflush 42182 vxi_tranlogflush 169158497 vxi_tranlogflush_flush 1586325 vxi_trunc 1066413 vxi_unlockmap_async 53897 .. . . . 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

VXFSSTAT (1M)

Table of contents