7f9c7fdee2
It seems newer voluptuous passes the specified default value into the verification method. Previously if data wasn't supplied it seems to have not validated anything and returend the default. Anyway this means we need to use a default value that matches our input type and manipulate it on the output end the same way we would normal input. We make this update in order to use newer voluptuous which will be required when we switch to python3.10. Change-Id: I64d9c8ac1334971f2d1c82f19ea675022635dc37
grafyaml
At a glance
- Free software: Apache license
- Documentation: http://docs.openstack.org/infra/grafyaml/
- Source: http://git.openstack.org/cgit/openstack-infra/grafyaml
- Bugs: https://storyboard.openstack.org/#!/project/818
Overview
grafyaml takes descriptions of Grafana dashboards in YAML format, and
uses them to produce JSON formatted output suitable for direct import
into Grafana.
The tool uses the Voluptuous data validation library to ensure the input produces a valid dashboard. Along with validation, users receive the benefits of YAML markup such as comments and clearer type support.
For example, here is a minimal dashboard specification
dashboard:
time:
from: "2018-02-07T08:42:27.000Z"
to: "2018-02-07T13:48:32.000Z"
templating:
- name: hostname
type: query
datasource: graphite
query: node*
refresh: true
title: My great dashboard
rows:
- title: CPU Usage
height: 250px
panels:
- title: CPU Usage for $hostname
type: graph
datasource: graphite
targets:
- target: $hostname.Cpu.cpu_prct_usedgrafyaml can be very useful in continuous-integration
environments. Users can specify their dashboards via a normal review
process and tests can validate their correctness.
The tool can also take JSON manually exported from the Grafana interface and load it as a dashboard. This allows keeping dashboards that have been edited with the inbuilt editor externally version controlled.
A large number of examples are available in the OpenStack project-config repository, which are used to create dashboards on http://grafana.openstack.org.