File: NfsInfo.html

package info (click to toggle)
collectl 3.7.4-1
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 1,624 kB
  • ctags: 119
  • sloc: perl: 14,928; sh: 429; makefile: 11
file content (86 lines) | stat: -rw-r--r-- 5,201 bytes parent folder | download | duplicates (5)
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
<html>
<head>
<link rel=stylesheet href="style.css" type="text/css">
<title>NFS Monitoring</title>
</head>

<body>
<center><h1>NFS Monitoring</h1></center>
<p>
<h3>Introduction</h3>
As of version 3.2.1, nfs monitoring has undergone a major change.  Unlike the old behavior which
only reported on the client or server for a specific version, by default nfs reporting now collects
data for all types of nfs data including nfs version 4.  This also means when reporting nfs 
summary data, all statistics are aggregated in both brief and summary formats.
<p>
A system typically runs one version of NFS and usually 
acts as a client or server and so by aggregating the data the numbers being reported in brief mode
will already be for a single type of data.  Furthermore, in verbose mode the client/server data are 
broken out so even if the system is acting as both a client and server you will be able to 
differentiate the data being reported.
<p>
As an optimization as well as a convenience, collectl looks at the <i>raw</i> read/write fields for 
each set of nfs data, which represent the totals since boot.
If those fields are both 0, it is assumed there is no nfs activity and the rest of
the statistics will also assumed to be zero.  With the excepion of the <i>detail format</i> 
descripted later, this all happens behind the scenes.  However, just because those fields are
non-zero does not mean there is currently nfs activity.  In fact if you mount a filesystem, write
to it and dismount it, those counters will remain non-zero until the system is rebooted.  In other
words, <i>this approach is not perfect</i> but simply provided as a mechanism to help reduce the 
need for user-specified filters to help focus the detail output.
<p>
<h3>Data Filtering</h3>
As they say, <i>your mileage may vary</i> and if your system is running mixed nfs versions and/or 
acting as a client <i>and</i> server and you really only want a subset of the activity included in
the summary or detail reports, you can modify the behavior by specifying one or more filters with
the <i>--nfsfilt</i> switch.  If you just select clients, only data for those clients will be included
in brief, summary and detail formats.  However, if recording to a <i>raw</i> file, collectl
will record data for all NFS client versions even if you've only selected one or two.  The same holds
true for servers.  When you do use <i>-nfsfilt</i>, those values are display in the brief and verbose
headers both during collection and playback.
<p>
<h3>Detail Data</h3>
The data collected for NFS V2 and V3 is quiet similar in that V3 reports of superset of what V2 reports
with the exception of <i>root</i> and <i>wrcache</i>.  V4 reports a lot more counters than either
but many of the same key ones as V3 and so the detail format has been standardized on the V3 counters.
In this mode, one line is reported for each of the 6 types, with blank entries for the non-common fields
as shown here. Note that only rows for those types determined to be <i>active</i> by checking the 
read/write fields or explicitly selected through filters, will be included:

<div class=terminal-wide14>
<pre>
# NFS SERVER/CLIENT DETAILS (/sec)
#Type Read Writ Comm Look Accs Gttr Sttr Rdir Cre8 Rmov Rnam Link Rlnk Null Syml Mkdr Rmdr Fsta Finf Path Mknd Rdr+
 Clt2    0    0         0         0    0    0    0    0    0    0    0    0    0    0    0    0
 Svr2    0    0         0         0    0    0    0    0    0    0    0    0    0    0    0    0
 Clt3    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0
 Svr3    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0
 Clt4    0    0    0    0    0    0    0    0    0    0    0    0    0    0    0                   0    0
 Svr4    0    0    0    0    0    0    0    0    0    0    0    0    0
</pre>
</div>
<p>
<center>
<table width=80%>
<tr align=center><td><b>TIP</b></td></tr>
<tr><td>Looking at detail data for more than one type of data can be difficult to watch.
Consider using <i>--home</i> which can give the feel of a real-time display in <i>top</i> format.</td></tr>
</table>
</center>
<p>
<h3>Playing back data generated by older versions of collectl</h3>
Collectl is smart enough to <i>do the right thing</i>.  In other words if you're playing back data generated
by a pre-3.2.1 version of collectl, collectl figures out what type of data the file contains and actually 
sets <i>--nfsfilt</i> for you (in fact it won't let you select it yourself) and only displays the type 
of data in the file.
<p>
<h3>Playing back newer data with older versions of collectl</h3>
Any raw file created by Version 3.2.1 or greater records nfs data in a format that will not
be recognized by earlier versions of collectl and any attempts to read it will result in fields of all
zeros.  It is not expected that this would typically happen but as they say, it is being stated here
for completeness.

<table width=100%><tr><td align=right><i>updated June 26, 2009</i></td></tr></colgroup></table>

</body>
</html>