Setup Generic - Netdata

Setup

[% if entry.meta.plugin_name == 'go.d.plugin' %]

You can configure the [[ entry.meta.module_name ]] collector in two ways:

Method	Best for	How to
UI	Fast setup without editing files	Go to Nodes → Configure this node → Collectors → Jobs, search for [[ entry.meta.module_name ]], then click + to add a job.
File	If you prefer configuring via file, or need to automate deployments (e.g., with Ansible)	Edit `[[ entry.setup.configuration.file.name ]]` and add a job.

:::important

UI configuration requires paid Netdata Cloud plan.

:::

[% endif %]

[% if entry.setup.description %] [[ entry.setup.description ]] [% else %]

Prerequisites

[% if entry.setup.prerequisites.list %]

[% for prereq in entry.setup.prerequisites.list %]

[[ prereq.title ]]

[[ prereq.description ]]

[% endfor %]

[% else %]

No action required.

[% endif %]

Configuration

Options

[[ entry.setup.configuration.options.description ]]

[% if entry.setup.configuration.options.list %] [% if entry.setup.configuration.options.folding.enabled and not clean %] {% details open=true summary="[[ entry.setup.configuration.options.folding.title or 'Config options' ]]" %} [% endif %]

[% set has_groups = entry.setup.configuration.options.list | selectattr("group","defined") | list | length > 0 %]

[% if has_groups %]

Group	Option	Description	Default	Required
[% set ns = namespace(last_group=None) %]
[% for item in entry.setup.configuration.options.list %]
[% set anchor_source = (item.group ~ "-" ~ item.name) if (item.group is defined and item.group) else item.name %]
[% set item_anchor = "option-" ~ anchorfy(anchor_source) %]
[[ ("" ~ item.group ~ "") if (item.group is defined and item.group != ns.last_group) else "" ]]	[[ ("[" ~ strfy(item.name) ~ "](#" ~ item_anchor ~ ")") if ('detailed_description' in item) else strfy(item.name) ]]	[[ strfy(item.description) ]]	[[ strfy(item.default_value) ]]	[[ strfy(item.required) ]]
[% set ns.last_group = item.group if item.group is defined else ns.last_group %]
[% endfor %]
[% else %]
Option	Description	Default	Required
:-----	:------------	:--------	:---------:
[% for item in entry.setup.configuration.options.list %]
[% set anchor_source = (item.group ~ "-" ~ item.name) if (item.group is defined and item.group) else item.name %]
[% set item_anchor = "option-" ~ anchorfy(anchor_source) %]
[[ ("[" ~ strfy(item.name) ~ "](#" ~ item_anchor ~ ")") if ('detailed_description' in item) else strfy(item.name) ]]	[[ strfy(item.description) ]]	[[ strfy(item.default_value) ]]	[[ strfy(item.required) ]]
[% endfor %]
[% endif %]

[% for item in entry.setup.configuration.options.list %] [% if 'detailed_description' in item %] [% set anchor_source = (item.group ~ "-" ~ item.name) if (item.group is defined and item.group) else item.name %] <a id="[[ "option-" ~ anchorfy(anchor_source) ]]"></a>

[[ item.name ]]

[[ item.detailed_description ]]

[% endif %] [% endfor %]

[% if entry.setup.configuration.options.folding.enabled and not clean %] {% /details %} [% endif %] [% elif not entry.setup.configuration.options.description %] There are no configuration options.

[% endif %]

[% if entry.meta.plugin_name == 'go.d.plugin' %]

via UI

Configure the [[ entry.meta.module_name ]] collector from the Netdata web interface:

Go to Nodes.
Select the node where you want the [[ entry.meta.module_name ]] data-collection job to run and click the :gear: (Configure this node). That node will run the data collection.
The Collectors → Jobs view opens by default.
In the Search box, type [[ entry.meta.module_name ]] (or scroll the list) to locate the [[ entry.meta.module_name ]] collector.
Click the + next to the [[ entry.meta.module_name ]] collector to add a new job.
Fill in the job fields, then click Test to verify the configuration and Submit to save.
- Test runs the job with the provided settings and shows whether data can be collected.
- If it fails, an error message appears with details (for example, connection refused, timeout, or command execution errors), so you can adjust and retest.

[% endif %]

via File

[% if entry.setup.configuration.file.name %] The configuration file name for this integration is [[ entry.setup.configuration.file.name ]]. [% if 'section_name' in entry.setup.configuration.file %] Configuration for this specific integration is located in the [[ entry.setup.configuration.file.section_name ]] section within that file. [% endif %]

[% if entry.meta.plugin_name == 'go.d.plugin' %] [% include 'setup/sample-go-config.md' %] [% elif entry.meta.plugin_name == 'python.d.plugin' %] [% include 'setup/sample-python-config.md' %] [% elif entry.meta.plugin_name == 'charts.d.plugin' %] [% include 'setup/sample-charts-config.md' %] [% elif entry.meta.plugin_name == 'ioping.plugin' %] [% include 'setup/sample-charts-config.md' %] [% elif entry.meta.plugin_name == 'apps.plugin' %] [% include 'setup/sample-apps-config.md' %] [% elif entry.meta.plugin_name == 'ebpf.plugin' %] [% include 'setup/sample-netdata-config.md' %] [% elif entry.setup.configuration.file.name == 'netdata.conf' %] [% include 'setup/sample-netdata-config.md' %] [% endif %]

You can edit the configuration file using the edit-config script from the Netdata config directory.

bash

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config [[ entry.setup.configuration.file.name ]]

[% else %] There is no configuration file. [% endif %]

Examples

[% if entry.setup.configuration.examples.list %]

[% for example in entry.setup.configuration.examples.list %]

[[ example.name ]]

[[ example.description ]]

[% if example.folding.enabled and not clean %] {% details open=true summary="[[ entry.setup.configuration.examples.folding.title ]]" %} [% endif %]

yaml

[[ example.config ]]

[% if example.folding.enabled and not clean %] {% /details %} [% endif %] [% endfor %] [% else%] There are no configuration examples.

[% endif %] [% endif %]