Grafana Snapshots Tool

A python3 bases application to build grafana snapshots that contains data(!) using Grafana API and a python interface grafana_api

The aim of this tool is to:

Easily build snapshots from existing Grafana dashboard.
Export the snapshots to a local storage in JSON format so it can be sent, imported an visualized to a remote Grafana.
Import a snapshot in JSON format to a Grafana.

The development of this tool began when we discovered that there was no solution to automate the creation of snapshots from Grafana; only the functionality from the GUI was operational. That was a sticking point for us since it prevented us from being able to provide reports other than mannually build dashboards with statics screenshots. With this tool, we are able to build static dashboards, also called snapshots, that can be shared and visualized in grafana. It can be also used to store particular situation even if the data window is out of the scope of the retention of the datasource.

Install using this repo

    $ pip install git+https://github.com/peekjef72/grafana-snapshots-tool.git

Requirements:

bash
python >3.6
python modules:
- jinja2
- grafana-api 1.0.3 what will pull the dependencies
  - requests
  - idna
  - urllib3
  - certifi
  - chardet
Access to a Grafana API server.
A Token of an Admin role (grafana APIKey).

Configuration

The configuration is stored in a JSON file, with extended syntax that authorize comments in C++ style with // or /*... */. It contains 3 parts:

general: for script env.
- debug: enable verbose (debug) trace (for dev only...)
- snapshot_suffix: when generating or exporting a dashboard to snapshot, append that suffix to the snapshot name or file name. The suffix can contain plain text and pattern that is translated with strftime command.
- output_path: where to store the exported snapshots.

grafana: for grafana access settings
- protocal, host, port: use to build the access url
- verify_ssl: to check ssl certificate or not
- token: APIKEY with admin right from Grafana to access the REST API.
- search_api_limit: the maximum element to retrieve on search over API.

context: to define default values for dashboards, time_from, time_to and values for variables that the data exposed in the dashboard are depending from. It is an object. Add a sub-object identified by the dashboard name, for each dashboard you want to add default value. Each object can contain:
- time_from and time_to
- an object called vars: the definitions of each variable with it's corresponding value.

Usages

build a directory structure:

grafana-snapshosts/
- conf/grafana-snapshots.json where your main configuration file is
- snapshots/ where your exported snapshots will be stored.

usage: grafana-snapshots [-h] [-b BASE_PATH] [-c CONFIG_FILE] [-d DASHBOARD_NAME] [-f TIME_FROM] [-i IMPORT_FILE] [-o CONTEXT_NAME] [-t TIME_TO] [-v] [-V] [ACTION]

then enter into your directory and type in you commands.

Example:

generate a snapshot for the dashboard 'My dashboard' with default values for 'from' (now - 5 min) to 'now':

$ grafana-snapshots -d "My dashboard"
OK: new snapshot 'My_dashboard_202010241750.json' created.

then you can go into Grafana Gui and find the snapshot in dashboard/Manage/Snapshots part.

export the dashboard 'My dashboard' with data from: 'now-1d' to 'now':

$ grafana-snapshots -d "My dashboard" -f "now-1d" export
OK: snapshot exported to './snapshots/My_dashboard_202010241750.json' exported.

then you can find the created file in the "snapshots" dir.

import the file './snapshots/My_dashboard_202010241750.json' into Grafana

$ grafana-snapshots -f './snapshots/My_dashboard_202010241750.json' import
OK: snapshot './snapshots/My_dashboard_202010241750.json' imported.