Free disk space 🔗
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 🔗
collectd/df monitor is being deprecated in favor of the
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/dfused a dimension called
plugin_instanceto identify the mount point or device of the filesystem. This dimension is completely removed in the
filesystemsmonitor and replaced by the
devicedimensions. You no longer have to select between the two (the
collectd/df) as both are always reported.
The mountpoints in the
collectd/dfwere reported with
-instead of the more conventional
/separated path segments. The
filesystemsmonitor always reports mountpoints in the
mountpointdimension and uses the conventional
collectd/dfplugin set a dimension
plugin: dfon all data points, but
filesystemshas no such comparable dimension.
To install this integration:
Deploy the OpenTelemetry Collector to your host or container platform.
Configure the monitor, as described in the next section.
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.
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.
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.
Configuration settings 🔗
The following table shows the configuration options for this monitor.
||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.|
||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
||The mount paths to include/exclude. This is an overridable set. Note: If you are using the hostFSPath option, do not include the
These are the metrics available for this monitor.