A plugin for using graphite-web with the cassandra-based Cyanite storage backend.
Python
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
.travis.yml
LICENCE
README.rst
cyanite.py
setup.cfg
setup.py
tests.py
tox.ini

README.rst

Graphite-Cyanite

Build Status

A plugin for using graphite with the cassandra-based Cyanite storage backend.

Requires Graphite-API (preferred) or Graphite-web 0.10.X.

Graphite-API is available on PyPI. Read the documentation for more information.

Graphite-web 0.10.X is currently unreleased. You'll need to install from source.

Installation

pip install cyanite

Using with graphite-api

In your graphite-api config file:

cyanite:
  urls:
    - http://cyanite-host:port
finders:
  - cyanite.CyaniteFinder

Using with graphite-web

In your graphite's local_settings.py:

STORAGE_FINDERS = (
    'cyanite.CyaniteFinder',
)

CYANITE_URLS = (
    'http://host:port',
)

Where host:port is the location of the Cyanite HTTP API. If you run Cyanite on multiple hosts, specify all of them to load-balance traffic:

# Graphite-API
cyanite:
  urls:
    - http://host1:port
    - http://host2:port

# Graphite-web
CYANITE_URLS = (
    'http://host1:port',
    'http://host2:port',
)

See pyr/cyanite for running the Cyanite carbon daemon.

Changelog

  • 0.4.6 (2015-10-05): Return arbitrarily large intervals in get_intervals().
  • 0.4.5 (2015-05-05): Handle path matches that return no data.
  • 0.4.4 (2014-10-22): Chunk cyanite requests if they end up being too long for cyanite.
  • 0.4.3 (2014-05-15): Fix a KeyError when no data is returned by cyanite for a given path.
  • 0.4.2 (2014-04-11): Fix graphite-web compatibility when using settings.CYANITE_URLS.
  • 0.4.1 (2014-04-10): Fix for multiple fetches when the results are empty.
  • 0.4.0 (2014-04-10): Ability to fetch multiple paths at a time instead of sequentially (requires graphite-api).
  • 0.3.0 (2014-04-07): Change configuration syntax to allow multiple-node cyanite setups.
  • 0.2.1 (2014-03-07): Prevent breaking graphite rendering when no data is returned from cyanite.
  • 0.2.0 (2014-03-06): Graphite-API compatibility.
  • 0.1.0 (2013-12-08): initial version.