You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Ilya Mashchenko d3ece5befb
elasticsearch and couchdb: move testdata to version dir (#516)
11 months ago
.circleci bump go v1.15 (#425) 1 year ago
.github Update labeler.yml 11 months ago
.travis netdata/packaging: Adjust go.d version update process (#246) 2 years ago
agent Update watch_test.go 12 months ago
cli Merge go orchestrator (#447) 1 year ago
cmd/godplugin log plugin version and current user name/uid on start (#505) 11 months ago
config Update go.d.conf 11 months ago
examples/simple move netdataapi,ticker,logger packages (#449) 1 year ago
hack build: remove darwin/386 (#429) 1 year ago
logger move netdataapi,ticker,logger packages (#449) 1 year ago
mocks reafctor web_log (#141) 2 years ago
modules elasticsearch and couchdb: move testdata to version dir (#516) 11 months ago
pkg add helper functions readme (#491) 12 months ago
.codecov.yml freeradius: move fetching status server data to api pkg (#341) 2 years ago
.dockerignore reafctor web_log (#141) 2 years ago
.gitignore reafctor web_log (#141) 2 years ago
.travis.yml bump go v1.15 (#425) 1 year ago
.yamllint.yml Update .yamllint.yml 2 years ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#471) 12 months ago
Dockerfile.dev bump go v1.15 (#425) 1 year ago
LICENSE Initial commit 4 years ago
Makefile Merge go orchestrator (#447) 1 year ago
README.md Update README.md 11 months ago
docker-compose.yml reafctor web_log (#141) 2 years ago
go.mod modules/mysql: fix collect slave status for MariaDB v10.2.0- (#465) 1 year ago
go.sum modules/mysql: fix collect slave status for MariaDB v10.2.0- (#465) 1 year ago

README.md

go.d.plugin

CircleCI

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:

Available modules

Name Monitors
activemq ActiveMQ
apache Apache
bind ISC Bind
cockroachdb CockroachDB
consul Consul
coredns CoreDNS
couchdb CouchDB
dnsdist Dnsdist
dnsmasq Dnsmasq DNS Forwarder
dnsmasq_dhcp Dnsmasq DHCP
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
powerdns PowerDNS Authoritative Server
powerdns_recursor PowerDNS Recursor
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

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.

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.