Star us on GitHub
Star
Menu

Using highlight.io with Python Django

Learn how to set up highlight.io on your Python Django backend API.

1

Configure client-side Highlight. (optional)

If you're using Highlight on the frontend for your application, make sure you've initialized it correctly and followed the fullstack mapping guide.

2

Install the highlight-io python package.

Download the package from pypi and save it to your requirements. If you use a zip or s3 file upload to publish your function, you will want to make sure highlight-io is part of the build.

poetry add highlight-io
Copy
# or with pip pip install highlight-io
Copy
3

Initialize the Highlight SDK.

Add Highlight with the Django integration to your settings.py file.

import highlight_io from highlight_io.integrations.django import DjangoIntegration # `instrument_logging=True` sets up logging instrumentation. # if you do not want to send logs or are using `loguru`, pass `instrument_logging=False` H = highlight_io.H( "<YOUR_PROJECT_ID>", integrations=[DjangoIntegration()], instrument_logging=True, service_name="my-django-app", service_version="git-sha", environment="production", )
Copy
4

Verify your installation.

Check that your installation is valid by throwing an error. Change one of your Django views to the following code which will throw an exception. Access the Django route in your browser. You should see a DivideByZero error in the Highlight errors page within a few moments.

import logging import random from django.http import HttpResponse, HttpRequest def index(request: HttpRequest): return HttpResponse(f"This might not go well. result is {2 / 0}")
Copy
5

Verify your backend logs are being recorded.

Visit the highlight logs portal and check that backend logs are coming in.

6

Verify your backend traces are being recorded.

Visit the highlight traces portal and check that backend traces are coming in.