Skip to main content

Performance metrics for Pyramid using StatsD

Project description


Performance metrics for Pyramid using StatsD. The project aims at providing
ways to instrument a Pyramid application in the least intrusive way.

* PyPI:
* Bitbucket:
* |droneio|

.. |droneio| image::
:alt: Tests on


Install using setuptools, e.g. (within a virtualenv)::

$ pip install pyramid_metrics


Once ``pyramid_metrics`` is installed, you must use the ``config.include``
mechanism to include it into your Pyramid project's configuration. In your
Pyramid project's ````:

.. code-block:: python

config = Configurator(.....)

Alternately you can use the ``pyramid.includes`` configuration value in your
``.ini`` file:

.. code-block:: ini

pyramid.includes = pyramid_metrics


Pyramid_metrics configuration (values are defaults):

.. code-block:: ini

[app:myapp] = localhost
metrics.port = 8125

metrics.prefix = application.stage

metrics.route_performance = true

Currently implemented

- Collection utility as a request method
- Ability to send metrics per Pyramid route
- Simple time marker mechanism
- Simple counter


- Full StatsD metric types
- Extensions for automatic metrology (SQLAlchemy, MongoDB, Requests...)
- Whitelist/blacklist of metrics
- Time allocation per subsystem (using the time marker mechanism)


- The general error policy is: always failsafe. Pyramid_metrics should NEVER
break your application.
- The DNS resolution is done during configuration to avoid recurring latencies.

Project details

Supported by

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