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.