summaryrefslogtreecommitdiffstats
path: root/collectors/diskspace.plugin/metadata.yaml
blob: cb45edf3495cf04807cd1b9bb5b93218d8aa8b41 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
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: 15
              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/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/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