Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
uses Perl to extract, format, and display kstats from the ZFS ARC
Perl
branch: master

Merge pull request #12 from xen0l/master

l2asize should be calculated
latest commit 76b6085db0
@mharsch authored
Failed to load latest commit information.
README Add support for l2asize
arcstat.pl l2asize should be calculated

README

arcstat.pl is a Perl script that uses the Sun::Solaris::Kstat module to read
ZFS ARC kstat values from the system and report on an interval basis. 

Some output examples can be found on the author's blog here:
http://blogs.oracle.com/realneel/entry/zfs_arc_statistics

Examples showing L2ARC data can be found here:
http://blog.harschsystems.com/tools/arcstat-pl-updated-for-l2arc-statistics/

Note: L2ARC statistics are only available on systems that have implemented
the L2ARC (i.e. nevada-based releases).

Usage for arcstat.pl can be obtained by providing the "--help" flag:

./arcstat.pl --help
Usage: arcstat.pl [-hvxr] [-f fields] [-o file] [interval [count]]
         -x : Print extended stats
         -r : Raw Output mode (values not scaled)
         -f : Specify specific fields to print (see -v)
         -o : Print stats to file
         -s : Specify a seperator

Examples:
        arcstat -o /tmp/a.log 2 10
        arcstat -s , -o /tmp/a.log 2 10
        arcstat -v
        arcstat -f time,hit%,dh%,ph%,mh% 

Available fields (statistics) can be retrieved with the "-v" flag:

./arcstat.pl -v
Usage: arcstat.pl [-hvxr] [-f fields] [-o file] [interval [count]]
Field definitions are as follows
 mtxmis : mutex_miss per second
  arcsz : Arc Size
   mrug : MRU Ghost List hits per second
 l2hit% : L2ARC access hit percentage
    mh% : Metadata hit percentage
l2miss% : L2ARC access miss percentage
   read : Total Arc accesses per second
l2asize : Actual (compressed) size of the L2ARC
      c : Arc Target Size
   mfug : MFU Ghost List hits per second
   miss : Arc misses per second
    dm% : Demand Data miss percentage
   dhit : Demand Data hits per second
  pread : Prefetch accesses per second
  dread : Demand data accesses per second
   pmis : Prefetch misses per second
 l2miss : L2ARC misses per second
   time : Time
l2bytes : bytes read per second from the L2ARC
    pm% : Prefetch miss percentage
    mm% : Metadata miss percentage
   hits : Arc reads per second
    mfu : MFU List hits per second
 l2read : Total L2ARC accesses per second
   mmis : Metadata misses per second
   rmis : recycle_miss per second
   mhit : Metadata hits per second
   dmis : Demand Data misses per second
    mru : MRU List hits per second
    ph% : Prefetch hits percentage
  eskip : evict_skip per second
 l2size : Size of the L2ARC
 l2hits : L2ARC hits per second
   hit% : Arc Hit percentage
  miss% : Arc miss percentage
    dh% : Demand Data hit percentage
  mread : Metadata accesses per second
   phit : Prefetch hits per second

Something went wrong with that request. Please try again.