nfsstat — display
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:
-c- Show NFS client statistics.
-e- Show NFS server exported directory statistics.
-m
[mountpath]- Show NFS mount information.
-s- Show NFS server statistics.
-3- Print only NFS v3 statistics.
-4- Print only NFS v4 statistics.
-u- Show NFS server active user statistics.
-f
JSON- Print output as JSON format.
-w
wait- Display a shorter summary at wait second
intervals.
-n
net|user- Show network addresses as numbers, or show users as uid numbers. This
option can appear multiple times.
-z- Zero NFS client and server statistics.
-E- Show NFS protocol errors statistics.
-v- Show additional information (if available).
The data fields that nfsstat displays for
each set of statistics are:
NFSv3
Client Information:- Statistics for NFSv3 file system mounts.
- RPC Counts
- Counts of the RPC calls made to each of the NFSv3 protocol
procedures.
NLM Client
Information:- Statistics for the Network Lock Manager protocol.
- RPC Counts
- Counts of the LOCK, TEST and UNLOCK RPC calls of the NLM
protocol.
NFSv4
Client Information:- 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
Client Information:- 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.
NFSv3
Server Information:- 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)
NFS Server
Exported Directory Information:- 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.
NFS Server
Active User Information:- 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.
NFS Mount
Information:- 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.
-
NFS
Protocol Errors Information:-
- Information about NFS protocol errors categorized by error type.
-
- This option will provide a detailed breakdown of errors encountered
within the NFS layer.
-
The nfsstat command appears in
4.4BSD.