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 .\"
11 .\"
12 .\" Copyright 2014 Adam Stevko. All rights reserved.
13 .\"
14 .TH ARCSTAT 1M "Feb 4, 2014"
15 .SH NAME
16 arcstat \- report ZFS ARC and L2ARC statistics
17 .SH SYNOPSIS
18 .LP
19 .nf
20 \fBarcstat\fR [\fB-hvxr\fR] [\fB-f field[,field]...\fR] [\fB-o file\fR] [\fB-s string\fR]
21 [\fBinterval\fR [\fBcount\fR]]
22 .fi
23
24 .SH DESCRIPTION
25 .sp
26 .LP
27 The \fBarcstat\fR utility print various ZFS ARC and L2ARC statistics in
28 vmstat-like fashion.
29 .sp
30
31 .sp
32 .LP
33 The \fBarcstat\fR command reports the following information:
34 .sp
35 .ne 2
36
37 .\"
38 .sp
39 .ne 1
40 .na
41 \fBc \fR
42 .ad
43 .RS 14n
44 ARC Target Size
45 .RE
46
47 .sp
48 .ne 2
49 .na
50 \fBdh% \fR
51 .ad
52 .RS 14n
53 Demand Data hit percentage
54 .RE
55
56 .sp
57 .ne 2
58 .na
59 \fBdm% \fR
60 .ad
61 .RS 14n
62 Demand Data miss percentage
63 .RE
64
65 .sp
66 .ne 2
67 .na
68 \fBmfu \fR
69 .ad
70 .RS 14n
71 MFU List hits per second
72 .RE
73
74 .sp
75 .ne 2
76 .na
77 \fBmh% \fR
78 .ad
79 .RS 14n
80 Metadata hit percentage
81 .RE
82
83 .sp
84 .ne 2
85 .na
86 \fBmm% \fR
87 .ad
88 .RS 14n
89 Metadata miss percentage
90 .RE
91
92 .sp
93 .ne 2
94 .na
95 \fBmru \fR
96 .ad
97 .RS 14n
98 MRU List hits per second
99 .RE
100
101 .sp
102 .ne 2
103 .na
104 \fBph% \fR
105 .ad
106 .RS 14n
107 Prefetch hits percentage
108 .RE
109
110 .sp
111 .ne 2
112 .na
113 \fBpm% \fR
114 .ad
115 .RS 14n
116 Prefetch miss percentage
117 .RE
118
119 .sp
120 .ne 2
121 .na
122 \fBdhit \fR
123 .ad
124 .RS 14n
125 Demand Data hits per second
126 .RE
127
128 .sp
129 .ne 2
130 .na
131 \fBdmis \fR
132 .ad
133 .RS 14n
134 Demand Data misses per second
135 .RE
136
137 .sp
138 .ne 2
139 .na
140 \fBhit% \fR
141 .ad
142 .RS 14n
143 ARC Hit percentage
144 .RE
145
146 .sp
147 .ne 2
148 .na
149 \fBhits \fR
150 .ad
151 .RS 14n
152 ARC reads per second
153 .RE
154
155 .sp
156 .ne 2
157 .na
158 \fBmfug \fR
159 .ad
160 .RS 14n
161 MFU Ghost List hits per second
162 .RE
163
164 .sp
165 .ne 2
166 .na
167 \fBmhit \fR
168 .ad
169 .RS 14n
170 Metadata hits per second
171 .RE
172
173 .sp
174 .ne 2
175 .na
176 \fBmiss \fR
177 .ad
178 .RS 14n
179 ARC misses per second
180 .RE
181
182 .sp
183 .ne 2
184 .na
185 \fBmmis \fR
186 .ad
187 .RS 14n
188 Metadata misses per second
189 .RE
190
191 .sp
192 .ne 2
193 .na
194 \fBmrug \fR
195 .ad
196 .RS 14n
197 MRU Ghost List hits per second
198 .RE
199
200 .sp
201 .ne 2
202 .na
203 \fBphit \fR
204 .ad
205 .RS 14n
206 Prefetch hits per second
207 .RE
208
209 .sp
210 .ne 2
211 .na
212 \fBpmis \fR
213 .ad
214 .RS 14n
215 Prefetch misses per second
216 .RE
217
218 .sp
219 .ne 2
220 .na
221 \fBread \fR
222 .ad
223 .RS 14n
224 Total ARC accesses per second
225 .RE
226
227 .sp
228 .ne 2
229 .na
230 \fBrmis \fR
231 .ad
232 .RS 14n
233 recycle_miss per second
234 .RE
235
236 .sp
237 .ne 2
238 .na
239 \fBtime \fR
240 .ad
241 .RS 14n
242 Time
243 .RE
244
245 .sp
246 .ne 2
247 .na
248 \fBarcsz \fR
249 .ad
250 .RS 14n
251 ARC Size
252 .RE
253
254 .sp
255 .ne 2
256 .na
257 \fBdread \fR
258 .ad
259 .RS 14n
260 Demand data accesses per second
261 .RE
262
263 .sp
264 .ne 2
265 .na
266 \fBeskip \fR
267 .ad
268 .RS 14n
269 evict_skip per second
270 .RE
271
272 .sp
273 .ne 2
274 .na
275 \fBmiss% \fR
276 .ad
277 .RS 14n
278 ARC miss percentage
279 .RE
280
281 .sp
282 .ne 2
283 .na
284 \fBmread \fR
285 .ad
286 .RS 14n
287 Metadata accesses per second
288 .RE
289
290 .sp
291 .ne 2
292 .na
293 \fBpread \fR
294 .ad
295 .RS 14n
296 Prefetch accesses per second
297 .RE
298
299 .sp
300 .ne 2
301 .na
302 \fBl2hit% \fR
303 .ad
304 .RS 14n
305 L2ARC access hit percentage
306 .RE
307
308 .sp
309 .ne 2
310 .na
311 \fBl2hits \fR
312 .ad
313 .RS 14n
314 L2ARC hits per second
315 .RE
316
317 .sp
318 .ne 2
319 .na
320 \fBl2miss \fR
321 .ad
322 .RS 14n
323 L2ARC misses per second
324 .RE
325
326 .sp
327 .ne 2
328 .na
329 \fBl2read \fR
330 .ad
331 .RS 14n
332 Total L2ARC accesses per second
333 .RE
334
335 .sp
336 .ne 2
337 .na
338 \fBl2size \fR
339 .ad
340 .RS 14n
341 Size of the L2ARC
342 .RE
343
344 .sp
345 .ne 2
346 .na
347 \fBmtxmis \fR
348 .ad
349 .RS 14n
350 mutex_miss per second
351 .RE
352
353 .sp
354 .ne 2
355 .na
356 \fBl2bytes \fR
357 .ad
358 .RS 14n
359 bytes read per second from the L2ARC
360 .RE
361
362 .sp
363 .ne 2
364 .na
365 \fBl2miss% \fR
366 .ad
367 .RS 14n
368 L2ARC access miss percentage
369 .RE
370
371 .sp
372 .ne 2
373 .na
374 \fBl2asize \fR
375 .ad
376 .RS 14n
377 Actual (compressed) size of the L2ARC
378 .RE
379 .\"
380
381 .SH OPTIONS
382 .sp
383 .LP
384 The following options are supported:
385
386 .sp
387 .ne 2
388 .na
389 \fB\fB-f\fR\fR
390 .ad
391 .RS 12n
392 Display only specific fields. See \fBDESCRIPTION\fR for supported statistics.
393 .RE
394
395 .sp
396 .ne 2
397 .na
398 \fB\fB-h\fR\fR
399 .ad
400 .RS 12n
401 Display help message.
402 .RE
403
404 .sp
405 .ne 2
406 .na
407 \fB\fB-o\fR\fR
408 .ad
409 .RS 12n
410 Report statistics to a file instead of the standard output.
411 .RE
412
413 .sp
414 .ne 2
415 .na
416 \fB\fB-s\fR\fR
417 .ad
418 .RS 12n
419 Display data with a specified separator (default: 2 spaces).
420 .RE
421
422 .sp
423 .ne 2
424 .na
425 \fB\fB-x\fR\fR
426
427 .ad
428 .RS 12n
429 Print extended stats (same as -f time,mfu,mru,mfug,mrug,eskip,mtxmis,rmis,dread,pread,read).
430 .RE
431
432 .sp
433 .ne 2
434 .na
435 \fB\fB-v\fR\fR
436 .ad
437 .RS 12n
438 Show field headers and definitions
439 .RE
440
441 .SH OPERANDS
442 .sp
443 .LP
444 The following operands are supported:
445 .sp
446 .ne 2
447 .na
448 \fB\fIcount\fR\fR
449 .ad
450 .RS 12n
451 Display only \fIcount\fR reports.
452 .RE
453
454 .sp
455 .ne 2
456 .na
457 \fB\fIinterval\fR\fR
458 .ad
459 .RS 12n
460 Specify the sampling interval in seconds.
461 .RE
462
463 .SH AUTHORS
464 .sp
465 .LP
466 arcstat was originally written by Neelakanth Nadgir and supported only ZFS ARC statistics.
467 Mike Harsch updated it to support L2ARC statistics.