NOTE: These installation instructions describe a very early experiment the Stork team did with Prometheus and Grafana. Integration with both is planned for Stork 0.8.
The following page describes how to install Prometheus with Grafana and its dependencies on Ubuntu 18.04. Since Stork is in very early stages, it currently supports Ubuntu 18.04 only. We do not want to get distracted with portability. The list will be expanded some time in the future once the project becomes a bit more mature.
The config file is located in: /etc/prometheus/prometheus.yml. When started, by default Prometheus listens on localhost:9090.
Connect Prometheus to exporters
Define connection to Prometheus by editing /etc/prometheus/prometheus.yml:
apiVersion:1datasources:# This reports statistics about Prometheus (how long it took to scape data etc.)# This is built into Prometheus itself.-name:Prometheustype:prometheusaccess:proxyurl:http://localhost:9090# Node exporter reports hardware/OS statistics for the node (the host bind & kea are run on)# Requires node-exporter to run-job_name:'node'static_configs:-targets:['localhost:9100']# Gathers statistics from Kea, requires kea-exporter-job_name:'kea'static_configs:-targets:['localhost:9547']# Gathers statistics from bind9, requires bind-exporter-job_name:'bind9'static_configs:-targets:['localhost:9119']
To install Node exporter you need a go compiler version >= 1.11. Get resources:
To start the server: systemctl start grafana-server. If you want grafana to start automatically after system restart, also do systemctl enable grafana-server. The config is in /etc/grafana/grafana.ini. By default, grafana listens on localhost:3000.
You should see some statistics. If Stork is monitoring your live network - great, you're all set. If this is a test environment, you should probably go ahead an generate some simulated traffic. Head to page about generating some data.