NFS monitoring integration

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.

Complete the following steps to set up the NFS integration:

Check compatibility and requirements

Our integration is compatible with NFS version 3 and above.

Install the infrastructure agent

To use the NFS integration, you need to first install the infrastructure agent on the same host.

Install and activate

The NFS integration is already activated and installed by default with the infrastructure agent. There are no installation or activation requirements, as it works out of the box.

Find and use data

To find your integration data:

Go to one.newrelic.com > All capabilities > Infrastructure > Third-party services
Search for NFS integration.
Click on the NFS dashboard.
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 counter, 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.

Check compatibility and requirements .css-21sua1{background:none;border:none;width:0;padding:0;}