Sentry Answers>Django>

Debugging a Django application

Debugging a Django application

Naveera A.

The ProblemJump To Solution

What is the best way to debug a Django application? Are there any Django-specific tools to help you debug in Django?

For example, how can you debug why a template is taking too long to render? Or why an API endpoint is crashing? Is there a better way to debug than using print statements?

The Solution

There are many tools available to help us debug a Django application. Here are a few of the more popular ones:

Django Shell

Django shell is a Python shell that lets us access the database API included with Django. When we open the Django shell, Django loads all dependencies for the project and imports Django settings, allowing us to evaluate expressions related to our project.

We can start the Django shell using the ‘manage.py’ file, like so:

Click to Copy
$ python manage.py shell

Django Debug Toolbar

The Django Debug Toolbar is a visual tool that helps us debug the Django application.

The Django debug toolbar offers information on every page of our app using a sliding sidebar. It gives us information about various parts of the app like the current request/response, resource usage (e.g. time), Django settings, HTTP headers, SQL queries, cache, logging, and more.

We can install the toolbar with pip:

Click to Copy
(venv) $ pip install django-debug-toolbar

Now we need to add it to the project’s INSTALLED_APPS:

Click to Copy
# settings.py INSTALLED_APPS = [ 'my_project', ... 'debug_toolbar' ]

Then we will need to add it to the application’s MIDDLEWARE_CLASSES:

Click to Copy
# settings.py MIDDLEWARE_CLASSES = [ 'django.contrib.auth.middleware.SessionAuthenticationMiddleware', ... 'debug_toolbar.middleware.DebugToolbarMiddleware' ]

The toolbar’s sidebar will appear on any connection that matches Django’s INTERNAL_IPS if the DEBUG value is set to True.

Django PDB

Python’s built-in debugging module pdb is an excellent tool to debug any Python application interactively.

Django PDB is a package that allows us to use the pdb module in the context of Django applications. It automatically activates the pdb for any endpoint.

We can install the django-pdb module using pip:

Click to Copy
(venv) $ pip install django-pdb

Next we need to add it to the end of the application’s INSTALLED_APPS:

Click to Copy
# settings.py INSTALLED_APPS = [ 'my_project', ... 'django_pdb' ]

Then we will need to add it to the end of the application’s MIDDLEWARE_CLASSES:

Click to Copy
# settings.py MIDDLEWARE_CLASSES = [ 'django.contrib.auth.middleware.SessionAuthenticationMiddleware', ... 'django_pdb.middleware.PdbMiddleware' ]

Django PDB is fairly easy to use if you are familiar with Python’s pdb module. You can learn more about its usage in the documentation.

IDE Debug Tools

Lastly, we can also use the built-in debugging features of the IDE or code editor to debug a Django application.

Here are some links to debug a Django app in different IDEs and code editors:

  • Community SeriesIdentify, Trace, and Fix Endpoint Regression Issues
  • ResourcesBackend Error Monitoring 101
  • Syntax.fm logo
    Listen to the Syntax Podcast

    Tasty treats for web developers brought to you by Sentry. Get tips and tricks from Wes Bos and Scott Tolinski.

    SEE EPISODES

Loved by over 4 million developers and more than 90,000 organizations worldwide, Sentry provides code-level observability to many of the world’s best-known companies like Disney, Peloton, Cloudflare, Eventbrite, Slack, Supercell, and Rockstar Games. Each month we process billions of exceptions from the most popular products on the internet.

© 2024 • Sentry is a registered Trademark
of Functional Software, Inc.