Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cirocosta/grafana-sync

Keeps your Grafana dashboards in sync
https://github.com/cirocosta/grafana-sync

grafana

Last synced: 2 months ago
JSON representation

Keeps your Grafana dashboards in sync

Awesome Lists containing this project

README

        

### grafana-sync - Keeps your Grafana dashboards in sync

At each time that it's run, `grafana-sync` gathers information about dashboards from a particular source of truth (a grafana deployment) and then updates the state of the filesystem to reflect such source.

ps.: assumes use of the `folders` feature from grafana 5+

### Usage

```
Usage:
grafana-sync [OPTIONS]

Application Options:
--address= grafana address (default: http://localhost:3000)
--directory= directory where dashboards live (default: ./)
-v, --verbose displays requests on stderr

Authentication:
-u, --username= basic auth username
-p, --password= basic auth password
--access-token= access token to authenticate against grafana

Help Options:
-h, --help Show this help message
```

1. Create an API key that is capable of visualizing all dashboards

![API Key creation](./assets/create-api-key.png)

2. Run `grafana-sync`

```sh
./grafana-sync \
--verbose \
--address http://my-instance.com \
--access-token= \
--directory=./dashboards
```

Alternatively, you can also use basic auth (if configured):

```sh
./grafana-sync \
--verbose \
--address http://my-instance.com \
--username=admin \
--password=password \
--directory=./dashboards
```