Skip to main content
Build Status Coverage Status

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

This is a minimalistic API server that replicates the behavior of Graphite-web. I removed everything I could and simplified as much code as possible while keeping the basic functionality.

Implemented API calls:

  • /metrics/find

  • /metrics/expand

  • /render

No-ops:

  • /dashboard/find

  • /dashboard/load/<name>

  • /events/get_data

Additional API calls:

  • /index (POST or PUT only): rebuilds the search index by recursively querying the storage backends for available paths. Replaces graphite-web’s build-index command-line script.

Difference from graphite-web

  • Stateless. No need for a database.

  • No Pickle rendering.

  • No remote rendering.

  • JSON data in request bodies is supported, additionally to form data and querystring parameters.

  • Ceres integration will be as an external backend.

  • Compatibility with python 2 and 3.

  • Easy to install and configure.

Goals

  • Solid codebase. Strict flake8 compatibility, good test coverage.

  • Ease of installation/use/configuration.

  • Compatibility with the original Graphite-web API and 3rd-party dashboards.

Non-goals

  • Support for very old Python versions (Python 2.6 is still supported but maybe not for long).

  • Built-in support for every metric storage system in the world. Whisper is included by default, other storages are added via 3rd-party backends.

Documentation

On readthedocs.org or in the docs/ directory.

Hacking

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

pip install tox
tox

Metadata

Release files for graphite-api 1.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for graphite-api 1.1.3
File Size Uploaded
graphite-api-1.1.3.tar.gz 75.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for graphite-api 1.1.3
File Interpreter ABI Platform
graphite_api-1.1.3-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 155.7 kB

Release files / graphite-api-1.1.3.tar.gz

Download URL graphite-api-1.1.3.tar.gz
Size 75.5 kB
Tags Source
SHA-256 checksum
How to use checksums
f72718124510065be75c53bf49bd69c16cdb13ca31431add77282c0f7c5933e3
BLAKE2b-256 checksum
How to use checksums
0c5702f5f1ae8c044ef6b8ade555e7541c36ccb738b29a3bd1b6973d4266e8c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / graphite_api-1.1.3-py2.py3-none-any.whl

Download URL graphite_api-1.1.3-py2.py3-none-any.whl
Size 80.2 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
252e599fc0195fe7ae9429d291b37d2cf2f2d098fc142b713141ca18a4f0e1dd
BLAKE2b-256 checksum
How to use checksums
830cca75b8ba16d9bdc402e0e228b55c88b01c4cfa6518bb8a9ecb453237538f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.1.3 This release

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.1.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page