Metadata-Version: 2.0
Name: metricz
Version: 0.1.5.3
Summary: Metricz makes it easy to write metrics to a Kairosdb instance running with OAuth2 security.
Home-page: https://github.com/jmcs/metricz
Author: João Santos
Author-email: jmcs@jsantos.eu
License: UNKNOWN
Description-Content-Type: UNKNOWN
Keywords: metricz
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: requests
Requires-Dist: stups-tokens
Requires-Dist: click
Requires-Dist: clickclick
Requires-Dist: environmental (>=1.0)

===============================
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:

.. code-block:: python

    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:

.. code-block:: python

    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:

.. code-block:: python

    # 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.


