go.d.plugin

README

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.

Install

Shipped with Netdata.

Contributing

If you have time and willing to help, there are a lof of ways to contribute:

• Fix and report bugs
• Review code and feature proposals
• Contribute modules (wip, module interface may be changed soon)

Available modules

Name	Monitors
activemq	ActiveMQ
apache	Apache
bind	ISC Bind
cockroachdb	CockroachDB
consul	Consul
coredns	CoreDNS
couchdb	CouchDB
dnsmasq_dhcp	Dnsmasq
dns_query	DNS Query RTT
docker_engine	Docker Engine
dockerhub	Docker Hub
elasticsearch	Elasticsearch
example	-
filecheck	Files and Directories
fluentd	Fluentd
freeradius	FreeRADIUS
hdfs	HDFS
httpcheck	Any HTTP Endpoint
isc_dhcpd	ISC dhcpd
k8s_kubelet	Kubelet
k8s_kubeproxy	Kube-proxy
lighttpd	Lighttpd
lighttpd2	Lighttpd2
logstash	Logstash
mysql	MySQL
nginx	NGINX
openvpn	OpenVPN
phpdaemon	phpDaemon
phpfpm	PHP-FPM
pihole	Pi-hole
prometheus	Any Prometheus Endpoint
portcheck	Any TCP Endpoint
pulsar	Apache Pulsar
rabbitmq	RabbitMQ
scaleio	Dell EMC ScaleIO
solr	Solr
squidlog	Squid
springboot2	Spring Boot2
systemdunits	Systemd unit state
tengine	Tengine
unbound	Unbound
vcsa	vCenter Server Appliance
vernemq	VerneMQ
vsphere	VMware vCenter Server
web_log	Apache/NGINX
whoisquery	Domain Expiry
wmi	Windows Machines
x509check	Digital Certificates
zookeeper	ZooKeeper

Configuration

go.d.plugin itself can be configured using the configuration file /etc/netdata/go.d.conf (to edit it on your system run /etc/netdata/edit-config go.d.conf). This file is a BASH script.

Configurations are written in YAML.

• plugin configuration
• specific module configuration

Developing

• Add your module to the modules dir.
• Import the module in the main.go.
• To build it execute make from the plugin root dir or hack/go-build.sh.
• Run it in the debug mode bin/godplugin -d -m <MODULE_NAME>.
• Use make clean when you are done with testing.

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. See the whole list of available modules.