#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) ~ " 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) ~ " 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 %]

#[[ 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:

1. Go to Nodes.
2. 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.
3. The Collectors → Jobs view opens by default.
4. In the Search box, type [[ entry.meta.module_name ]] (or scroll the list) to locate the [[ entry.meta.module_name ]] collector.
5. Click the + next to the [[ entry.meta.module_name ]] collector to add a new job.
6. 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.

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 %]