Docs » Available host and application monitors » Configure application receivers for hosts and servers » Free disk space

Free disk space πŸ”—

Description πŸ”—

The Splunk Distribution of OpenTelemetry Collector provides this integration as the filesystem monitor via the Smart Agent Receiver.

This monitor reports metrics about free disk space on mounted devices.

On Linux hosts, this monitor relies on the /proc filesystem. If the underlying host’s /proc file system is mounted somewhere other than /proc, specify the path using the top level configuration procPath, as shown in the following example:

procPath: /hostfs/proc
monitors:
 - type: filesystems
   hostFSPath: /hostfs

This monitor does not accept endpoints. This monitor does allow multiple instances.

Migrating from collectd/df πŸ”—

The collectd/df monitor is being deprecated in favor of the filesystems monitor. While the collectd/df monitor will still be available in version 5.0, switch to the filesystems monitor soon after upgrading. There are a few incompatibilities to be aware of between the two monitors:

  • collectd/df used a dimension called plugin_instance to identify the mount point or device of the filesystem. This dimension is completely removed in the filesystems monitor and replaced by the mountpoint and device dimensions. You no longer have to select between the two (the reportByDevice option on collectd/df) as both are always reported.

  • The mountpoints in the plugin_instance dimension of collectd/df were reported with - instead of the more conventional / separated path segments. The filesystems monitor always reports mountpoints in the mountpoint dimension and uses the conventional / separator.

  • The collectd/df plugin set a dimension plugin: df on all data points, but filesystems has no such comparable dimension.

Installation πŸ”—

This monitor is available in the SignalFx Smart Agent Receiver, which is part of the Splunk Distribution of OpenTelemetry Collector.

To install this integration:

  1. Deploy the OpenTelemetry Collector to your host or container platform.

  2. Configure the monitor, as described in the next section.

Configuration πŸ”—

The Splunk Distribution of OpenTelemetry Collector allows embedding a Smart Agent monitor configuration in an associated Smart Agent Receiver instance.

Note: Providing a filesystems monitor entry in your Smart Agent or Collector configuration is required for its use. Use the appropriate form for your agent type.

Splunk Distribution of OpenTelemetry Collector πŸ”—

If you are using the Splunk Distribution of OpenTelemetry Collector and want to collect file system utilization metrics, use the Host metrics receiver.

Smart Agent πŸ”—

If you are using this monitor in the Smart Agent, add the following to your agent configuration:

monitors:  # All monitor config goes under this key
 - type: filesystems
   ...  # Additional config

See Smart Agent example configuration for an autogenerated example of a YAML configuration file, with default values where applicable.

Configuration settings πŸ”—

The following table shows the configuration options for this monitor.

Option

Required

Type

Description

hostFSPath

no

string

Path to the root of the host filesystem. It is useful when running in a container and the host filesystem is mounted in a subdirectory under /. The disk usage metrics emitted will be based at this path.

fsTypes

no

list of strings

The filesystem types to include/exclude. This is an overridable set. If this is not set, the default value is the set of all non-logical/virtual filesystems on the system. On Linux this list is determined by reading the /proc/filesystems file and choosing the filesystems that do not have the nodev modifier.

mountPoints

no

list of strings

The mount paths to include/exclude. This is an overridable set. Note: If you are using the hostFSPath option, do not include the /hostfs/ mount in the filter. If both this and fsTypes are specified, the two filters combine in an AND relationship.

sendModeDimension

no

bool

Set to true to emit the β€œmode” dimension, which represents whether the mount is β€œrw” or β€œro”. (default: false)

Metrics πŸ”—

The following metrics are available for this integration:

Get help πŸ”—

If you are not able to see your data in Splunk Observability Cloud, try these tips:

To learn about even more support options, see Splunk Customer Success.