Skip to content

A nice and easy way to template Grafana dashboards in YAML πŸ“Š πŸŽ‰

License

Notifications You must be signed in to change notification settings

deliveryhero/grafyaml

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

grafyaml: Grafana dashboards templated in YAML

Delivery Hero ❀️ Grafana

Delivery Hero are big fans of Grafana but when Prometheus becomes your default storage for metrics of all types then the importance of good, consistent and manageable Grafana dashboards becomes paramount. Then once you add many teams, applications, services and environments to the mix, it becomes clear that a tool is needed to manage this complexity. This is that tool πŸŽ‰

  • No more headaches with copying, pasting and editing JSON
  • Template panels and use them in multiple dashboards
  • Mass update many dashboards quickly and easily

Install and quick start

Install grafyaml:

pip3 install https://github.com/deliveryhero/grafyaml/archive/master.zip

Create a file, e.g. my-example-dashboard.yaml:

dashboard:
  title: My Dashboard
  panels:
  - title: Container metrics
    panels:
    - title: Container CPU usage
      targets:
      - expr: rate(container_cpu_user_seconds_total[30s]) * 100
      type: timeseries

Sync it to Grafana:

export GRAFANA_API_KEY="API_KEY_HERE"
grafana-dashboard --grafana-url https://my-grafana-host.domain.com update my-example-dashboard.yaml

More examples

Build and install from source

python3 -m pip install wheel
python3 setup.py bdist_wheel
python3 -m pip install --force-reinstall dist/grafyaml-1.0-py3-none-any.whl

How to run linter

This repo uses black as the linter. You can read about it here

Install and run linter:

pip install black
black .

License, history and contributors

The LICENSE is Apache License 2.0. Most of the code in this repository was initially written at opendev.org/opendev/grafyaml before being forked to here.

About

A nice and easy way to template Grafana dashboards in YAML πŸ“Š πŸŽ‰

Resources

License

Stars

Watchers

Forks

Packages

No packages published