Skip to main content

Versatile metrics collection for Python

Project description

PyMetrics is versatile metrics collection library for Python that encapsulates the collection of counters, gauges, histograms, and timers into a generic interface with pluggable publishers so that you can helpfully instrument your applications without suffering vendor lock.

Publishing metrics is a straightforward process involving two steps. First, configure your metrics and publisher(s):

    'version': 2,
    'error_logger_name': 'pymetrics',
    'publishers': [
            'path': 'pymetrics.publishers.datadog.DogStatsdPublisher',
            'kwargs': {
                'host': 'localhost',
                'port': 8135,

Then, use a pymetrics.recorders.base.MetricsRecorder in your application to collect and publish:

from pymetrics.recorders.default import DefaultMetricsRecorder

metrics = DefaultMetricsRecorder(config=settings.METRICS_CONFIG)


metrics.gauge('', tag_name1='tag_value1', tag_name2='tag_value2').set(12)


with metrics.timer(''):

cumulative_timer = metrics.timer('')
for item in items:
    with cumulative_timer:


Provided publisher plugins include Statsd, Datadog, Python Logging, SQLite, and a null publisher. Writing your own is simple and we encourage you to share your work with the community by submitting a pull request.


PyMetrics is licensed under the Apache License, version 2.0.


PyMetrics is available in PyPi and can be installing directly via Pip or listed in, requirements.txt, or Pipfile:

pip install 'pymetrics~=1.0'
pymetrics = {version="~=1.0"}


The complete PyMetrics documentation is available on Read the Docs!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymetrics-1.0.8.tar.gz (24.0 kB view hashes)

Uploaded source

Built Distribution

pymetrics-1.0.8-py27.py35.py36.py37.py38-none-any.whl (30.3 kB view hashes)

Uploaded py27 py35 py36 py37 py38

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page