usr/src/man/man1m/arcstat.1m

   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 .\" Copyright (c) 2015 by Delphix. All rights reserved.
  14 .\"
  15 .TH ARCSTAT 1M "Feb 4, 2014"
  16 .SH NAME
  17 arcstat \- report ZFS ARC and L2ARC statistics
  18 .SH SYNOPSIS
  19 .LP
  20 .nf
  21 \fBarcstat\fR [\fB-hvxr\fR] [\fB-f field[,field]...\fR] [\fB-o file\fR] [\fB-s string\fR]
  22       [\fBinterval\fR [\fBcount\fR]]
  23 .fi
  24
  25 .SH DESCRIPTION
  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 \fBtime \fR
 231 .ad
 232 .RS 14n
 233 Time
 234 .RE
 235
 236 .sp
 237 .ne 2
 238 .na
 239 \fBarcsz \fR
 240 .ad
 241 .RS 14n
 242 ARC Size
 243 .RE
 244
 245 .sp
 246 .ne 2
 247 .na
 248 \fBdread \fR
 249 .ad
 250 .RS 14n
 251 Demand data accesses per second
 252 .RE
 253
 254 .sp
 255 .ne 2
 256 .na
 257 \fBeskip \fR
 258 .ad
 259 .RS 14n
 260 evict_skip per second
 261 .RE
 262
 263 .sp
 264 .ne 2
 265 .na
 266 \fBmiss% \fR
 267 .ad
 268 .RS 14n
 269 ARC miss percentage
 270 .RE
 271
 272 .sp
 273 .ne 2
 274 .na
 275 \fBmread \fR
 276 .ad
 277 .RS 14n
 278 Metadata accesses per second
 279 .RE
 280
 281 .sp
 282 .ne 2
 283 .na
 284 \fBpread \fR
 285 .ad
 286 .RS 14n
 287 Prefetch accesses per second
 288 .RE
 289
 290 .sp
 291 .ne 2
 292 .na
 293 \fBl2hit% \fR
 294 .ad
 295 .RS 14n
 296 L2ARC access hit percentage
 297 .RE
 298
 299 .sp
 300 .ne 2
 301 .na
 302 \fBl2hits \fR
 303 .ad
 304 .RS 14n
 305 L2ARC hits per second
 306 .RE
 307
 308 .sp
 309 .ne 2
 310 .na
 311 \fBl2miss \fR
 312 .ad
 313 .RS 14n
 314 L2ARC misses per second
 315 .RE
 316
 317 .sp
 318 .ne 2
 319 .na
 320 \fBl2read \fR
 321 .ad
 322 .RS 14n
 323 Total L2ARC accesses per second
 324 .RE
 325
 326 .sp
 327 .ne 2
 328 .na
 329 \fBl2size \fR
 330 .ad
 331 .RS 14n
 332 Size of the L2ARC
 333 .RE
 334
 335 .sp
 336 .ne 2
 337 .na
 338 \fBmtxmis \fR
 339 .ad
 340 .RS 14n
 341 mutex_miss per second
 342 .RE
 343
 344 .sp
 345 .ne 2
 346 .na
 347 \fBl2bytes \fR
 348 .ad
 349 .RS 14n
 350 bytes read per second from the L2ARC
 351 .RE
 352
 353 .sp
 354 .ne 2
 355 .na
 356 \fBl2miss% \fR
 357 .ad
 358 .RS 14n
 359 L2ARC access miss percentage
 360 .RE
 361
 362 .sp
 363 .ne 2
 364 .na
 365 \fBl2asize \fR
 366 .ad
 367 .RS 14n
 368 Actual (compressed) size of the L2ARC
 369 .RE
 370 .\"
 371
 372 .SH OPTIONS
 373 .LP
 374 The following options are supported:
 375
 376 .sp
 377 .ne 2
 378 .na
 379 \fB\fB-f\fR\fR
 380 .ad
 381 .RS 12n
 382 Display only specific fields. See \fBDESCRIPTION\fR for supported statistics.
 383 .RE
 384
 385 .sp
 386 .ne 2
 387 .na
 388 \fB\fB-h\fR\fR
 389 .ad
 390 .RS 12n
 391 Display help message.
 392 .RE
 393
 394 .sp
 395 .ne 2
 396 .na
 397 \fB\fB-o\fR\fR
 398 .ad
 399 .RS 12n
 400 Report statistics to a file instead of the standard output.
 401 .RE
 402
 403 .sp
 404 .ne 2
 405 .na
 406 \fB\fB-s\fR\fR
 407 .ad
 408 .RS 12n
 409 Display data with a specified separator (default: 2 spaces).
 410 .RE
 411
 412 .sp
 413 .ne 2
 414 .na
 415 \fB\fB-x\fR\fR
 416
 417 .ad
 418 .RS 12n
 419 Print extended stats (same as -f time,mfu,mru,mfug,mrug,eskip,mtxmis,dread,pread,read).
 420 .RE
 421
 422 .sp
 423 .ne 2
 424 .na
 425 \fB\fB-v\fR\fR
 426 .ad
 427 .RS 12n
 428 Show field headers and definitions
 429 .RE
 430
 431 .SH OPERANDS
 432 .LP
 433 The following operands are supported:
 434 .sp
 435 .ne 2
 436 .na
 437 \fB\fIcount\fR\fR
 438 .ad
 439 .RS 12n
 440 Display only \fIcount\fR reports.
 441 .RE
 442
 443 .sp
 444 .ne 2
 445 .na
 446 \fB\fIinterval\fR\fR
 447 .ad
 448 .RS 12n
 449 Specify the sampling interval in seconds.
 450 .RE
 451
 452 .SH AUTHORS
 453 .LP
 454 arcstat was originally written by Neelakanth Nadgir and supported only ZFS ARC statistics.
 455 Mike Harsch updated it to support L2ARC statistics.