NFSometer

From Linux NFS

Revision as of 16:33, 30 November 2012

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.

News

• Fri Nov 30, 2012: NFSometer v1.2 has been 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

Main git repository:

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

Releases:

• Fri Nov 30, 2012 : nfsometer-1.2.tar.gz (md5sum: 86ca117b3265ce40408b2015e96482b5)
• Fri Jul 20, 2012 : nfsometer-1.1.tar.gz (md5sum: efbca65ec863b63cb852baac5ff409cf)
• Thu Jun 21, 2012 : nfsometer-1.0.tgz (md5sum: 9d8873517c0365dc04d28b585e0ba31b)

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:

$ ./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

Here is a screenshot of part of the generated report:

Feedback

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

For contributions, see howto-contribute.txt.