NFSSTAT(1) General Commands Manual NFSSTAT(1)

nfsstatdisplay NFS statistics

nfsstat [-cseuv] [-w wait] [-n net|user] [-m [mountpath]]

nfsstat displays statistics kept about NFS client and server activity, active user activity, exported directories, and mount information. In the absence of any options, nfsstat displays NFS client and server statistics.

The options are as follows:

Show NFS client statistics.
Show NFS server exported directory statistics.
[mountpath]
Show NFS mount information.
Show NFS server statistics.
Print only NFS v3 statistics.
Print only NFS v4 statistics.
Show NFS server active user statistics.
JSON
Print output as JSON format.
wait
Display a shorter summary at wait second intervals.
net|user
Show network addresses as numbers, or show users as uid numbers. This option can appear multiple times.
Zero NFS client and server statistics.
Show NFS protocol errors statistics.
Show additional information (if available).

The data fields that nfsstat displays for each set of statistics are:

Statistics for NFSv3 file system mounts.
RPC Counts
Counts of the RPC calls made to each of the NFSv3 protocol procedures.
Statistics for the Network Lock Manager protocol.
RPC Counts
Counts of the LOCK, TEST and UNLOCK RPC calls of the NLM protocol.
Statistics for NFSv4 file system mounts.
RPC Counts
Counts of the RPC calls made to each of the NFSv4 protocol procedures.
Operations Counts
Counts of the operations calls made by the client within the compound procedure.
Common statistics for NFS file system mounts.
RPC Info
Statistics for NFS RPC calls:
TimedOut
RPC calls that timed out, perhaps to a slow or dead server.
Invalid
Invalid RPC replies.
X Replies
RPC replies received that did not have calls pending.
Retries
RPC calls that were retried.
Requests
Total number of RPC calls made.
Cache Info
Statistics on NFS client-side cache performance:
Attr Hits/Misses
Performance of the NFS file attribute cache.
Lkup Hits/Misses
Performance of the directory name lookup cache.
BioR Hits/Misses
Performance of block cache for reads.
BioW Hits/Misses
Performance of block cache for writes.
BioRL Hits/Misses
Performance of symbolic link cache.
BioD Hits/Misses
Performance of directory cache.
DirE Hits/Misses
Performance of directory offset cache.
Accs Hits/Misses
Performance of access rights cache.
Paging Info
Counts both pagein and pageout operations.
Statistics for the NFSv3 server.
RPC Counts
Counts of RPC calls on each of the NFS server's procedures are recorded here.
Server Ret-Failed
RPC errors returned by the server.
Server Faults
Errors in the NFS server.
Server Cache Stats
Statistics from the NFS server's RPC duplicate request cache:
Inprog
Calls already in progress.
Idem
Cache hits for idempotent procedures.
Non-idem
Cache hits for non-idempotent procedures.
Misses
Cache Misses.
Server Write Gathering
These statistics describe the efficiency of the NFS server's write gathering feature.
WriteOps
Write operations to disk.
WriteRPC
Write operations received by the server.
Opsaved
Write operations that were gathered (WriteRPC - WriteOps)
Statistics for each exported directory on the NFS server.
NFS Requests
Count of NFS requests processed by an exported directory.
Bytes Read
Count of bytes read from an exported directory.
Bytes Written
Count of bytes written to an exported directory.
List of active NFS users and statistics on the NFS server.
NFS Requests
Count of NFS requests received from an active user.
Bytes Read
Count of bytes read by an active user.
Bytes Written
Count of bytes written by an active user.
Idle
Amount of time an active user has been idle.
User
Name (or uid if -n user was given) of active user.
IP Address
Host name (or network address if -n net was given) of client machine.
Information about the given NFS mount (or all NFS mounts).
The path mounted on and the server:/path that is mounted.
 
Mount arguments originally passed in to the mount.
 
Current mount parameter values and status information.
 
Information about NFS protocol errors categorized by error type.
 
This option will provide a detailed breakdown of errors encountered within the NFS layer.
 

netstat(1), iostat(8), mount_nfs(8), nfsd(8)

The nfsstat command appears in 4.4BSD.

January 11, 2011 BSD 4.4