]>
Commit | Line | Data |
---|---|---|
ac806a25 AJ |
1 | .\" |
2 | .\" This file and its contents are supplied under the terms of the | |
3 | .\" Common Development and Distribution License ("CDDL"), version 1.0. | |
4 | .\" You may only use this file in accordance with the terms of version | |
5 | .\" 1.0 of the CDDL. | |
6 | .\" | |
7 | .\" A full copy of the text of the CDDL should have accompanied this | |
8 | .\" source. A copy of the CDDL is also available via the Internet at | |
9 | .\" http://www.illumos.org/license/CDDL. | |
10 | .\" | |
ac806a25 AJ |
11 | .\" Copyright 2014 Adam Stevko. All rights reserved. |
12 | .\" Copyright (c) 2015 by Delphix. All rights reserved. | |
5a04b177 | 13 | .\" Copyright (c) 2020 by AJ Jordan. All rights reserved. |
ac806a25 | 14 | .\" |
63987136 AZ |
15 | .Dd May 26, 2021 |
16 | .Dt ARCSTAT 1 | |
17 | .Os | |
18 | . | |
19 | .Sh NAME | |
20 | .Nm arcstat | |
21 | .Nd report ZFS ARC and L2ARC statistics | |
22 | .Sh SYNOPSIS | |
23 | .Nm | |
24 | .Op Fl havxp | |
1b37cc1a | 25 | .Op Fl f Ar field Ns Op , Ns Ar field Ns … |
63987136 AZ |
26 | .Op Fl o Ar file |
27 | .Op Fl s Ar string | |
28 | .Op Ar interval | |
29 | .Op Ar count | |
30 | . | |
31 | .Sh DESCRIPTION | |
32 | .Nm | |
33 | prints various ZFS ARC and L2ARC statistics in vmstat-like fashion: | |
1b37cc1a | 34 | .Bl -tag -compact -offset Ds -width "l2asize" |
63987136 | 35 | .It Sy c |
5a04b177 | 36 | ARC target size |
63987136 | 37 | .It Sy dh% |
5a04b177 | 38 | Demand data hit percentage |
63987136 | 39 | .It Sy dm% |
5a04b177 | 40 | Demand data miss percentage |
63987136 | 41 | .It Sy mfu |
5a04b177 | 42 | MFU list hits per second |
63987136 | 43 | .It Sy mh% |
ac806a25 | 44 | Metadata hit percentage |
63987136 | 45 | .It Sy mm% |
ac806a25 | 46 | Metadata miss percentage |
63987136 | 47 | .It Sy mru |
5a04b177 | 48 | MRU list hits per second |
63987136 | 49 | .It Sy ph% |
ac806a25 | 50 | Prefetch hits percentage |
63987136 | 51 | .It Sy pm% |
ac806a25 | 52 | Prefetch miss percentage |
63987136 | 53 | .It Sy dhit |
5a04b177 | 54 | Demand data hits per second |
63987136 | 55 | .It Sy dmis |
5a04b177 | 56 | Demand data misses per second |
63987136 | 57 | .It Sy hit% |
5a04b177 | 58 | ARC hit percentage |
63987136 | 59 | .It Sy hits |
ac806a25 | 60 | ARC reads per second |
63987136 | 61 | .It Sy mfug |
5a04b177 | 62 | MFU ghost list hits per second |
63987136 | 63 | .It Sy mhit |
ac806a25 | 64 | Metadata hits per second |
63987136 | 65 | .It Sy miss |
ac806a25 | 66 | ARC misses per second |
63987136 | 67 | .It Sy mmis |
ac806a25 | 68 | Metadata misses per second |
63987136 | 69 | .It Sy mrug |
5a04b177 | 70 | MRU ghost list hits per second |
63987136 | 71 | .It Sy phit |
ac806a25 | 72 | Prefetch hits per second |
63987136 | 73 | .It Sy pmis |
ac806a25 | 74 | Prefetch misses per second |
63987136 | 75 | .It Sy read |
ac806a25 | 76 | Total ARC accesses per second |
63987136 AZ |
77 | .It Sy time |
78 | Current time | |
79 | .It Sy size | |
5a04b177 | 80 | ARC size |
63987136 AZ |
81 | .It Sy arcsz |
82 | Alias for | |
83 | .Sy size | |
84 | .It Sy dread | |
ac806a25 | 85 | Demand data accesses per second |
63987136 | 86 | .It Sy eskip |
ac806a25 | 87 | evict_skip per second |
63987136 | 88 | .It Sy miss% |
ac806a25 | 89 | ARC miss percentage |
63987136 | 90 | .It Sy mread |
ac806a25 | 91 | Metadata accesses per second |
63987136 | 92 | .It Sy pread |
ac806a25 | 93 | Prefetch accesses per second |
63987136 | 94 | .It Sy l2hit% |
ac806a25 | 95 | L2ARC access hit percentage |
63987136 | 96 | .It Sy l2hits |
ac806a25 | 97 | L2ARC hits per second |
63987136 | 98 | .It Sy l2miss |
ac806a25 | 99 | L2ARC misses per second |
63987136 | 100 | .It Sy l2read |
ac806a25 | 101 | Total L2ARC accesses per second |
63987136 | 102 | .It Sy l2pref |
08532162 | 103 | L2ARC prefetch allocated size per second |
63987136 | 104 | .It Sy l2pref% |
08532162 | 105 | L2ARC prefetch allocated size percentage |
63987136 | 106 | .It Sy l2mfu |
08532162 | 107 | L2ARC MFU allocated size per second |
63987136 | 108 | .It Sy l2mfu% |
08532162 | 109 | L2ARC MFU allocated size percentage |
63987136 | 110 | .It Sy l2mru |
08532162 | 111 | L2ARC MRU allocated size per second |
63987136 | 112 | .It Sy l2mru% |
08532162 | 113 | L2ARC MRU allocated size percentage |
63987136 | 114 | .It Sy l2data |
08532162 | 115 | L2ARC data (buf content) allocated size per second |
63987136 | 116 | .It Sy l2data% |
08532162 | 117 | L2ARC data (buf content) allocated size percentage |
63987136 | 118 | .It Sy l2meta |
08532162 | 119 | L2ARC metadata (buf content) allocated size per second |
63987136 | 120 | .It Sy l2meta% |
08532162 | 121 | L2ARC metadata (buf content) allocated size percentage |
63987136 | 122 | .It Sy l2size |
ac806a25 | 123 | Size of the L2ARC |
63987136 | 124 | .It Sy mtxmis |
ac806a25 | 125 | mutex_miss per second |
63987136 | 126 | .It Sy l2bytes |
5a04b177 | 127 | Bytes read per second from the L2ARC |
63987136 | 128 | .It Sy l2miss% |
ac806a25 | 129 | L2ARC access miss percentage |
63987136 | 130 | .It Sy l2asize |
ac806a25 | 131 | Actual (compressed) size of the L2ARC |
63987136 | 132 | .It Sy grow |
5a04b177 | 133 | ARC grow disabled |
63987136 | 134 | .It Sy need |
5a04b177 | 135 | ARC reclaim needed |
63987136 | 136 | .It Sy free |
b46be903 DS |
137 | The ARC's idea of how much free memory there is, which includes evictable memory |
138 | in the page cache. | |
63987136 AZ |
139 | Since the ARC tries to keep |
140 | .Sy avail | |
141 | above zero, | |
142 | .Sy avail | |
143 | is usually more instructive to observe than | |
144 | .Sy free . | |
145 | .It Sy avail | |
b46be903 DS |
146 | The ARC's idea of how much free memory is available to it, which is a bit less |
147 | than | |
63987136 AZ |
148 | .Sy free . |
149 | May temporarily be negative, in which case the ARC will reduce the target size | |
150 | .Sy c . | |
151 | .El | |
152 | . | |
153 | .Sh OPTIONS | |
154 | .Bl -tag -width "-v" | |
155 | .It Fl a | |
2aaab887 | 156 | Print all possible stats. |
63987136 AZ |
157 | .It Fl f |
158 | Display only specific fields. | |
159 | See | |
1b37cc1a | 160 | .Sx DESCRIPTION |
63987136 AZ |
161 | for supported statistics. |
162 | .It Fl h | |
ac806a25 | 163 | Display help message. |
63987136 | 164 | .It Fl o |
ac806a25 | 165 | Report statistics to a file instead of the standard output. |
63987136 | 166 | .It Fl p |
2aaab887 | 167 | Disable auto-scaling of numerical fields (for raw, machine-parsable values). |
63987136 | 168 | .It Fl s |
ac806a25 | 169 | Display data with a specified separator (default: 2 spaces). |
63987136 | 170 | .It Fl x |
1b37cc1a AZ |
171 | Print extended stats |
172 | .Pq same as Fl f Sy time , Ns Sy mfu , Ns Sy mru , Ns Sy mfug , Ns Sy mrug , Ns Sy eskip , Ns Sy mtxmis , Ns Sy dread , Ns Sy pread , Ns Sy read . | |
63987136 | 173 | .It Fl v |
ac806a25 | 174 | Show field headers and definitions |
63987136 AZ |
175 | .El |
176 | . | |
177 | .Sh OPERANDS | |
ac806a25 | 178 | The following operands are supported: |
1b37cc1a | 179 | .Bl -tag -compact -offset Ds -width "interval" |
63987136 | 180 | .It Ar interval |
ac806a25 | 181 | Specify the sampling interval in seconds. |
63987136 | 182 | .It Ar count |
1b37cc1a AZ |
183 | Display only |
184 | .Ar count | |
185 | reports. | |
63987136 | 186 | .El |