grafana-backup-tool's Introduction

Grafana Dashboard Backup Tool

A Python-based application to backup Grafana settings via Grafana API.

Requirements

bash
python 2.7, python 3.x with requests library installed (pip install requests ?)
access to a Grafana 3.0 API server

Configuration

gafana-backup-tool uses environment variables to define the connection to a Grafana server, or alternatively hard-coded settings in src/grafanaSettings.py. You need to add the following to your .bashrc or execute once before using the tool:

export GRAFANA_URL=http://some.host.org:3000/
export GRAFANA_TOKEN=eyJrIjoidUhaU2ZQQndrWFN3RRVkUnVfrT56a1JoaG9KWFFObEgiLCJuIjoiYWRtaW4iLCJpZCI6MX0=

There is official documentation how to obtain the TOKEN for your installation.

How to Use

First perform Configuration as described above.
Use backup_grafana.sh to backup all your dashboards, datasources and folders to the _OUTPUT_ subdirectory of the current directory. For example:

$ ./backup_grafana.sh
$ tree _OUTPUT_
_OUTPUT_/
└── 2019-05-13T08:48:03.tar.gz

Use restore_grafana.sh with a path to a previous backup to restore everything. NOTE this may result in data loss, by overwriting data on the server.

Docker

Replace variables below to use docker version of this tool

{YOUR_GRAFANA_TOKEN}: Your grafana site token.
{YOUR_GRAFANA_URL}: Your grafana site url.
{YOUR_BACKUP_FOLDER_ON_THE_HOST}: The backup folder on the host machine.

docker run --rm --name grafana-backup-tool \
   -e GRAFANA_TOKEN={YOUR_GRAFANA_TOKEN} \
   -e GRAFANA_URL={YOUR_GRAFANA_URL} \
   -v {YOUR_BACKUP_FOLDER_ON_THE_HOST}:/opt/grafana-backup-tool/_OUTPUT_  \
   ysde/docker-grafana-backup-tool