KairosDB REST API python client and interface
Project description
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>
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
import kairosdb
if __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)
