Grafana durchsuchen mit "grafana-wtf"

grafana
#1

Einleitung

Für edukative Nachforschungs- und Umstrukturierungsarbeiten wünscht man sich manchmal die Möglichkeit, Grafana komfortabler durchsuchen zu können, als es das Benutzerinterface derzeit hergibt. Das klappt ganz passabel mit dem Kommandozeilen-Tool "grafana-wtf".

Features

  • JSON Repräsentationen von Grafana Dashboards nach Zeichenketten durchsuchen und Suchergebnisse inkl. Strukturkontext anzeigen.
  • Bearbeitungshistorie einzelner oder - besser! - aller Dashboards gemeinsam einsehen und tabellarisch oder als JSON ausgeben.

Referenzen


Installation

pip install grafana-wtf

Synopsis

# Define target URL and access token.
export GRAFANA_URL=https://daq.example.org/grafana/
export GRAFANA_TOKEN=eABrIjo...oiZ3JhZmFuYS13dGYiLCJpZCI6MX0=
# Search for string.
grafana-wtf find earth_43_sensors
grafana-wtf find 'shift('

# Display 50 most recent changes across all dashboards.
grafana-wtf log --number=50

Beispiel

$ grafana-wtf log --format=tabular:grid --number=10

2019-04-21 20:36:56,635 [grafana_wtf.core    ] INFO   : Scanning dashboards
2019-04-21 20:36:56,645 [grafana_wtf.core    ] INFO   : Found 80 dashboards
2019-04-21 20:36:56,645 [grafana_wtf.core    ] INFO   : Fetching dashboards
 57%|████████████████████████████████████████████████▎                                    | 46/80 [00:00<00:00, 138.11it/s]
 66%|████████████████████████████████████████████████████████▎                            | 53/80 [00:01<00:01, 22.81it/s]
 88%|██████████████████████████████████████████████████████████████████████████▍          | 70/80 [00:03<00:00, 10.36it/s]
100%|█████████████████████████████████████████████████████████████████████████████████████| 80/80 [00:04<00:00,  8.79it/s]
2019-04-21 20:37:01,049 [grafana_wtf.core    ] INFO   : Aggregating edit history for multiple Grafana dashboards at https://daq.example.org/grafana/
1 Like
#2

Examples

grafana-wtf log

grafana-wtf log --format=tabular:pipe --number=3
Dashboard Update
Notes: n/a
Föderiertes » PM10 (1h): Stationsansicht UBA & LDI-Korrektur
User: admin
Date: 2019-04-17T23:42:25+02:00
Notes: n/a
🤓 Labor » DWD: Stadtklimastationen [early development]
User: admin
Date: 2019-04-17T23:00:49+02:00
Notes: Bewölkung discrete no timeaxis
Wetter: DWD » Meteogramm einer Station
User: admin
Date: 2019-04-17T12:29:33+02:00

Screenshots

grafana-wtf find

grafana-wtf log

grafana-wtf log --format=tabular:grid --number=3