Skip to main content

WSGI middleware for statsd timing

Project description

wsgi-statsd documentation

https://api.travis-ci.org/paylogic/wsgi-statsd.png https://pypip.in/v/wsgi-statsd/badge.png https://coveralls.io/repos/paylogic/wsgi-statsd/badge.png?branch=master Documentation Status

wsgi_statsd is a WSGI middleware that provides an easy way to time all requests. Integration is as easy as just wrapping your existing wsgi application.

Usage

In your wsgi.py file wrap your WSGI application as follows:

import statsd
from wsgi_statsd import StatsdTimingMiddleware


def application(environ, start_response):
    response_body = 'The request method was %s' % environ['REQUEST_METHOD']
    status = '200 OK'
    response_headers = [('Content-Type', 'text/plain'),
                        ('Content-Length', str(len(response_body)))]

    start_response(status, response_headers)

    return [response_body]

client = statsd.StatsClient(
    prefix='your_prefix',
    host='your_host',
    port=8125
)

application = StatsdTimingMiddleware(application, client)

What it does

The middleware uses the statsd timer function, using the environ[‘PATH_INFO’], environ[‘REQUEST_METHOD’] and the status code variables as the name for the key and the amount of time the request took as the value.

That’s it.

If you want more granular reporting you’ll have to work with the prefix argument. You can pass any string you want and the middleware will pass it along to statsd.

Using the foo prefix and calling the www.spam.com/bar page will result in foo.bar.GET.200 having a value equal to the time it took to handle the request.

Contact

If you have questions, bug reports, suggestions, etc. please create an issue on the GitHub project page.

License

This software is licensed under the MIT license

Please refer to the license file

© 2015 Wouter Lansu, Paylogic International and others.

Changelog

1.0.0

  • Initial public release

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

wsgi-statsd-0.1.0.tar.gz (4.5 kB view hashes)

Uploaded Source

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