Skip to content

This documentation has moved

This content now lives on the Virtana documentation site and is no longer updated. This site will be taken offline on January 31, 2027.

Go to the current documentation and update your bookmarks.

host-filesystem datasource

The host-filesystem datasource collects information about file systems from the operating system and creates entities and metric data points.

Metrics

Name Units Description
filesystem.free blocks Available storage blocks
filesystem.inodes_free inodes Available inodes
filesystem.inodes_total inodes Total inodes
filesystem.inodes_used inodes Used inodes
filesystem.inodes_utilization percent inode utilization
filesystem.used blocks Used storage blocks
filesystem.utilization percent Overall utilization

Name styles

This datasource supports two mutually exclusive naming styles for the metrics that it collects:

  • canonical: The default style, which features namespace prefixes.
  • linuxMonitorZenPack: The legacy style, used in the Linux Monitor ZenPack.

To change the default style, set the metric-names-variant property in the datasource section to linuxMonitorZenPack.

Canonical style ZenPack style
filesystem.free disk_availBlocks
filesystem.used disk_usedBlocks
filesystem.utilization disk_percentUsed
filesystem.inodes_total idisk_totalInodes
filesystem.inodes_free idisk_availableInodes
filesystem.inodes_used disk_usedInodes
filesystem.inodes_utilization idisk_percentInodesUsed

Entities

Property Description
name File system mount point
capacityBytes File system size, in bytes
mount File system mount point
mode File system read/write mode
storageDevice File system physical storage drive
type File system type

Example

{
  "capacityBytes": "28926365696",
  "mode": "rw",
  "mount": "/dev",
  "name": "/dev",
  "storageDevice": "devtmpfs",
  "type": "devtmpfs"
}

Configuration

If you specify the host-filesystem datasource during installation, its configuration file is placed in the following location:

/etc/zendatamon-configs/configs/host-filesystem.config.yaml

Otherwise, you must copy it from the templates directory:

cp /etc/zendatamon-configs/.templates/.configs/host-filesystem.config.yaml \
  /etc/zendatamon-configs/configs/host-filesystem.config.yaml

The Virtana Service Observability agent service monitors the /etc/zendatamon-configs/configs directory and loads any new or changed configuration files immediately.

Properties

interval (number)
The number of seconds to wait between collection attempts. This value overrides the defaultInterval value in the Virtana Service Observability agent service configuration file.
timeout (number)
The number of seconds to wait before dropping a collection attempt.
metric-names-variant (string, default = canonical)
The metric name style, either canonical or linuxMonitorZenPack.
protocol (string, default = local)
Collection type; only local is supported, so this key can be omitted.
ignore-names (array)
A list of regular expressions that identify a set of file system not to collect. If empty or omitted, all file systems collected.
ignore-types (array)
A list of file system types to skip during collection. If empty or omitted, all file systems types are collected.

Example

apiVersion: v1
kind: datasource
name: host-filesystem
spec:
  type: host-filesystem
  datasource:
    interval: 60
    timeout: 30
    metric-names-variant: canonical
    protocol: ""
    ignore-names: ""
    ignore-types:
      - other
      - ram
      - virtualMemory
      - removableDisk
      - floppyDisk
      - compactDisk
      - ramDisk
      - flashMemory
      - networkDisk

ZenPack compatibility

For compatibility with the Linux Monitor ZenPack, use the action service to create a metric trigger (and accompanying destination and rule) for filesystem.utilization data points that are greater than 90%.