NFS monitoring integration

New Relic Infrastructure's on-host integrations include a Network File System (NFS) integration for sending data from your NFS mounts to New Relic products. This document explains how to install and activate the integration, and describes the data that can be captured.

Compatibility and requirements

To use the NFS integration, ensure your system meets these requirements:

Install and activate

On-host integrations do not automatically update. For best results, you should occasionally update the integration and update the Infrastructure agent.

The NFS integration is already activated and installed by default. Therefore, there are no installation or activation requirements, as it works out of the box. Please see configuring plugins, and search for NFS for more info on configuring NFS.

Find and use data

To find your integration data in Infrastructure, go to infrastructure.newrelic.com > Third-party services and select the NFS integration link.

When querying your data, NFS data is attached to the NFSSample event type.

For more on how to find and use your data, see Understand and use integration data.

Metric data

The NFS integration collects the following metrics:

These metrics are captured by default:

Name Description
diskTotalBytes Total number of available bytes on disk.
diskUsedBytes Total number of bytes used.
diskUsedPercent Percentage of bytes used.
diskFreeBytes Total number of available bytes left on disk.
diskFreePercent Percent of free space available on disk.
totalReadBytes Total number of bytes read.
totalWriteBytes Total number of bytes written.
readBytesPerSecond Number of bytes read per second.
writeBytesPerSecond Number of bytes written per second.
readsPerSecond Number of read operations per second.
writesPerSecond Number of write operations per second.
totalOpsPerSecond Total number of operations per second.
version NFS version (will be either 3.0 or 4.0).
device Device name.
mountPoint Mount point of NFS volume.
filesystemType Filesystem type.

Additional metrics captured when detailed_nfs is enabled (set to true in the Infrastructure configuration file):

Name Description
ageSeconds Age in seconds of NFS client.
inodeRevalidate Number of times cached inode attributes are re-validated from the server.
dnodeRevalidate Number of times cached dentry nodes are re-validated from the server.
dataInvalidate Number of times an inode cache is cleared.
attributeInvalidate Number of times cached inode attributes are invalidated.
vfsOpen Number of times files or directories have been open()'d.
vfsLookUp Number of times a directory lookup has occurred.
vfsAccess Number of times permissions have been checked.
vfsUpdatePage Number of updates (and potential writes) to pages.
vfsReadPage Number of pages read directly via mmap()'d files.
vfsReadPages Number of times a group of pages have been read.
vfsWritePage Number of pages written directly via mmap()'d files.
vfsWritePages Number of times a group of pages have been written.
vfsGetDents Number of times directory entries have been read with getdents().
vfsSetattr Number of times attributes have been set on inodes.
vfsFlush Number of pending writes that have been forcefully flushed to the server.
vfsFsync Number of times fsync() has been called on directories and files.
vfsLock Number of times locking has been attempted on a file.
vfsFileRelease Number of times files have been closed and released.
truncation Number of times files have been truncated.
writeExtension Number of times a file has been grown due to writes beyond its existing end.
sillyRename Number of times a file was removed while still open by another process.
shortRead Number of times the NFS server gave less data than expected while reading.
shortWrite Number of times the NFS server wrote less data than expected while writing.
jukeboxDelay Number of times the NFS server indicated EJUKEBOX; retrieving data from offline storage.
pnfsRead Number of NFS v4.1+ pNFS reads.
pnfsWrite Number of NFS v4.1+ pNFS writes.
bind Number of times the client has had to establish a connection from scratch to the NFS server.
connect Number of times the client has made a TCP connection to the NFS server.
connectIdleTime Duration (in jiffies, a kernel internal unit of time) the NFS mount has spent waiting for connections to the server to be established.
idleTimeSeconds Duration since the NFS mount last saw any RPC traffic.
send Number of RPC requests for this mount sent to the NFS server.
receive Number of RPC responses for this mount received from the NFS server.
badTransactionIds Number of times the NFS server sent a response with a transaction ID unknown to this client.
cumulativeActiveRequest A running er, incremented on each request as the current difference between sends and receives.
cumulativeBacklog A running counter, incremented on each request by the current backlog queue size.
maximumRPCSlotsUsed Maximum number of simultaneously active RPC requests ever used.
cumulativeSendingQueue A running counter, incremented on each request as the current size of the sending queue.
cumulativePendingQueue A running counter, incremented on each request as the current size of the pending queue.

For more help

Recommendations for learning more: