Metricz makes it easy to write metrics to a Kairosdb instance running with OAuth2 security.
Project description
Metricz
Metricz makes it easy to write metrics to a Kairosdb instance running with OAuth2 security.
Features
OAuth2 support.
Option to batch write metrics at a later time.
Usage
To simply write a metric:
from metricz import MetricWriter
mw = MetricWriter(directory='/path/to/credentials/dir)
mw.write_metric('some.metric.name', 123, {'some': 'tag'})
To write a metric with a custom timestamp:
import datetime
# Make sure this is in UTC.
timestamp = datetime.datetime(1981, 10, 26, 6, 24)
mw.write_metric('some.metric.name', 34, {'some': 'tag'}, timestamp)
To batch write metrics:
# These are NOT written directly.
mw.defer_metric('some.metric.name', 42, {'some': 'tag'})
mw.defer_metric('some.other.metric.name', 64, {'some': 'tag'})
mw.defer_metric('some.other.metric.name', 64, {'some': 'tag'})
# Write all deferred metrics at once.
mw.write_deferred()
TODO
Retry on failure.
Look at non-blocking options to write.
History
0.1.0 (2016-08-03)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
metricz-0.1.5.2.tar.gz
(13.7 kB
view hashes)
Built Distribution
Close
Hashes for metricz-0.1.5.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8e8549cea1c8054f6a593aa0c0ed9aaf80596908bbe3669d80e830583693bca5 |
|
MD5 | e9a44ccb6e7c19104835847559c7f98a |
|
BLAKE2b-256 | f24f10eed1d0c6e089b0b36e4c71c94e99a7ba5259ff6c7e07a09bfd9a0dc6e7 |