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.