go.d.plugin

go.d.plugin is a Netdata external plugin:

• What it does: collects metrics from databases, middleware, services, APIs, and infrastructure components using built-in collectors.
• How you use it:
  • set collector-specific jobs in config/go.d/*.conf,
  • restart Netdata and the collector jobs start automatically.
• Operational behavior:
  • runs as a separate process from Netdata core (visible in ps fax),
  • lifecycle is managed by Netdata (start/stop/restart),
  • communicates through the external plugin pipe.
• Scale model:
  • supports many collectors,
  • each collector can run multiple jobs,
  • collectors can be added/extended independently.

Required Linux capabilities

All capabilities are set automatically during Netdata installation using the official installation method.

Available collectors

Configuration

Edit the go.d.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d.conf

Configurations are written in YAML.

• plugin configuration
• specific collector configuration

Enable a collector

To enable a collector you should edit go.d.conf to uncomment the collector in question and change it from no to yes.

For example, to enable the example plugin you would need to update go.d.conf from something like:

modules:
#  example: no 

to

modules:
  example: yes

Then restart netdata for the change to take effect.

Troubleshooting

Plugin CLI

Usage:
  orchestrator [OPTIONS] [update every]

Application Options:
  -m, --modules=    module name to run (default: all)
  -c, --config-dir= config dir to read
  -w, --watch-path= config path to watch
  -d, --debug       debug mode
  -v, --version     display the version and exit

Help Options:
  -h, --help        Show this help message

Debugging a Specific Collector

To debug a particular collector, first switch to the Netdata user:

sudo su -s /bin/bash netdata

Then run the plugin in debug mode, specifying your target collector:

# For standard installations
/usr/libexec/netdata/plugins.d/go.d.plugin -d -m <collector_name>

# For static installations (e.g., in /opt)
/opt/netdata/usr/libexec/netdata/plugins.d/go.d.plugin -d -m <collector_name>

Replace <collector_name> with the specific collector you wish to debug.