debian-django-statsd-mozilla/README.rst

51 lines
1.3 KiB
ReStructuredText

Todo: write this
A tool that mashes up django-debug-toolbar, graphite, statsd and pystatsd.
Before you can think about getting this to work you'll need:
- A graphite server running and processing the data from statsd
- Some Django middleware or code that sends the data to statsd
Pystatsd: https://github.com/andymckay/pystatsd
Graphite: http://graphite.wikidot.com/installation
Django debug toolbar: https://github.com/django-debug-toolbar/django-debug-toolbar
An example Django app that logs to statsd on each request can be found in
nuggets: https://github.com/mozilla/nuggets
It works by adding the following to your middleware::
MIDDLEWARE_CLASSES = (
'commonware.response.middleware.GraphiteRequestTimingMiddleware',
'commonware.response.middleware.GraphiteMiddleware',
)
If you've got that setup, to your settings, add the following::
DEBUG_TOOLBAR_PANELS = (
...
'toolbar_statsd.panel.StatsdPanel'
)
STATSD_CLIENT = 'toolbar_statsd.panel'
TOOLBAR_STATSD = {
'graphite': 'http://your.graphite.server',
'roots': ['root.key.for.dev', 'root.key.for.stage']
}
INSTALLED_APPS = (
...
'toolbar_statsd'
)
Notes: django-debug-toolbar middleware must come *after* graphite middleware.
See: example.png for an example of the fun that can be had.