markus 0.1

Goals

Markus makes it easier to add metrics generation to your app by:

• providing multiple backends (Datadog statsd, logging, and so on) for sending data to multiple places

• sending metrics to multiple backends

• providing a testing framework for easy testing

• providing a decoupled infrastructure making it easier to use metrics without having to worry about making sure your metrics client is configured and instantiated before the things that want to use it; it’s similar to the Python logging module in this way

Install

Run:

$ pip install markus

To install Datadog StatsD backend:

$ pip install markus[datadog]

Quick start

Similar to using the logging library, every Python module can create a MetricsInterface (loosely equivalent to a Python logging logger) at any time and use that to post metrics including module import time.

For example:

import markus

metrics = markus.get_metrics(__name__)

Then you can use it anywhere in that module:

@metrics.timer_decorator('chopping_vegetables')
def some_long_function(vegetable):
    for veg in vegetable:
        chop_vegetable()
        metrics.incr('vegetable', 1)

At application startup, configure Markus with the backends you want to use to publish metrics and any options they require.

For example, lets configure metrics to publish to logs and Datadog:

import markus

markus.configure(
    backends=[
        {
            # Log metrics to the logs
            'class': 'markus.backend.logging.LoggingMetrics',
        },
        {
            # Log metrics to Datadog
            'class': 'markus.backend.datadog.DatadogMetrics',
            'options': {
                'host': 'example.com',
                'port': 8125,
                'namespace': ''
            }
        }
    ]
)

When you’re writing your tests, use the MetricsMock to make testing easier:

import markus
from markus.testing import MetricsMock


def test_something():
    with MetricsMock() as mm:
        # ... Do things that might publish metrics

        # This helps you debug and write your test
        mm.print_metrics()

        # Make assertions on metrics published
        assert mm.has_metric(markus.INCR, 'some.key', {'value': 1})

History

0.1 (April 10th, 2017)

Initial writing.