forked from mharsch/arcstat
-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
95 lines (78 loc) · 3.25 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
This repository contains a bunch of zfs nagios, munin, healthcheck, and
status scripts grabbed from various sources over the net, and ported to linux
arcstat.pl is a Perl script that uses the linux proc interface to read
ZFS ARC kstat values from the system running zfsonlinux and report on
an interval basis.
Some output examples can be found on the original author's blog here:
http://blogs.oracle.com/realneel/entry/zfs_arc_statistics
Examples showing L2ARC data can be found here:
http://blog.harschsystems.com/tools/arcstat-pl-updated-for-l2arc-statistics/
Note: L2ARC statistics are only available on systems that have implemented
the L2ARC (i.e. nevada-based releases).
Usage for arcstat.pl can be obtained by providing the "--help" flag:
./arcstat.pl --help
Usage: arcstat.pl [-hvxr] [-f fields] [-o file] [interval [count]]
-x : Print extended stats
-r : Raw Output mode (values not scaled)
-f : Specify specific fields to print (see -v)
-o : Print stats to file
-s : Specify a seperator
Examples:
arcstat -o /tmp/a.log 2 10
arcstat -s , -o /tmp/a.log 2 10
arcstat -v
arcstat -f time,hit%,dh%,ph%,mh%
arcstat 1
arcstat -f read,hits,miss,hit%,l2read,l2hits,l2miss,l2hit%,arcsz,l2size 1
Available fields (statistics) can be retrieved with the "-v" flag:
./arcstat.pl -v
Usage: arcstat.pl [-hvxr] [-f fields] [-o file] [interval [count]]
Field definitions are as follows
mtxmis : mutex_miss per second
arcsz : Arc Size
mrug : MRU Ghost List hits per second
l2hit% : L2ARC access hit percentage
mh% : Metadata hit percentage
l2miss% : L2ARC access miss percentage
read : Total Arc accesses per second
l2asize : Actual (compressed) size of the L2ARC
c : Arc Target Size
mfug : MFU Ghost List hits per second
miss : Arc misses per second
dm% : Demand Data miss percentage
dhit : Demand Data hits per second
pread : Prefetch accesses per second
dread : Demand data accesses per second
pmis : Prefetch misses per second
l2miss : L2ARC misses per second
time : Time
l2bytes : bytes read per second from the L2ARC
pm% : Prefetch miss percentage
mm% : Metadata miss percentage
hits : Arc reads per second
mfu : MFU List hits per second
l2read : Total L2ARC accesses per second
mmis : Metadata misses per second
rmis : recycle_miss per second
mhit : Metadata hits per second
dmis : Demand Data misses per second
mru : MRU List hits per second
ph% : Prefetch hits percentage
eskip : evict_skip per second
l2size : Size of the L2ARC
l2hits : L2ARC hits per second
hit% : Arc Hit percentage
miss% : Arc miss percentage
dh% : Demand Data hit percentage
mread : Metadata accesses per second
phit : Prefetch hits per second
=======================================================
archits.sh came from:
http://dtrace.org/blogs/brendan/2012/01/09/activity-of-the-zfs-arc/
Usage: ./archits.sh 1
=======================================================
arc_summary.pl originally came from: http://cuddletech.com/arc_summary/
ported to freebsd: http://jhell.googlecode.com/files/arc_summary.pl
Usage: ./arc_summary.pl
=======================================================
munin/* from http://cvs.pfsense.org/~sullrich/misc/munin/zfs/