This repository covers my personal Grafana instance, which I use to visualize data in my Prometheus instances to observe my infrastructure and my PV system.
The following chapters cover setup, upgrade and backup. I publish it because it might help anybody to setup a similar solution.
There are some drawbacks in this scenario which I would like to point out:
- In this scenario, Grafana is running on HTTP without any transport layer encryption. Run this only in secure environments.
- docker-compose.yml is referencing to the latest images available in Docker Registry (of a specified version). In a enterprise environment, this is often seen as an anti pattern because it could lead to unintended updates and broken systems. However, in my specific scenario, I want to refer to the latest available image. If something fails unintended, I need to fix it.
- Ansible 2.7 or higher
- Docker runtime environment with docker compose
- A Linux user which is used by Docker to run the container
First of all, please instantiate Ansible var samples:
cd /YOUR/REPO/CHECKOUT/PATH/ansible
cp roles/install-grafana/vars/main-sample.yml roles/install-grafana/vars/main.yml
Open roles/install-grafana/vars/main.yml in your prefered editor and adapt settings.
To execute this Ansible playbook, you can use following command:
ansible-playbook -i /PATH/TO/INVENTORY /YOUR/REPO/CHECKOUT/PATH/ansible/ansible_playbook.yml
After running this playbook, create a .env file at grafana_path with following content:
GRAFANA_USER=admin
GRAFANA_PASSWORD=THISISYOURSUPERSECRETGRAFANAADMINPASSWORD
After setup, all containers needs to get started executing
docker compose up -d
in setup directory grafana_path.
Ansible role is creating a cronjob which updates base images every night.
The role creates a cron job which executes a backup script on a daily basis. To copy backup data to a backup server, rsync is used. To enable backup, please ensure there is a rsync.pwd in your installation path which contains rsync password.
Backup is currently covering SQLite database which is described in Grafana docs. Please note that an extension of the backup might be needed in case you're using plugins, another database or you change Grafana custom.ini itself.