Table of Contents

Introduction

Grafana allows you to query, visualize, alert on and understand your metrics no matter where they are stored. Grafana has pluggable data source model and comes bundled with rich support for many of the most popular time series databases like Graphite, Prometheus, Elasticsearch, OpenTSDB and InfluxDB. It also has built-in support for cloud monitoring vendors like Google Stackdriver, Amazon Cloudwatch, Microsoft Azure and SQL databases like MySQL and Postgres. Grafana is the only tool that can combine data from so many places into a single dashboard.

Create, explore, and share dashboards with your team and foster a data driven culture:

Links

General

https://grafana.com/
Grafana GiHub repository

Dashboards

A Grafana metrics dashboard for the metrics provided by Grafana Loki. See also This Grafana dashboard in the Github Repository.

Docs

Grafana documentation
Install on Debian or Ubuntu

Files and Directories

General Files and Directories

File or Directory Description
/etc/grafana/ The Grafana configuration directory.
/usr/sbin/grafana-cli The Grafana CLI binary.
/usr/sbin/grafana-server The Grafana server binary.
/usr/lib/systemd/system/grafana-server.service The Grafana systemd unit file.
/usr/share/grafana/ The Grafana HTML, JS, CSS, font and other files.
/var/lib/grafana/grafana.db The Grafana SQLite3 database.
/var/log/grafana/grafana.log The Grafana log file.

Configuration Files

File or Directory Description
/etc/default/grafana-server The configuration file with environment files for the Grafana server.
/etc/grafana/grafana.ini The Grafana server configuration file.

Getting Help

FIXME

Manual pages:

user@host:~$ 

Install

To install Grafana on Debian:

If installing Grafana on a Raspberry consider this: The grafana-rpi packages in the Grafana Debian repository are intended for the Raspberry Pi 1 and the Raspberry Pi Zero.
root@host:~$ apt-get install -y apt-transport-https wget
root@host:~$ wget -q -O - https://packages.grafana.com/gpg.key | apt-key add -
root@host:~$ echo "deb https://packages.grafana.com/oss/deb stable main" > /etc/apt/sources.list.d/grafana.list
root@host:~$ apt-get update
root@host:~$ apt-get install grafana

If a local IPTables firewall is active on the system running Grafana open the TCP port 3000 for access to the Grafana WebUI:

iptables.conf
# Allow access to Grafana from local networks
-A INPUT -p tcp -s <YOUR-NETWORK> --dport 3000 -j ACCEPT

and reload the IPTables rules:

root@host:~$ iptables-restore < iptables.conf

Configuration

Initial

  1. Navigate to http://your-grafana-host:3000/ in a Web browser.

  2. Log into Grafana with the default credentials. User admin and password admin.

  3. You will be prompted to change the password for the admin user. Choose a reasonable strong password.

Adding Prometheus to Grafana

  1. Navigate to http://your-grafana-host:3000/ in a Web browser.

  2. Log into Grafana with the default credentials. User admin and password admin.

  3. Click on the “cogwheel” icon in the sidebar to open the Configuration menu.

  4. Click on “Data Sources”.

  5. Click on “Add data source”.

  6. Select “Prometheus” as the type.

  7. Set the appropriate Prometheus server URL (for example, http://localhost:9090/)

  8. Adjust other data source settings as desired (for example, choosing the right Access method).

  9. Click “Save & Test” to save the new data source.

Usage

FIXME

Start

To start Grafana:

root@host:~$ systemctl enable grafana-server.service
root@host:~$ systemctl start grafana-server.service

Stop

To stop Grafana:

root@host:~$ systemctl stop grafana-server.service

Status Check

To check the status of Grafana:

root@host:~$ systemctl status grafana-server.service

Recipies

FIXME

this namespace doesn't exist: sw:grafana:recipies

Known Issues

FIXME