@cryptotaxi247 / netdata-1 / commits / 4af88422a

remove python.d/sambsa (#18413)

Ilya Mashchenko committed Aug 26, 2024 at 17:56 UTC 4af88422ac7795041bcbca9bd574e32396c90dd2

6 files changed -667

CMakeLists.txt

-2

@@ -2834,7 +2834,6 @@ install(FILES

2834 src/collectors/python.d.plugin/openldap/openldap.conf

2835 src/collectors/python.d.plugin/oracledb/oracledb.conf

2836 src/collectors/python.d.plugin/pandas/pandas.conf

2837 - src/collectors/python.d.plugin/samba/samba.conf

2837 src/collectors/python.d.plugin/spigotmc/spigotmc.conf

2838 src/collectors/python.d.plugin/traefik/traefik.conf

2839 src/collectors/python.d.plugin/varnish/varnish.conf

@@ -2851,7 +2850,6 @@ install(FILES

2850 src/collectors/python.d.plugin/openldap/openldap.chart.py

2851 src/collectors/python.d.plugin/oracledb/oracledb.chart.py

2852 src/collectors/python.d.plugin/pandas/pandas.chart.py

2854 - src/collectors/python.d.plugin/samba/samba.chart.py

2853 src/collectors/python.d.plugin/spigotmc/spigotmc.chart.py

2854 src/collectors/python.d.plugin/traefik/traefik.chart.py

2855 src/collectors/python.d.plugin/varnish/varnish.chart.py

src/collectors/python.d.plugin/samba/README.md deleted

-1

@@ -1 +0,0 @@

1 -integrations/samba.md

\ No newline at end of file

src/collectors/python.d.plugin/samba/integrations/samba.md deleted

-255

@@ -1,255 +0,0 @@

1 -<!--startmeta

2 -custom_edit_url: "https://github.com/netdata/netdata/edit/master/src/collectors/python.d.plugin/samba/README.md"

3 -meta_yaml: "https://github.com/netdata/netdata/edit/master/src/collectors/python.d.plugin/samba/metadata.yaml"

4 -sidebar_label: "Samba"

5 -learn_status: "Published"

6 -learn_rel_path: "Collecting Metrics/Storage, Mount Points and Filesystems"

7 -most_popular: False

8 -message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE COLLECTOR'S metadata.yaml FILE"

9 -endmeta-->

10 -

11 -# Samba

12 -

13 -

14 -<img src="https://netdata.cloud/img/samba.svg" width="150"/>

15 -

16 -

17 -Plugin: python.d.plugin

18 -Module: samba

19 -

20 -<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />

21 -

22 -## Overview

23 -

24 -This collector monitors the performance metrics of Samba file sharing.

25 -

26 -It is using the `smbstatus` command-line tool.

27 -

28 -Executed commands:

29 -

30 -- `sudo -n smbstatus -P`

31 -

32 -

33 -This collector is supported on all platforms.

34 -

35 -This collector only supports collecting metrics from a single instance of this integration.

36 -

37 -`smbstatus` is used, which can only be executed by `root`. It uses `sudo` and assumes that it is configured such that the `netdata` user can execute `smbstatus` as root without a password.

38 -

39 -

40 -### Default Behavior

41 -

42 -#### Auto-Detection

43 -

44 -After all the permissions are satisfied, the `smbstatus -P` binary is executed.

45 -

46 -#### Limits

47 -

48 -The default configuration for this integration does not impose any limits on data collection.

49 -

50 -#### Performance Impact

51 -

52 -The default configuration for this integration is not expected to impose a significant performance impact on the system.

53 -

54 -

55 -## Metrics

56 -

57 -Metrics grouped by *scope*.

58 -

59 -The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.

60 -

61 -

62 -

63 -### Per Samba instance

64 -

65 -These metrics refer to the entire monitored application.

66 -

67 -This scope has no labels.

68 -

69 -Metrics:

70 -

71 -| Metric | Dimensions | Unit |

72 -|:------|:----------|:----|

73 -| syscall.rw | sendfile, recvfile | KiB/s |

74 -| smb2.rw | readout, writein, readin, writeout | KiB/s |

75 -| smb2.create_close | create, close | operations/s |

76 -| smb2.get_set_info | getinfo, setinfo | operations/s |

77 -| smb2.find | find | operations/s |

78 -| smb2.notify | notify | operations/s |

79 -| smb2.sm_counters | tcon, negprot, tdis, cancel, logoff, flush, lock, keepalive, break, sessetup | count |

80 -

81 -

82 -

83 -## Alerts

84 -

85 -There are no alerts configured by default for this integration.

86 -

87 -

88 -## Setup

89 -

90 -### Prerequisites

91 -

92 -#### Enable the samba collector

93 -

94 -The `samba` collector is disabled by default. To enable it, use `edit-config` from the Netdata [config directory](/docs/netdata-agent/configuration/README.md), which is typically at `/etc/netdata`, to edit the `python.d.conf` file.

95 -

96 -```bash

97 -cd /etc/netdata # Replace this path with your Netdata config directory, if different

98 -sudo ./edit-config python.d.conf

99 -```

100 -Change the value of the `samba` setting to `yes`. Save the file and restart the Netdata Agent with `sudo systemctl restart netdata`, or the [appropriate method](/packaging/installer/README.md#maintaining-a-netdata-agent-installation) for your system.

101 -

102 -

103 -#### Permissions and programs

104 -

105 -To run the collector you need:

106 -

107 -- `smbstatus` program

108 -- `sudo` program

109 -- `smbd` must be compiled with profiling enabled

110 -- `smbd` must be started either with the `-P 1` option or inside `smb.conf` using `smbd profiling level`

111 -

112 -The module uses `smbstatus`, which can only be executed by `root`. It uses `sudo` and assumes that it is configured such that the `netdata` user can execute `smbstatus` as root without a password.

113 -

114 -- add to your `/etc/sudoers` file:

115 -

116 - `which smbstatus` shows the full path to the binary.

117 -

118 - ```bash

119 - netdata ALL=(root) NOPASSWD: /path/to/smbstatus

120 - ```

121 -

122 -- Reset Netdata's systemd unit [CapabilityBoundingSet](https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Capabilities) (Linux distributions with systemd)

123 -

124 - The default CapabilityBoundingSet doesn't allow using `sudo`, and is quite strict in general. Resetting is not optimal, but a next-best solution given the inability to execute `smbstatus` using `sudo`.

125 -

126 -

127 - As the `root` user, do the following:

128 -

129 - ```cmd

130 - mkdir /etc/systemd/system/netdata.service.d

131 - echo -e '[Service]\nCapabilityBoundingSet=~' | tee /etc/systemd/system/netdata.service.d/unset-capability-bounding-set.conf

132 - systemctl daemon-reload

133 - systemctl restart netdata.service

134 - ```

135 -

136 -

137 -

138 -### Configuration

139 -

140 -#### File

141 -

142 -The configuration file name for this integration is `python.d/samba.conf`.

143 -

144 -

145 -You can edit the configuration file using the `edit-config` script from the

146 -Netdata [config directory](/docs/netdata-agent/configuration/README.md#the-netdata-config-directory).

147 -

148 -```bash

149 -cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata

150 -sudo ./edit-config python.d/samba.conf

151 -```

152 -#### Options

153 -

154 -There are 2 sections:

155 -

156 -* Global variables

157 -* One or more JOBS that can define multiple different instances to monitor.

158 -

159 -The following options can be defined globally: priority, penalty, autodetection_retry, update_every, but can also be defined per JOB to override the global values.

160 -

161 -Additionally, the following collapsed table contains all the options that can be configured inside a JOB definition.

162 -

163 -Every configuration JOB starts with a `job_name` value which will appear in the dashboard, unless a `name` parameter is specified.

164 -

165 -

166 -<details open><summary>Config options</summary>

167 -

169 -|:----|:-----------|:-------|:--------:|

170 -| update_every | Sets the default data collection frequency. | 5 | no |

171 -| priority | Controls the order of charts at the netdata dashboard. | 60000 | no |

172 -| autodetection_retry | Sets the job re-check interval in seconds. | 0 | no |

173 -| penalty | Indicates whether to apply penalty to update_every in case of failures. | yes | no |

174 -

175 -</details>

176 -

177 -#### Examples

178 -

179 -##### Basic

180 -

181 -A basic example configuration.

182 -

183 -<details open><summary>Config</summary>

184 -

185 -```yaml

186 -my_job_name:

187 - name: my_name

188 - update_every: 1

189 -

190 -```

191 -</details>

192 -

193 -

194 -

195 -## Troubleshooting

196 -

197 -### Debug Mode

198 -

199 -

200 -To troubleshoot issues with the `samba` collector, run the `python.d.plugin` with the debug option enabled. The output

201 -should give you clues as to why the collector isn't working.

202 -

203 -- Navigate to the `plugins.d` directory, usually at `/usr/libexec/netdata/plugins.d/`. If that's not the case on

204 - your system, open `netdata.conf` and look for the `plugins` setting under `[directories]`.

205 -

206 - ```bash

207 - cd /usr/libexec/netdata/plugins.d/

208 - ```

209 -

210 -- Switch to the `netdata` user.

211 -

212 - ```bash

213 - sudo -u netdata -s

214 - ```

215 -

216 -- Run the `python.d.plugin` to debug the collector:

217 -

218 - ```bash

219 - ./python.d.plugin samba debug trace

220 - ```

221 -

222 -### Getting Logs

223 -

224 -If you're encountering problems with the `samba` collector, follow these steps to retrieve logs and identify potential issues:

225 -

226 -- **Run the command** specific to your system (systemd, non-systemd, or Docker container).

227 -- **Examine the output** for any warnings or error messages that might indicate issues. These messages should provide clues about the root cause of the problem.

228 -

229 -#### System with systemd

230 -

231 -Use the following command to view logs generated since the last Netdata service restart:

232 -

233 -```bash

234 -journalctl _SYSTEMD_INVOCATION_ID="$(systemctl show --value --property=InvocationID netdata)" --namespace=netdata --grep samba

235 -```

236 -

237 -#### System without systemd

238 -

239 -Locate the collector log file, typically at `/var/log/netdata/collector.log`, and use `grep` to filter for collector's name:

240 -

241 -```bash

242 -grep samba /var/log/netdata/collector.log

243 -```

244 -

245 -**Note**: This method shows logs from all restarts. Focus on the **latest entries** for troubleshooting current issues.

246 -

247 -#### Docker Container

248 -

249 -If your Netdata runs in a Docker container named "netdata" (replace if different), use this command:

250 -

251 -```bash

252 -docker logs netdata 2>&1 | grep samba

253 -```

254 -

255 -

src/collectors/python.d.plugin/samba/metadata.yaml deleted

-205

@@ -1,205 +0,0 @@

1 -plugin_name: python.d.plugin

2 -modules:

3 - - meta:

4 - plugin_name: python.d.plugin

5 - module_name: samba

6 - monitored_instance:

7 - name: Samba

8 - link: https://www.samba.org/samba/

9 - categories:

10 - - data-collection.storage-mount-points-and-filesystems

11 - icon_filename: "samba.svg"

12 - related_resources:

13 - integrations:

14 - list: []

15 - info_provided_to_referring_integrations:

16 - description: ""

17 - keywords:

18 - - samba

19 - - file sharing

20 - most_popular: false

21 - overview:

22 - data_collection:

23 - metrics_description: "This collector monitors the performance metrics of Samba file sharing."

24 - method_description: |

25 - It is using the `smbstatus` command-line tool.

26 -

27 - Executed commands:

28 -

29 - - `sudo -n smbstatus -P`

30 - supported_platforms:

31 - include: []

32 - exclude: []

33 - multi_instance: false

34 - additional_permissions:

35 - description: |

36 - `smbstatus` is used, which can only be executed by `root`. It uses `sudo` and assumes that it is configured such that the `netdata` user can execute `smbstatus` as root without a password.

37 - default_behavior:

38 - auto_detection:

39 - description: "After all the permissions are satisfied, the `smbstatus -P` binary is executed."

40 - limits:

41 - description: ""

42 - performance_impact:

43 - description: ""

44 - setup:

45 - prerequisites:

46 - list:

47 - - title: Enable the samba collector

48 - description: |

49 - The `samba` collector is disabled by default. To enable it, use `edit-config` from the Netdata [config directory](/docs/netdata-agent/configuration/README.md), which is typically at `/etc/netdata`, to edit the `python.d.conf` file.

50 -

51 - ```bash

52 - cd /etc/netdata # Replace this path with your Netdata config directory, if different

53 - sudo ./edit-config python.d.conf

54 - ```

55 - Change the value of the `samba` setting to `yes`. Save the file and restart the Netdata Agent with `sudo systemctl restart netdata`, or the [appropriate method](/packaging/installer/README.md#maintaining-a-netdata-agent-installation) for your system.

56 - - title: Permissions and programs

57 - description: |

58 - To run the collector you need:

59 -

60 - - `smbstatus` program

61 - - `sudo` program

62 - - `smbd` must be compiled with profiling enabled

63 - - `smbd` must be started either with the `-P 1` option or inside `smb.conf` using `smbd profiling level`

64 -

65 - The module uses `smbstatus`, which can only be executed by `root`. It uses `sudo` and assumes that it is configured such that the `netdata` user can execute `smbstatus` as root without a password.

66 -

67 - - add to your `/etc/sudoers` file:

68 -

69 - `which smbstatus` shows the full path to the binary.

70 -

71 - ```bash

72 - netdata ALL=(root) NOPASSWD: /path/to/smbstatus

73 - ```

74 -

75 - - Reset Netdata's systemd unit [CapabilityBoundingSet](https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Capabilities) (Linux distributions with systemd)

76 -

77 - The default CapabilityBoundingSet doesn't allow using `sudo`, and is quite strict in general. Resetting is not optimal, but a next-best solution given the inability to execute `smbstatus` using `sudo`.

78 -

79 -

80 - As the `root` user, do the following:

81 -

82 - ```cmd

83 - mkdir /etc/systemd/system/netdata.service.d

84 - echo -e '[Service]\nCapabilityBoundingSet=~' | tee /etc/systemd/system/netdata.service.d/unset-capability-bounding-set.conf

85 - systemctl daemon-reload

86 - systemctl restart netdata.service

87 - ```

88 - configuration:

89 - file:

90 - name: python.d/samba.conf

91 - options:

92 - description: |

93 - There are 2 sections:

94 -

95 - * Global variables

96 - * One or more JOBS that can define multiple different instances to monitor.

97 -

98 - The following options can be defined globally: priority, penalty, autodetection_retry, update_every, but can also be defined per JOB to override the global values.

99 -

100 - Additionally, the following collapsed table contains all the options that can be configured inside a JOB definition.

101 -

102 - Every configuration JOB starts with a `job_name` value which will appear in the dashboard, unless a `name` parameter is specified.

103 - folding:

104 - title: "Config options"

105 - enabled: true

106 - list:

107 - - name: update_every

108 - description: Sets the default data collection frequency.

109 - default_value: 5

110 - required: false

111 - - name: priority

112 - description: Controls the order of charts at the netdata dashboard.

113 - default_value: 60000

114 - required: false

115 - - name: autodetection_retry

116 - description: Sets the job re-check interval in seconds.

117 - default_value: 0

118 - required: false

119 - - name: penalty

120 - description: Indicates whether to apply penalty to update_every in case of failures.

121 - default_value: yes

122 - required: false

123 - examples:

124 - folding:

125 - enabled: true

126 - title: "Config"

127 - list:

128 - - name: Basic

129 - description: A basic example configuration.

130 - config: |

131 - my_job_name:

132 - name: my_name

133 - update_every: 1

134 - troubleshooting:

135 - problems:

136 - list: []

137 - alerts: []

138 - metrics:

139 - folding:

140 - title: Metrics

141 - enabled: false

142 - description: ""

143 - availability: []

144 - scopes:

145 - - name: global

146 - description: "These metrics refer to the entire monitored application."

147 - labels: []

148 - metrics:

149 - - name: syscall.rw

150 - description: R/Ws

151 - unit: "KiB/s"

152 - chart_type: area

153 - dimensions:

154 - - name: sendfile

155 - - name: recvfile

156 - - name: smb2.rw

157 - description: R/Ws

158 - unit: "KiB/s"

159 - chart_type: area

160 - dimensions:

161 - - name: readout

162 - - name: writein

163 - - name: readin

164 - - name: writeout

165 - - name: smb2.create_close

166 - description: Create/Close

167 - unit: "operations/s"

168 - chart_type: line

169 - dimensions:

170 - - name: create

171 - - name: close

172 - - name: smb2.get_set_info

173 - description: Info

174 - unit: "operations/s"

175 - chart_type: line

176 - dimensions:

177 - - name: getinfo

178 - - name: setinfo

179 - - name: smb2.find

180 - description: Find

181 - unit: "operations/s"

182 - chart_type: line

183 - dimensions:

184 - - name: find

185 - - name: smb2.notify

186 - description: Notify

187 - unit: "operations/s"

188 - chart_type: line

189 - dimensions:

190 - - name: notify

191 - - name: smb2.sm_counters

192 - description: Lesser Ops

193 - unit: "count"

194 - chart_type: stacked

195 - dimensions:

196 - - name: tcon

197 - - name: negprot

198 - - name: tdis

199 - - name: cancel

200 - - name: logoff

201 - - name: flush

202 - - name: lock

203 - - name: keepalive

204 - - name: break

205 - - name: sessetup

src/collectors/python.d.plugin/samba/samba.chart.py deleted

-144

@@ -1,144 +0,0 @@

1 -# -*- coding: utf-8 -*-

2 -# Description: samba netdata python.d module

3 -# Author: Christopher Cox <chris_cox@endlessnow.com>

4 -# SPDX-License-Identifier: GPL-3.0-or-later

5 -#

6 -# The netdata user needs to be able to be able to sudo the smbstatus program

7 -# without password:

8 -# netdata ALL=(ALL) NOPASSWD: /usr/bin/smbstatus -P

9 -#

10 -# This makes calls to smbstatus -P

11 -#

12 -# This just looks at a couple of values out of syscall, and some from smb2.

13 -#

14 -# The Lesser Ops chart is merely a display of current counter values. They

15 -# didn't seem to change much to me. However, if you notice something changing

16 -# a lot there, bring one or more out into its own chart and make it incremental

17 -# (like find and notify... good examples).

18 -

19 -import re

20 -import os

21 -

22 -from bases.FrameworkServices.ExecutableService import ExecutableService

23 -from bases.collection import find_binary

24 -

25 -disabled_by_default = True

26 -

27 -update_every = 5

28 -

29 -ORDER = [

30 - 'syscall_rw',

31 - 'smb2_rw',

32 - 'smb2_create_close',

33 - 'smb2_info',

34 - 'smb2_find',

35 - 'smb2_notify',

36 - 'smb2_sm_count'

37 -]

38 -

39 -CHARTS = {

40 - 'syscall_rw': {

41 - 'options': [None, 'R/Ws', 'KiB/s', 'syscall', 'syscall.rw', 'area'],

42 - 'lines': [

43 - ['syscall_sendfile_bytes', 'sendfile', 'incremental', 1, 1024],

44 - ['syscall_recvfile_bytes', 'recvfile', 'incremental', -1, 1024]

45 - ]

46 - },

47 - 'smb2_rw': {

48 - 'options': [None, 'R/Ws', 'KiB/s', 'smb2', 'smb2.rw', 'area'],

49 - 'lines': [

50 - ['smb2_read_outbytes', 'readout', 'incremental', 1, 1024],

51 - ['smb2_write_inbytes', 'writein', 'incremental', -1, 1024],

52 - ['smb2_read_inbytes', 'readin', 'incremental', 1, 1024],

53 - ['smb2_write_outbytes', 'writeout', 'incremental', -1, 1024]

54 - ]

55 - },

56 - 'smb2_create_close': {

57 - 'options': [None, 'Create/Close', 'operations/s', 'smb2', 'smb2.create_close', 'line'],

58 - 'lines': [

59 - ['smb2_create_count', 'create', 'incremental', 1, 1],

60 - ['smb2_close_count', 'close', 'incremental', -1, 1]

61 - ]

62 - },

63 - 'smb2_info': {

64 - 'options': [None, 'Info', 'operations/s', 'smb2', 'smb2.get_set_info', 'line'],

65 - 'lines': [

66 - ['smb2_getinfo_count', 'getinfo', 'incremental', 1, 1],

67 - ['smb2_setinfo_count', 'setinfo', 'incremental', -1, 1]

68 - ]

69 - },

70 - 'smb2_find': {

71 - 'options': [None, 'Find', 'operations/s', 'smb2', 'smb2.find', 'line'],

72 - 'lines': [

73 - ['smb2_find_count', 'find', 'incremental', 1, 1]

74 - ]

75 - },

76 - 'smb2_notify': {

77 - 'options': [None, 'Notify', 'operations/s', 'smb2', 'smb2.notify', 'line'],

78 - 'lines': [

79 - ['smb2_notify_count', 'notify', 'incremental', 1, 1]

80 - ]

81 - },

82 - 'smb2_sm_count': {

83 - 'options': [None, 'Lesser Ops', 'count', 'smb2', 'smb2.sm_counters', 'stacked'],

84 - 'lines': [

85 - ['smb2_tcon_count', 'tcon', 'absolute', 1, 1],

86 - ['smb2_negprot_count', 'negprot', 'absolute', 1, 1],

87 - ['smb2_tdis_count', 'tdis', 'absolute', 1, 1],

88 - ['smb2_cancel_count', 'cancel', 'absolute', 1, 1],

89 - ['smb2_logoff_count', 'logoff', 'absolute', 1, 1],

90 - ['smb2_flush_count', 'flush', 'absolute', 1, 1],

91 - ['smb2_lock_count', 'lock', 'absolute', 1, 1],

92 - ['smb2_keepalive_count', 'keepalive', 'absolute', 1, 1],

93 - ['smb2_break_count', 'break', 'absolute', 1, 1],

94 - ['smb2_sessetup_count', 'sessetup', 'absolute', 1, 1]

95 - ]

96 - }

97 -}

98 -

99 -SUDO = 'sudo'

100 -SMBSTATUS = 'smbstatus'

101 -

102 -

103 -class Service(ExecutableService):

104 - def __init__(self, configuration=None, name=None):

105 - ExecutableService.__init__(self, configuration=configuration, name=name)

106 - self.order = ORDER

107 - self.definitions = CHARTS

108 - self.rgx_smb2 = re.compile(r'(smb2_[^:]+|syscall_.*file_bytes):\s+(\d+)')

109 -

110 - def check(self):

111 - smbstatus_binary = find_binary(SMBSTATUS)

112 - if not smbstatus_binary:

113 - self.error("can't locate '{0}' binary".format(SMBSTATUS))

114 - return False

115 -

116 - if os.getuid() == 0:

117 - self.command = ' '.join([smbstatus_binary, '-P'])

118 - return ExecutableService.check(self)

119 -

120 - sudo_binary = find_binary(SUDO)

121 - if not sudo_binary:

122 - self.error("can't locate '{0}' binary".format(SUDO))

123 - return False

124 - command = [sudo_binary, '-n', '-l', smbstatus_binary, '-P']

125 - smbstatus = '{0} -P'.format(smbstatus_binary)

126 - allowed = self._get_raw_data(command=command)

127 - if not (allowed and allowed[0].strip() == smbstatus):

128 - self.error("not allowed to run sudo for command '{0}'".format(smbstatus))

129 - return False

130 - self.command = ' '.join([sudo_binary, '-n', smbstatus_binary, '-P'])

131 - return ExecutableService.check(self)

132 -

133 - def _get_data(self):

134 - """

135 - Format data received from shell command

136 - :return: dict

137 - """

138 - raw_data = self._get_raw_data()

139 - if not raw_data:

140 - return None

141 -

142 - parsed = self.rgx_smb2.findall(' '.join(raw_data))

143 -

144 - return dict(parsed) or None

src/collectors/python.d.plugin/samba/samba.conf deleted

-60

@@ -1,60 +0,0 @@

1 -# netdata python.d.plugin configuration for samba

2 -#

3 -# This file is in YaML format. Generally the format is:

4 -#

5 -# name: value

6 -#

7 -# There are 2 sections:

8 -# - global variables

9 -# - one or more JOBS

10 -#

11 -# JOBS allow you to collect values from multiple sources.

12 -# Each source will have its own set of charts.

13 -#

14 -# JOB parameters have to be indented (using spaces only, example below).

15 -

16 -# ----------------------------------------------------------------------

17 -# Global Variables

18 -# These variables set the defaults for all JOBs, however each JOB

19 -# may define its own, overriding the defaults.

20 -

21 -# update_every sets the default data collection frequency.

22 -# If unset, the python.d.plugin default is used.

23 -update_every: 5

24 -

25 -# priority controls the order of charts at the netdata dashboard.

26 -# Lower numbers move the charts towards the top of the page.

27 -# If unset, the default for python.d.plugin is used.

28 -# priority: 60000

29 -

30 -# penalty indicates whether to apply penalty to update_every in case of failures.

31 -# Penalty will increase every 5 failed updates in a row. Maximum penalty is 10 minutes.

32 -# penalty: yes

33 -

34 -# autodetection_retry sets the job re-check interval in seconds.

35 -# The job is not deleted if check fails.

36 -# Attempts to start the job are made once every autodetection_retry.

37 -# This feature is disabled by default.

38 -# autodetection_retry: 0

39 -

40 -# ----------------------------------------------------------------------

41 -# JOBS (data collection sources)

42 -#

43 -# The default JOBS share the same *name*. JOBS with the same name

44 -# are mutually exclusive. Only one of them will be allowed running at

45 -# any time. This allows autodetection to try several alternatives and

46 -# pick the one that works.

47 -#

48 -# Any number of jobs is supported.

49 -#

50 -# All python.d.plugin JOBS (for all its modules) support a set of

51 -# predefined parameters. These are:

52 -#

53 -# job_name:

54 -# name: myname # the JOB's name as it will appear at the

55 -# # dashboard (by default is the job_name)

56 -# # JOBs sharing a name are mutually exclusive

57 -# update_every: 1 # the JOB's data collection frequency

58 -# priority: 60000 # the JOB's order on the dashboard

59 -# penalty: yes # the JOB's penalty

60 -# autodetection_retry: 0 # the JOB's re-check interval in seconds

\ No newline at end of file