Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ARCSTAT(1)		    General Commands Manual		    ARCSTAT(1)

NAME
       arcstat - report	ZFS ARC	and L2ARC statistics

SYNOPSIS
       arcstat [-hvx] [-f field[,field]...] [-o	file] [-s string] [interval [count]]

DESCRIPTION
       The  arcstat  utility print various ZFS ARC and L2ARC statistics	in vm-
       stat-like fashion.

       The arcstat command reports the following information:

       c
		     ARC target	size

       dh%
		     Demand data hit percentage

       dm%
		     Demand data miss percentage

       mfu
		     MFU list hits per second

       mh%
		     Metadata hit percentage

       mm%
		     Metadata miss percentage

       mru
		     MRU list hits per second

       ph%
		     Prefetch hits percentage

       pm%
		     Prefetch miss percentage

       dhit
		     Demand data hits per second

       dmis
		     Demand data misses	per second

       hit%
		     ARC hit percentage

       hits
		     ARC reads per second

       mfug
		     MFU ghost list hits per second

       mhit
		     Metadata hits per second

       miss
		     ARC misses	per second

       mmis
		     Metadata misses per second

       mrug
		     MRU ghost list hits per second

       phit
		     Prefetch hits per second

       pmis
		     Prefetch misses per second

       read
		     Total ARC accesses	per second

       time
		     Time

       size
		     ARC size

       arcsz
		     Alias for size

       dread
		     Demand data accesses per second

       eskip
		     evict_skip	per second

       miss%
		     ARC miss percentage

       mread
		     Metadata accesses per second

       pread
		     Prefetch accesses per second

       l2hit%
		     L2ARC access hit percentage

       l2hits
		     L2ARC hits	per second

       l2miss
		     L2ARC misses per second

       l2read
		     Total L2ARC accesses per second

       l2size
		     Size of the L2ARC

       mtxmis
		     mutex_miss	per second

       l2bytes
		     Bytes read	per second from	the L2ARC

       l2miss%
		     L2ARC access miss percentage

       l2asize
		     Actual (compressed) size of the L2ARC

       grow
		     ARC grow disabled

       need
		     ARC reclaim needed

       free
		     The ARC's idea of how much	free memory  there  is,	 which
		     includes  evictable  memory in the	page cache.  Since the
		     ARC tries to keep avail above zero, avail is usually more
		     instructive to observe than free.

       avail
		     The  ARC's	 idea  of how much free	memory is available to
		     it, which is a bit	less than free.	  May  temporarily  be
		     negative,	in  which  case	the ARC	will reduce the	target
		     size c.

OPTIONS
       The following options are supported:

       -f
		   Display only	specific fields. See DESCRIPTION for supported
		   statistics.

       -h
		   Display help	message.

       -o
		   Report statistics to	a file instead of the standard output.

       -s
		   Display  data  with	a specified separator (default:	2 spa-
		   ces).

       -x
		   Print extended stats	(same as -f time,mfu,mru,mfug,mrug,es-
		   kip,mtxmis,dread,pread,read).

       -v
		   Show	field headers and definitions

OPERANDS
       The following operands are supported:

       count
		   Display only	count reports.

       interval
		   Specify the sampling	interval in seconds.

AUTHORS
       arcstat	was  originally	 written in Perl by Neelakanth Nadgir and sup-
       ported only ZFS ARC statistics.	Mike  Harsch  updated  it  to  support
       L2ARC  statistics.   John  Hixson  ported it to Python for FreeNAS over
       some beer, after	which many individuals from the	OpenZFS	community con-
       tinued to maintain and improve it.

				  May 7, 2020			    ARCSTAT(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=arcstat&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help