die Django Debug Toolbar

Ein nützliches Werkzeug, um Django zu debuggen und zu sehen, was unter der Haube passiert, nutzen wir die Django Debug Toolbar. Erstmal müssen wir dieses Paket allerdings installieren.

Fügen wir die Debugtoolbar der requirements-dev.in hinzu:

factory-boy
django-debug-toolbar

Kompilieren …

(eventenv)  pip-compile requirements-dev.in

Und syncen …

(eventenv)  pip-sync requirements.txt requirements-dev.txt

Die Debugtoolbar in den Settings registrieren

Dann fügen wir in den event_manager/settings.py unterhalb der MIDDLEWARE-Liste noch folgende Zeile hinzu:

MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.locale.LocaleMiddleware",
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "django.contrib.auth.middleware.AuthenticationMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
 ]

# hinzufügen:
MIDDLEWARE.extend(["debug_toolbar.middleware.DebugToolbarMiddleware"])

Zusätzlich registrieren wir die Toolbar noch in den installierten Apps, ebenfalls in den event_manager/settings.py. Wir legen dafür allerdings eine neue Liste namens THIRD_PARTY_DEV an, in der nur Drittanbieter-Apps abgelegt werden, die auf der Entwicklungsumgebung genutzt werden. Das erleichtert uns später das Aufsplitten der Settings in seperate Dateien für Entwicklung- und Produktivbetrieb.

INSTALLED_APPS.extend(
    ["events", "user", "pages"]
)

THIRD_PARTY_DEV = ["debug_toolbar"]
INSTALLED_APPS.extend(THIRD_PARTY_DEV)


DEBUG_TOOLBAR_CONFIG = {
    "INTERCEPT_REDIRECTS": False,
}


INTERNAL_IPS = ("127.0.0.1",)

Da wir die Debug-Toolbar nur lokal nutzen wollen, setzen wir für die gültigen IP-Adressen auf den Loopback, also 127.0.0.1.

INTERNAL_IPS

INTERNAL_IPS ist eine Django-Einstellung, die als Sicherheitsfilter fungiert und es Django ermöglicht, zu wissen, ob es in Ordnung ist (oder nicht), vertrauliche Informationen in seinen Anforderungen und der Debug-Informationsausgabe offenzulegen.

Live und Dev Settings

Momentan zeichnet sich ein Problem ab: Wir haben die debug_toolbar in den settings angelegt. Allerdings haben wir noch keine Live- und Produktions-Settings, und somit wäre die Debug-Toolbar auch in einer potentiellen Live-Umgebung sichtbar. Das werden wir später noch ändern, wenn wir die Konfiguration in Live und Dev auspalten werden.

Moment mal, Live und Dev was?

Jedes Projekt läuft beim Entwickeln in der sogenannten Dev-Umgebung, also lokal auf dem Rechner des Entwicklers. In dieser Umgebung ist die Konstante DEBUG=True und es ist offensichtlich nützlich, Debug-Programme wie die Debug-Toolbar zu nutzen.

Wenn das Projekt fertig ist bzw. reif für die Veröffentlichung, kommt es in die Produktiv-Umgebung, auch Live-Umgebung genannt. Da dürfen diese Debug-Tools natürlich nicht mehr aktiviert sein, um Angreifern keine Möglichkeit zu bieten, Informationen über das System zu erfahren.

Die Debugtoolbar in den URLs registrieren

Ein letzten Schritt ist das Anlegen der URL für die Toolbar:

In den event_manager/urls.py importieren wir die Settings:

from django.conf import settings

und fügen nach den URL-Patterns folgenden Code ein:

if settings.DEBUG:
    import debug_toolbar

    urlpatterns = [
        path("__debug__/", include(debug_toolbar.urls)),
    ] + urlpatterns

Das heisst also, wenn wir im DEBUG-Modus laufen (DEBUG=True), soll die Debugtoolbar importiert und der entsprechende Path in die urlpatterns eingehängt werden. Wenn wir jetzt den Runserver starten und http://127.0.0.1:8000/events/category/sport aufrufen, sehen wir auf der rechten Seite die Toolbar.

Das war’s, die Debug-Toolbar wird nun angezeigt und bietet verschiedene nützliche Informationen zu Ausführungszeit, SQL, statischen Dateien, Signalen usw.

Weitere nutzvolle Informationen: https://stackoverflow.com/questions/10517765/django-debug-toolbar-not-showing-up https://django-debug-toolbar.readthedocs.io/en/latest/