grafana-sync
Keep your grafana dashboards in sync.
Table of Contents
Installing
Download the latest binary from releases
Getting Started
Pull
Save all dashboards to directory
grafana-sync pull-dashboards
Example: grafana-sync pull-dashboards --apikey="eyJrIjoiOWJYTktGNFlCbFVMOG1LY3d6ekN4Mmw4MFgyYU44a1UiLCJuIjoiY29icmEiLCJpZCI6MX0=" --directory="dashboards" --url http://127.0.0.1:3000
Save dashboards with specific tags to directory
grafana-sync pull-dashboards
Example: grafana-sync pull-dashboards --apikey="eyJrIjoiOWJYTktGNFlCbFVMOG1LY3d6ekN4Mmw4MFgyYU44a1UiLCJuIjoiY29icmEiLCJpZCI6MX0=" --directory="dashboards" --url http://127.0.0.1:3000 --tag=export
Save folders configuration to directory
grafana-sync pull-folders
Example: grafana-sync pull-folders --apikey="eyJrIjoiOWJYTktGNFlCbFVMOG1LY3d6ekN4Mmw4MFgyYU44a1UiLCJuIjoiY29icmEiLCJpZCI6MX0=" --directory="folders" --url http://127.0.0.1:3000
Save notifications configuration to directory
grafana-sync pull-notifications
Example: grafana-sync pull-notifications --apikey="eyJrIjoiOWJYTktGNFlCbFVMOG1LY3d6ekN4Mmw4MFgyYU44a1UiLCJuIjoiY29icmEiLCJpZCI6MX0=" --directory="notifications" --url http://127.0.0.1:3000
Push
Push dashboards to grafana
grafana-sync push-dashboards
Example: grafana-sync push-dashboards --apikey="eyJrIjoiOWJYTktGNFlCbFVMOG1LY3d6ekN4Mmw4MFgyYU44a1UiLCJuIjoiY29icmEiLCJpZCI6MX0=" --directory="dashboards" --url http://127.0.0.1:3000
Push folders to grafana
grafana-sync push-folders
Example: grafana-sync push-folders --apikey="eyJrIjoiOWJYTktGNFlCbFVMOG1LY3d6ekN4Mmw4MFgyYU44a1UiLCJuIjoiY29icmEiLCJpZCI6MX0=" --directory="folders" --url http://127.0.0.1:3000
Push notifications to grafana
grafana-sync push-notifications
Example: grafana-sync push-notifications --apikey="eyJrIjoiOWJYTktGNFlCbFVMOG1LY3d6ekN4Mmw4MFgyYU44a1UiLCJuIjoiY29icmEiLCJpZCI6MX0=" --directory="notifications" --url http://127.0.0.1:3000
Global parameters
directory
- Directory where to save dashboards. Default .
tag
- Dashboard tag to read. Supported only with pull
option. Default ""
apikey
- Grafana api key, need to be editor or admin. Default ""
.
Api key can be stored in $HOME/.grafana-sync.yaml
as apikey:
url
- Grafana Url with port. Default http://localhost:3000
Contributing
- Fork it
- Download your fork to your PC (
git clone https://github.com/your_username/grafana-sync && cd grafana-sync
) - Create your feature branch (
git checkout -b my-new-feature
) - Make changes and add them (
git add .
) - Commit your changes (
git commit -m 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new pull request
License
grafana-sync is released under the Apache 2.0 license. See LICENSE.txt