Skip to main content

go.d.plugin

go.d.plugin is a Netdata external plugin. It is an orchestrator for data collection modules written in go.

  1. It runs as an independent process (ps fax shows it).
  2. It is started and stopped automatically by Netdata.
  3. It communicates with Netdata via a unidirectional pipe (sending data to the Netdata daemon).
  4. Supports any number of data collection modules.
  5. Allows each module to have any number of data collection jobs.

Bug reports, feature requests, and questions

Are welcome! We are using netdata/netdata repository for bugs, feature requests, and questions.

Install

Go.d.plugin is shipped with Netdata.

Required Linux capabilities

All capabilities are set automatically during Netdata installation using the official installation method. No further action required. If you have used a different installation method and need to set the capabilities manually, see the appropriate collector readme.

CapabilityRequired by
CAP_NET_RAWPing
CAP_NET_ADMINWireguard
CAP_DAC_READ_SEARCHFilecheck

Available modules

NameMonitors
adaptec_raidAdaptec Hardware RAID
activemqActiveMQ
apacheApache
bindISC Bind
cassandraCassandra
chronyChrony
clickhouseClickHouse
cockroachdbCockroachDB
consulConsul
corednsCoreDNS
couchbaseCouchbase
couchdbCouchDB
dnsdistDnsdist
dnsmasqDnsmasq DNS Forwarder
dnsmasq_dhcpDnsmasq DHCP
dns_queryDNS Query RTT
dockerDocker Engine
docker_engineDocker Engine
dockerhubDocker Hub
elasticsearchElasticsearch/OpenSearch
envoyEnvoy
example-
fail2banFail2Ban Jails
filecheckFiles and Directories
fluentdFluentd
freeradiusFreeRADIUS
haproxyHAProxy
hddtempDisks temperature
hdfsHDFS
hpssaHPE Smart Array
httpcheckAny HTTP Endpoint
intelgpuIntel integrated GPU
isc_dhcpdISC DHCP
k8s_kubeletKubelet
k8s_kubeproxyKube-proxy
k8s_stateKubernetes cluster state
lighttpdLighttpd
litespeedLitespeed
logindsystemd-logind
logstashLogstash
lvmLVM logical volumes
megacliMegaCli Hardware Raid
mongoDBMongoDB
mysqlMySQL
nginxNGINX
nginxplusNGINX Plus
nginxvtsNGINX VTS
ntpdNTP daemon
nvmeNVMe devices
openvpnOpenVPN
openvpn_status_logOpenVPN
pgbouncerPgBouncer
phpdaemonphpDaemon
phpfpmPHP-FPM
piholePi-hole
pikaPika
pingAny network host
prometheusAny Prometheus Endpoint
portcheckAny TCP Endpoint
postgresPostgreSQL
powerdnsPowerDNS Authoritative Server
powerdns_recursorPowerDNS Recursor
proxysqlProxySQL
pulsarApache Pulsar
rabbitmqRabbitMQ
redisRedis
rspamdRspamd
scaleioDell EMC ScaleIO
sensorsHardware Sensors
SNMPSNMP
squidlogSquid
smartctlS.M.A.R.T Storage Devices
storcliBroadcom Hardware RAID
supervisordSupervisor
systemdunitsSystemd unit state
tengineTengine
traefikTraefik
upsdUPSd (Nut)
unboundUnbound
vcsavCenter Server Appliance
vernemqVerneMQ
vsphereVMware vCenter Server
web_logApache/NGINX
wireguardWireGuard
whoisqueryDomain Expiry
windowsWindows
x509checkDigital Certificates
zfspoolZFS Pools
zookeeperZooKeeper

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.

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.

Contributing

If you want to contribute to this project, we are humbled. Please take a look at our contributing guidelines and don't hesitate to contact us in our forums.

How to develop a collector

Read how to write a Netdata collector in Go.

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

To debug specific module:

# become user netdata
sudo su -s /bin/bash netdata

# run plugin in debug mode
./go.d.plugin -d -m <module name>

Change <module name> to the module name you want to debug.

Netdata Community

This repository follows the Netdata Code of Conduct and is part of the Netdata Community.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.