Our NFS integration collects and sends inventory and metrics from your NFS service to our platform, where you can see disk usage data so that you can more easily find the source of any problems.

Read on to install the integration, and to see what data we collect.

Compatibility and requirements

Our integration is compatible with NFS version 3 or 4.

Before installing the integration, make sure that you meet the following requirements:

Install the infrastructure agent, minimum version 1.5.40, on host (NFS client)
Linux distribution compatible with the infrastructure agent

Install and activate

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. See samples variables, and search for NFS for more info.

Did this doc help with your installation?

Find and use data

To find your integration data go to one.newrelic.com > Infrastructure > 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:

Default 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.

Extended metrics

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.

Disabling the integration

Set metrics_nfs_sample_rate to -1 in the Infrastructure agent configuration file to avoid scraping NFS metrics.

NFS monitoring integration