Giter VIP home page Giter VIP logo

grafana-gnocchi-datasource's Introduction

Grafana Gnocchi datasource Travis CI

Gnocchi datasource for Grafana 3 and 4

Installation via grafana.net

$ sudo grafana-cli plugins install gnocchixyz-gnocchi-datasource

Installation from sources

$ npm install
$ ./run-tests.sh  # This also build the plugin under dist/

$ ln -s dist /var/lib/grafana/plugins/grafana-gnocchi-datasource
$ # or
$ cp -a dist /var/lib/grafana/plugins/grafana-gnocchi-datasource

Configuration Panel

Name Description
Name The data source name.
Default Default data source means that it will be pre-selected for new panels.
Url The http protocol, ip and port of your Keystone or Gnocchi server (default port is usually 8080)
Access Proxy = access via Grafana backend, Direct = access directory from browser.
Token A valid Keystone token
Project The keystone user
User The Keystone user
Password The Keystone password

Note: If the Keystone server is set as URL, the Gnocchi server will be autodiscovered. This works only if Access = Direct, and CORS is properly configured on Keystone and Gnocchi side.

Query editor

Open a graph in edit mode by click the title.

The editor have 4 modes to retreives metrics, you can change the mode by clicking of the pencil on the right.

  • Measurements of a metric: Create one graph with datapoint of the defined metric

    Metric ID: the id of the metric you are interrested in

  • Measurements of a metric of a resource: Create one graph with datapoint of the metric of the defined resource.

    Resource ID: the id of the resource Resource type: the type of the resource (generic, instance, disk, ...) Metric name: the name of the metric

  • Measurements of a metric of multiple resources: Create one graph per metric find with the query.

    Query: the query to search resources Resource type: the type of the resource (generic, instance, disk, ...) Metric name: the name of the metric Label attribute: the label or the resource attribute to use as label.

  • Aggregated measurements of a metric across resources: Create one graph with an aggregation of all datapoints of metrics that match the query.

    Query: the query to search resources Resource type: the type of the resource (generic, instance, disk, ...) Metric name: the name of the metric Label attribute: the label or the resource attribute to use as label.

Each mode also have the aggregator method to use to get datapoints of the metrics.

For details of Query format, please refer to the Gnocchi and Gnocchi client documentations.

Templated queries

Gnocchi Datasource Plugin provides following functions in Variables values query field in Templating Editor.

Name Description
metrics(resource_id) Returns a list of metrics available for the resource identified by ‘resource_id’
resources(resource_type, attribute, query) Returns a list of resource attribute matching query.

For details of Query format, please refer to the Gnocchi and Gnocchi client documentations.

Current Limitation

Grafana doesn’t allow to query two different servers when using the proxy mode, so we are not able to query Keystone for a token and then query gnocchi.

In proxymode, we need to set a token and the Gnocchi URL on the datasource.

In direct mode, we can use login/password and the Keystone URL. Note that CORS MUST be enabled on Keystone and Gnocchi servers.

License

APACHE LICENSE Version 2.0, January 2004

grafana-gnocchi-datasource's People

Contributors

alexanderzobnin avatar ali5h avatar bollig avatar christianchristensen avatar chupman avatar heinrichvk avatar jd avatar kylebrandt avatar mark-ezhkov avatar matschaffer avatar mtanda avatar pdf avatar prepor avatar siavashs avatar sileht avatar tmonk42 avatar torkelo avatar waipeng avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.