NFSometer

From Linux NFS

(Difference between revisions)
Jump to: navigation, search
(Download)
(Example)
Line 45: Line 45:
== Example ==
== Example ==
-
The following command will run the Connectathon test suite once for each NFS protocol version (v3, v4.0, v4.1) and generate a report:
+
Here is an example nfsometer report. The reports have notes explaining what was run.
-
<pre>
+
[http://linux-nfs.org/~dros/nfsometer/example1/ example 1]: run cthon workload with and without a loaded server.
-
$ ./nfsometer.py zero:/export cthon
+
-
 
+
-
Requested: 1 workloads X 3 nfsopts X 1 runs = 3 test runs
+
-
Need to run 3 of 3 requested test runs
+
-
cthon - needs 1 runs of vers=3
+
-
cthon - needs 1 runs of vers=4
+
-
cthon - needs 1 runs of vers=4,minorversion=1
+
-
 
+
-
Trace 1/3: 1/1 with workload: cthon, nfsopts: vers=3
+
-
< SETUP >
+
-
Mounting: zero:/export...
+
-
remove run directory: /mnt/nfsometer_runroot/cthon
+
-
Unmounting: zero:/export...
+
-
< RUN >
+
-
Mounting: zero:/export...
+
-
Running command: cd /home/dros/nfsometer/tests/cthon/cthon && NFSTESTDIR="/mnt/nfsometer_runroot/cthon" ./runtests -a
+
-
Unmounting: zero:/export...
+
-
Results copied to: nfsometer_trace-cthon-vers=3-0
+
-
 
+
-
Trace 2/3: 1/1 with workload: cthon, nfsopts: vers=4
+
-
< SETUP >
+
-
Mounting: zero:/export...
+
-
remove run directory: /mnt/nfsometer_runroot/cthon
+
-
Unmounting: zero:/export...
+
-
< RUN >
+
-
Mounting: zero:/export...
+
-
Running command: cd /home/dros/nfsometer/tests/cthon/cthon && NFSTESTDIR="/mnt/nfsometer_runroot/cthon" ./runtests -a
+
-
Unmounting: zero:/export...
+
-
Results copied to: nfsometer_trace-cthon-vers=4-0
+
-
 
+
-
Trace 3/3: 1/1 with workload: cthon, nfsopts: vers=4,minorversion=1
+
-
< SETUP >
+
-
Mounting: zero:/export...
+
-
remove run directory: /mnt/nfsometer_runroot/cthon
+
-
Unmounting: zero:/export...
+
-
< RUN >
+
-
Mounting: zero:/export...
+
-
Running command: cd /home/dros/nfsometer/tests/cthon/cthon && NFSTESTDIR="/mnt/nfsometer_runroot/cthon" ./runtests -a
+
-
Unmounting: zero:/export...
+
-
Results copied to: nfsometer_trace-cthon-vers=4,minorversion=1-0
+
-
 
+
-
Successfully ran 3 traces!
+
-
 
+
-
Generating reports:
+
-
 
+
-
Saved: index.html
+
-
Saved: Report_Averages.html
+
-
 
+
-
 
+
-
graph summary: 47 generated, 0 cached, 0 mismatch, 0 pruned,
+
-
    0 hash files and 0 other files deleted
+
-
 
+
-
Report index: /home/dros/nfsometer/results/index.html
+
-
</pre>
+
-
 
+
-
Here is a screenshot of part of the generated report:
+
-
 
+
-
http://linux-nfs.org/~dros/nfsometer/nfsometer-report-screenshot-1.png
+
== Feedback ==
== Feedback ==

Revision as of 22:25, 22 February 2013

NFSometer is a performance measurement framework for running workloads and reporting results across NFS protocol versions, NFS options and Linux NFS client implementations.

The NFSometer project was started at NetApp as a way to automate performance testing of the Linux NFS client. Since then it has grown to include many other features, notably the generation of reports. It is our hope that by releasing this project under the GPLv2 license, the Linux NFS community will benefit from a better understanding of NFS performance characteristics and contribute improvements to NFSometer.

NFSometer is not designed to replace existing filesystem benchmarks. Instead, it is designed to automate the running of existing filesystem benchmarks, gather NFS specific statistics and generate reports that make benchmark output more understandable.

Goals:

  • Automate the time consuming process of running a variety of workloads looking for performance regressions between kernel versions, NFS protocol versions and NFS options.
  • Generate reports that allows the user to understand the performance characteristics of workloads and easily compare performance characteristics of different configurations.
  • Provide a simple way to define workloads. This allows users to evaluate NFS deployment scenarios with workloads representative of their unique needs.

Contents

News

  • Fri Feb 22, 2013: NFSometer v1.4 released! This version has a redesign of reports, many bugfixes and several new features.
  • Fri Dec 7, 2012: NFSometer v1.3 released! This version includes some major cleanup and bugfixes.
  • Fri Nov 30, 2012: NFSometer v1.2 released! This version includes, new options (notably -o replaces -m), basic loadgen functionality, probe mountopts and detect tags, replace poorly supported admin-script and client-script functionality with tags (-t option), bugfixes, etc
  • Thu Jun 21, 2012: NetApp is pleased to announce the GPLv2 release of NFSometer!

Download

The current release of nfsometer is version 1.4:

nfsometer-1.4.tar.gz (md5sum: ef6e3031b2c39c7eb439dd35197e6b76)

Old releases:

Main git repository:

'master' branch is current release, 'testing' branch is where all new development is happening.

  • git clone git://git.linux-nfs.org/projects/dros/nfsometer.git
  • NFSometer gitweb

Example

Here is an example nfsometer report. The reports have notes explaining what was run.

example 1: run cthon workload with and without a loaded server.

Feedback

Please send any bug reports, questions or comments to dros@netapp.com

For contributions, see howto-contribute.txt.

Personal tools