Installation

To install django-speedbar add it to your installed apps, urls, and add the speedbar middleware.

# settings.py

 INSTALLED_APPS = [
     # ...
     'speedbar',
     # ...
 ]

 # For best results put speedbar as near to the top of your middleware
 # list as possible. django-speedbar listens to the django request_finished
 # signal so actions performed by middleware higher up the stack will still
 # be recorded, but will not be included in summary data.
 MIDDLEWARE_CLASSES = [
     'speedbar.middleware.SpeedbarMiddleware',
     # ...
 ]

# urls.py

urlpatterns = patterns('',
    # ...
    (r'^speedbar/', include('speedbar.urls')),
    # ...
)

To view the results in SpeedTracer you will also need to install the SpeedTracer plugin.

To include summary information in the page you can use the metric template tag.

{% load speedbar %}
<div class="speedbar">
    <span>Overall: {% metric "overall" "time" %} ms</span>
    <span>SQL: {% metric "sql" "count" %} ({% metric "sql" "time" %} ms)</span>
    <!-- ... -->
</div>

Configuration

django-speedbar has a number of configuration settings.

# Enable instrumentation of page load process
SPEEDBAR_ENABLE = True

# Enable the summary data template tags
SPEEDBAR_PANEL = True

# Include headers needed to show page generation profile tree in the
# Google Chrome SpeedTracer plugin.
SPEEDBAR_TRACE = True

# Include response headers with summary data for each request. These are
# intended for logging and are included in all requests, not just staff
# requests. If you turn this on we recommend configuring your load
# balancer to strip them before sending the response to the client.
SPEEDBAR_RESPONSE_HEADERS = False

# Configure which instrumentation modules to load. This should not
# normally be necessary for built in modules as they will only load
# if the relevant clients are installed, but is useful for adding
# additional custom modules.
SPEEDBAR_MODULES = [
    'speedbar.modules.stacktracer', # Most other modules depend on this one
    'speedbar.modules.pagetimer',
    'speedbar.modules.sql',
    'myproject.modules.sprockets',
    # ...
]

Status

We run our production systems with django-speedbar installed. However, the API is not stable and is likely to change. It does not yet have any default templates to make it easier to use the on-page features.

Similar projects

There are a number of similar projects you may want to consider as well as or instead of django-speedbar.

Credits

django-speedbar was primarily written by Theo Spears whilst working at Mixcloud.