Django O11y

Drop-in observability for Django. Install it, add a small config, and get traces, structured logs, metrics, and profiling.

Features

• OpenTelemetry traces for requests, database queries, cache, and Celery tasks
• Structlog with colorized dev output, JSON production logs, and automatic trace correlation
• django-prometheus for infrastructure metrics and a simple API for custom business metrics
• Pyroscope continuous profiling
• Full Celery observability: tracing, structured logs, and metrics
• Pre-built Grafana dashboards
• Sensible defaults, overridable via Django settings or environment variables
• Management command to spin up a local observability stack for testing

Background

This package bundles the patterns from these blog posts into an installable library:

• Django Monitoring with Prometheus and Grafana
• Django Development and Production Logging
• Celery Monitoring with Prometheus and Grafana

Docs

Read the full docs at adinhodovic.github.io/django-o11y.

• Usage Guide
• Configuration Reference

License

Apache 2.0 - see LICENSE