kairosdb - Python library to interface the KairosDB REST API (kairosdb.github.io)

• Author: Denis 'jawa' Pompilio <denis.pompilio@gmail.com>
• Contact: Denis 'jawa' Pompilio <denis.pompilio@gmail.com>
• Sources:https://github.com/outini/python-kairosdb/

This package provides a simple python library to interface the KairosDB REST API. Please read also: https://kairosdb.github.io/docs/build/html/restapi/index.html.

Installation

Install python-kairosdb module from https://pypi.python.org:

pip install python-kairosdb

Install python-kairosdb module from sources:

python setup.py install

Debian binary packages are also available. See the packaging directory for more information.

Documentation

Documentation is available online: http://python-kairosdb.readthedocs.io/en/latest/index.html

Examples

importkairosdbif__name__=="__main__":
KDB_CLIENT=kairosdb.client.KairosDBAPIClient(
api_endpoint="https://kdb.domain.tld:4443/api/v1")
KDB_API=kairosdb.KairosDBAPI(KDB_CLIENT)
print(KDB_API.version)
print(KDB_API.health_status)
print(KDB_API.health_check)
print(KDB_API.metricnames)
print(KDB_API.tagnames)
print(KDB_API.query_metrics({
"metrics": [{
"name": "my_metric",
"group_by": [{"name": "tag", "tags": ['host']}],
"aggregators": [{
"name": "avg",
"align_sampling": True,
"sampling": {"value": 30, "unit": "seconds"}
}]
}],
"cache_time": 0,
"start_relative": {"value": "2", "unit": "hours"}
})

License

MIT LICENSE (see LICENSE file)