plugin_name: diskspace.plugin
modules:
  - meta:
      plugin_name: diskspace.plugin
      module_name: diskspace.plugin
      monitored_instance:
        name: Disk space
        link: ""
        categories:
          - data-collection.linux-systems
        icon_filename: "hard-drive.svg"
      related_resources:
        integrations:
          list:
            - plugin_name: ebpf.plugin
              module_name: disk
      info_provided_to_referring_integrations:
        description: ""
      keywords:
        - disk
        - I/O
        - space
        - inode
      most_popular: false
    overview:
      data_collection:
        metrics_description: "Monitor Disk space metrics for proficient storage management. Keep track of usage, free space, and error rates to prevent disk space issues."
        method_description: ""
      supported_platforms:
        include: []
        exclude: []
      multi_instance: true
      additional_permissions:
        description: ""
      default_behavior:
        auto_detection:
          description: "The plugin reads data from `/proc/self/mountinfo` and `/proc/diskstats file`."
        limits:
          description: ""
        performance_impact:
          description: ""
    setup:
      prerequisites:
        list: []
      configuration:
        file:
          name: "netdata.conf"
          section_name: "[plugin:proc:diskspace]"
          description: "This is netdata main configuration file"
        options:
          description: "You can also specify per mount point `[plugin:proc:diskspace:mountpoint]`"
          folding:
            title: "Config options"
            enabled: true
          list:
            - name: update every
              description: Data collection frequency.
              default_value: 1
              required: false
            - name: remove charts of unmounted disks
              description: Remove chart when a device is unmounted on host.
              default_value: yes
              required: false
            - name: check for new mount points every
              description: Parse proc files frequency.
              default_value: 15s
              required: false
            - name: exclude space metrics on paths
              description: Do not show metrics (charts) for listed paths. This option accepts netdata simple pattern.
              default_value: /proc/* /sys/* /var/run/user/* /run/user/* /snap/* /var/lib/docker/*
              required: false
            - name: exclude space metrics on filesystems
              description: Do not show metrics (charts) for listed filesystems. This option accepts netdata simple pattern.
              default_value: "*gvfs *gluster* *s3fs *ipfs *davfs2 *httpfs *sshfs *gdfs *moosefs fusectl autofs"
              required: false
            - name: exclude inode metrics on filesystems
              description: Do not show metrics (charts) for listed filesystems. This option accepts netdata simple pattern.
              default_value: msdosfs msdos vfat overlayfs aufs* *unionfs
              required: false
            - name: space usage for all disks
              description: Define if plugin will show metrics for space usage. When value is set to `auto` plugin will try to access information to display if filesystem or path was not discarded with previous option.
              default_value: auto
              required: false
            - name: inodes usage for all disks
              description: Define if plugin will show metrics for inode usage. When value is set to `auto` plugin will try to access information to display if filesystem or path was not discarded with previous option.
              default_value: auto
              required: false
        examples:
          folding:
            enabled: true
            title: ""
          list: []
    troubleshooting:
      problems:
        list: []
    alerts:
      - name: disk_space_usage
        link: https://github.com/netdata/netdata/blob/master/src/health/health.d/disks.conf
        metric: disk.space
        info: disk ${label:mount_point} space utilization
        os: "linux freebsd"
      - name: disk_inode_usage
        link: https://github.com/netdata/netdata/blob/master/src/health/health.d/disks.conf
        metric: disk.inodes
        info: disk ${label:mount_point} inode utilization
        os: "linux freebsd"
    metrics:
      folding:
        title: Metrics
        enabled: false
      description: ""
      availability: []
      scopes:
        - name: mount point
          description: ""
          labels:
            - name: mount_point
              description: Path used to mount a filesystem
            - name: filesystem
              description: The filesystem used to format a partition.
            - name: mount_root
              description: Root directory where mount points are present.
          metrics:
            - name: disk.space
              description: Disk Space Usage
              unit: "GiB"
              chart_type: stacked
              dimensions:
                - name: avail
                - name: used
                - name: reserved_for_root
            - name: disk.inodes
              description: Disk Files (inodes) Usage
              unit: "inodes"
              chart_type: stacked
              dimensions:
                - name: avail
                - name: used
                - name: reserved_for_root