Paul Belanger 30f7d21f3f Make sure dashboard exists after we create it
The long term goal here is to eventually create python-grafana from
our embedded grafana.py file. So, most of this code just makes the
Grafana object more user friendly.

However, we've also added some validation around create_dashboard, we
added some checks before we create and after. To ensure we actually
created our new dashboards.

Finally, add some sphinx docs since everybody loves documentation.

Change-Id: Icbba403afe5208fbef1855118d4c3f4293461e00
Signed-off-by: Paul Belanger <pabelanger@redhat.com>
2015-10-02 13:42:35 -04:00

58 lines
1.9 KiB
Python

# Copyright 2015 Red Hat, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
from oslo_config import cfg
from oslo_log import log as logging
from grafana_dashboards.cache import Cache
from grafana_dashboards.grafana import Grafana
from grafana_dashboards.parser import YamlParser
grafana_opts = [
cfg.StrOpt(
'url', default='http://grafana.example.org',
help='URL for grafana server.'),
cfg.StrOpt(
'apikey', default=None,
help='API key for access grafana.'),
]
grafana_group = cfg.OptGroup(
name='grafana', title='Grafana options')
list_opts = lambda: [(grafana_group, grafana_opts), ]
CONF = cfg.CONF
CONF.register_group(grafana_group)
CONF.register_opts(grafana_opts, group='grafana')
LOG = logging.getLogger(__name__)
class Builder(object):
def __init__(self):
self.cache = Cache()
self.grafana = Grafana(CONF.grafana.url, CONF.grafana.apikey)
self.parser = YamlParser()
def update_dashboard(self, path):
self.parser.parse(path)
dashboards = self.parser.data.get('dashboard', {})
for name in dashboards:
data, md5 = self.parser.get_dashboard(name)
if self.cache.has_changed(name, md5):
self.grafana.create_dashboard(name, data, overwrite=True)
self.cache.set(name, md5)
else:
LOG.debug("'%s' has not changed" % name)