djdt-flamegraph

What it is and what it does

djdt-flamegraph is a Django Debug Toolbar panel that generates flame graphs of request execution in real time during development. It hooks into the debug toolbar UI and visualizes CPU time spent across the call stack, helping developers spot performance bottlenecks in their Django applications.

The package wraps the FlameGraph tool and requires a single-threaded development server to function—it cannot generate graphs in multithreaded environments due to signal handling constraints. Flame graphs are disabled by default and must be explicitly enabled via a checkbox in the toolbar. The project has been archived and receives no active maintenance.

Use it for:

• Identify which functions consume the most CPU time during a specific Django request
• Visualize call stack depth and branching to spot unexpected recursion or inefficient code paths
• Compare flame graphs across different request types to understand relative performance characteristics
• Debug performance regressions by comparing flame graphs before and after code changes

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Integrates flame graph visualization into Django Debug Toolbar to profile request execution and identify performance bottlenecks in a single-threaded development server.

No. The project is archived and abandoned, with the last commit on 2020-06-04. Compatibility with modern Django and Python versions is not guaranteed. For current development, consider actively maintained alternatives.

Install

djdt-flamegraph on PyPI

pip install djdt-flamegraph

uv add djdt-flamegraph

poetry add djdt-flamegraph

Installing djdt-flamegraph

Before you install

Low friction to install, but the project is archived and unmaintained since 2020. The last release was in January 2020. Compatibility with modern Django and Python versions is uncertain.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions, making it safe to adopt from a licensing perspective.

Quickstart

# Install
pip install djdt-flamegraph

# Add to Django settings.py
DEBUG_TOOLBAR_PANELS = [
    'djdt_flamegraph.FlamegraphPanel',
]

# Run server (single-threaded only)
python manage.py runserver --nothreading --noreload

Requires single-threaded Django development server (--nothreading --noreload flags); will not work on Windows or with threaded/async servers; project is unmaintained since last commit 2020-06-04.

Verify before relying

• Compatibility with Django versions released after 2020 and current Python 3.x releases
• Whether the package works with threaded or async Django servers beyond the single-threaded requirement
• Current status of the upstream FlameGraph dependency and any system-level requirements

Package facts

Evidence: djdt_flamegraph-0.2.13-py2.py3-none-any.whl

Keywords: djdt_flamegraph

Tags

More Quality Assurance packages