django-tracepanel

See what your Django app is really doing. Tracepanel records each request, Celery task and management command of your Django app with its SQL queries, cache calls, templates, signals, emails, logs and errors. It points out N+1 queries, duplicate queries, slow SQL and long transactions, and names the line of code to fix.

This package has no code of its own. It installs tracepanel with Django support, the same as pip install "tracepanel[django]".

pip install django-tracepanel

Setup

Add the app to your settings. It is on whenever DEBUG = True.

# settings.py
INSTALLED_APPS += ["tracepanel.django"]

To leave the settings as they are, start the server through tracepanel run instead. It turns Tracepanel on even with DEBUG = False.

tracepanel run python manage.py runserver

Open any page and click the badge in the corner to open the panel. The console is at /__tracepanel__/.

What it looks like

The panel also lists the requests your pages and tools make with fetch(), here Swagger UI's Try it out. Each issue comes with its fix in Django's terms, such as the select_related() that removes an N+1:

The console shows every endpoint over time, with the slowest and the failing ones:

Work without a page, such as Celery tasks, has its own pages:

Supported versions

Django 5.2, 6.0 and 6.1 on Python 3.11 and newer. Django 6.x needs Python 3.12 or newer, and Python 3.15 runs with Django 6.1.

Documentation

The documentation lives in docs/, built with MkDocs and Material. uv run poe docs serves it at http://127.0.0.1:8000/, and uv run poe docs-build builds it the way CI does.

License

Licensed under the MIT License.