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.
Copyright (c) 2015 by Delphix. All rights reserved.
arcstat [-hvxr] [-f field[,field]...] [-o file] [-s string] [interval [count]]
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
Demand Data hit percentage
Demand Data miss percentage
MFU List hits per second
Metadata hit percentage
Metadata miss percentage
MRU List hits per second
Prefetch hits percentage
Prefetch miss percentage
Demand Data hits per second
Demand Data misses per second
ARC Hit percentage
ARC reads per second
MFU Ghost List hits per second
Metadata hits per second
ARC misses per second
Metadata misses per second
MRU Ghost List hits per second
Prefetch hits per second
Prefetch misses per second
Total ARC accesses per second
Time
ARC Size
Demand data accesses per second
evict_skip per second
ARC miss percentage
Metadata accesses per second
Prefetch accesses per second
L2ARC access hit percentage
L2ARC hits per second
L2ARC misses per second
Total L2ARC accesses per second
Size of the L2ARC
mutex_miss per second
bytes read per second from the L2ARC
L2ARC access miss percentage
Actual (compressed) size of the L2ARC
The following options are supported: -f
Display only specific fields. See DESCRIPTION for supported statistics.
Display help message.
Report statistics to a file instead of the standard output.
Display data with a specified separator (default: 2 spaces).
Print extended stats (same as -f time,mfu,mru,mfug,mrug,eskip,mtxmis,dread,pread,read).
Show field headers and definitions
The following operands are supported: count
Display only count reports.
Specify the sampling interval in seconds.
arcstat was originally written by Neelakanth Nadgir and supported only ZFS ARC statistics. Mike Harsch updated it to support L2ARC statistics.