Repository files navigation

Graphite-web, without the interface. Just the rendering HTTP API.

Fork ofgraphite-api specifically for use with anInfluxDB backend.

This is a minimalistic API server that replicates the behavior ofGraphite-web.

Implemented API calls:

• /metrics/find
• /metrics/expand
• /render

No-ops:

• /dashboard/find
• /dashboard/load/<name>
• /events/get_data

• Hardcoded average consolidation of all data points removed - consolidation handled by storage back-end.
• Cairo optional dependency - Json/raw formats by default.
• Hardcoded legacy whisperindex file requirement removed. (/srv/index)
• maxdatapoints render query parameter removed - handled by storage back-end.
• Whisper hardcoded default configuration removed.
• Various fixes from pending graphite-api pull requests and back-ported fixes from graphite-web,asPercent among others.
• Performance improvements.

• Stateless. No need for a database.
• No Pickle rendering.
• No remote rendering.
• JSON data in request bodies is supported, additionally to form data andquerystring parameters.
• Compatibility with python 2 and 3.
• Easy to install and configure.

• Solid codebase. Strict flake8 compatibility, good test coverage.
• Ease of installation/use/configuration.
• Compatibility with the original Graphite-web API and 3rd-party dashboards.

• Support for Python versions older than2.7.
• Built-in support for every metric storage system in the world. Whisper isincluded by default, other storages are added via 3rd-party backends.

On readthedocs.org or in thedocs/ directory.

Cairo is used to render graphs server side when target format is an image. By default, only Json and raw format outputs are enabled. Attempts to render image formats without Cairo will result in an error message that it is not installed.

It can be pulled in via extras -pip install influxgraph-graphite-api[cairo].

Tox is used to run the tests for all supported environments. To get startedfrom a fresh clone of the repository:

pip install toxtox