summaryrefslogtreecommitdiffstats
path: root/src/go/collectors/go.d.plugin/modules/filecheck/metadata.yaml
blob: 57a121ec11fcd815bd12468c1b84e6e34c66af5a (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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
plugin_name: go.d.plugin
modules:
  - meta:
      id: collector-go.d.plugin-filecheck
      plugin_name: go.d.plugin
      module_name: filecheck
      monitored_instance:
        name: Files and directories
        link: ""
        icon_filename: filesystem.svg
        categories:
          - data-collection.linux-systems
      keywords:
        - files
        - directories
      related_resources:
        integrations:
          list: []
      info_provided_to_referring_integrations:
        description: ""
      most_popular: false
    overview:
      data_collection:
        metrics_description: |
          This collector monitors files and directories.
        method_description: ""
      supported_platforms:
        include: []
        exclude: []
      multi_instance: true
      additional_permissions:
        description: |
          This collector requires the DAC_READ_SEARCH capability, but it is set automatically during installation, so no manual configuration is needed.
      default_behavior:
        auto_detection:
          description: ""
        limits:
          description: ""
        performance_impact:
          description: ""
    setup:
      prerequisites:
        list: []
      configuration:
        file:
          name: go.d/filecheck.conf
        options:
          description: |
            The following options can be defined globally: update_every, autodetection_retry.
          folding:
            title: Config options
            enabled: true
          list:
            - name: update_every
              description: Data collection frequency.
              default_value: 10
              required: false
            - name: autodetection_retry
              description: Recheck interval in seconds. Zero means no recheck will be scheduled.
              default_value: 0
              required: false
            - name: files
              description: Files matching the selector will be monitored.
              default_value: ""
              required: true
              detailed_description: |
                Files matching the selector will be monitored.

                - Logic: (pattern1 OR pattern2) AND !(pattern3 or pattern4)
                - Pattern syntax: [shell file name pattern](https://golang.org/pkg/path/filepath/#Match)
                - Syntax:

                ```yaml
                files:
                  includes:
                    - pattern1
                    - pattern2
                  excludes:
                    - pattern3
                    - pattern4
                ```
            - name: dirs
              description: List of directories to monitor.
              default_value: ""
              required: true
              detailed_description: |
                Directories matching the selector will be monitored.

                - Logic: (pattern1 OR pattern2) AND !(pattern3 or pattern4)
                - Pattern syntax: [shell file name pattern](https://golang.org/pkg/path/filepath/#Match)
                - Syntax:

                ```yaml
                dirs:
                  includes:
                    - pattern1
                    - pattern2
                  excludes:
                    - pattern3
                    - pattern4
                ```
            - name: discovery_every
              description: Files and directories discovery interval.
              default_value: 60
              required: false
        examples:
          folding:
            title: Config
            enabled: true
          list:
            - name: Files
              description: Files monitoring example configuration.
              config: |
                jobs:
                  - name: files_example
                    files:
                      include:
                        - '/path/to/file1'
                        - '/path/to/file2'
                        - '/path/to/*.log'
            - name: Directories
              description: Directories monitoring example configuration.
              config: |
                jobs:
                  - name: files_example
                    dirs:
                      collect_dir_size: no
                      include:
                        - '/path/to/dir1'
                        - '/path/to/dir2'
                        - '/path/to/dir3*'
    troubleshooting:
      problems:
        list: []
    alerts: []
    metrics:
      folding:
        title: Metrics
        enabled: false
      description: ""
      availability: []
      scopes:
        - name: global
          description: TBD
          labels: []
          metrics:
            - name: filecheck.file_existence
              description: 'File Existence (0: not exists, 1: exists)'
              unit: boolean
              chart_type: line
              dimensions:
                - name: a dimension per file
            - name: filecheck.file_mtime_ago
              description: File Time Since the Last Modification
              unit: seconds
              chart_type: line
              dimensions:
                - name: a dimension per file
            - name: filecheck.file_size
              description: File Size
              unit: bytes
              chart_type: line
              dimensions:
                - name: a dimension per file
            - name: filecheck.dir_existence
              description: 'Dir Existence (0: not exists, 1: exists)'
              unit: boolean
              chart_type: line
              dimensions:
                - name: a dimension per directory
            - name: filecheck.dir_mtime_ago
              description: Dir Time Since the Last Modification
              unit: seconds
              chart_type: line
              dimensions:
                - name: a dimension per directory
            - name: filecheck.dir_num_of_files
              description: Dir Number of Files
              unit: files
              chart_type: line
              dimensions:
                - name: a dimension per directory
            - name: filecheck.dir_size
              description: Dir Size
              unit: bytes
              chart_type: line
              dimensions:
                - name: a dimension per directory