netdata #5

Supports: bionic
Add to new model

Description

This is a charm for netdata installation, providing support
for integration with Prometheus.


Overview

A subordinate charm to deploy Netdata and provide Netdata metrics
to an existing Prometheus deployment using promreg.

Usage

Use this charm with any other charm:

juju deploy netadata --config ~/netdata.yaml
juju add-relation netdata:netdata-host other-charm:juju-info

netdata.yaml:

netdata:
  netdata_nginx_port: 19998
  netdata_nginx_listen_subnet: "10.0.0.0/24"
  netdata_nginx_allowed_subnet: "10.0.0.0/24"   
  promreg_authtoken: ****
  promreg_url: https://promreg_url:12321      
  prometheus_main_label: "pref_label_n1,pref_label_n2,pref_label_n3"

Configuration

extra_packages
(string) Space separated list of extra deb packages to install.
install_keys
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
install_sources
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
netdata_nginx_allowed_subnet
(string) Subnet from which Netdata will be available. Default value is "all". Specify subnet in "10.0.0.0/24" form.
all
netdata_nginx_listen_subnet
(string) Subnet on which Netdata host has an IP, this IP will be the only one configured in Nginx to listen at. Default value is "". Specify subnet in "10.0.0.0/24" form.
netdata_nginx_port
(int) The port where Nginx will serve Netdata at.
19998
package_status
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
install
prometheus_main_label
(string) During registration to Prometheus, the charm will assign a main label to each target from one of the Juju units on the node. If this field is left empty, one random unit name will be assigned. The expected format is 'application_name01,application_name02'. Any number of application names can be entered. The charm will assign as the main label the unit matching the first available application name.
promreg_authtoken
(string) The Prometheus Registration authtoken.
authtoken
promreg_url
(string) The http(s) url and port (usually 12321) where the Prometheus Registration service is listening. If left an empty string, promreg will not be used.