arcstat.1m revision 95c635efb7c3b86efc493e0447eaec7aecca3f0f

This file and its contents are supplied under the terms of the
Common Development and Distribution License ("CDDL"), version 1.0.
You may only use this file in accordance with the terms of version
1.0 of the CDDL.

A full copy of the text of the CDDL should have accompanied this
source. A copy of the CDDL is also available via the Internet at
http://www.illumos.org/license/CDDL.


Copyright 2014 Adam Stevko. All rights reserved.

ARCSTAT 1M "Feb 4, 2014"
NAME
arcstat - report ZFS ARC and L2ARC statistics
SYNOPSIS

arcstat [-hvxr] [-f field[,field]...] [-o file] [-s string] 
 [interval [count]]
DESCRIPTION

The arcstat utility print various ZFS ARC and L2ARC statistics in vmstat-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

rmis

recycle_miss per second

time

Time

arcsz

ARC 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


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 spaces).

-x

Print extended stats (same as -f time,mfu,mru,mfug,mrug,eskip,mtxmis,rmis,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 by Neelakanth Nadgir and supported only ZFS ARC statistics. Mike Harsch updated it to support L2ARC statistics.