django-o11y 0.4.0

Comprehensive OpenTelemetry observability for Django with traces, logs, metrics, and profiling

Django O11y

Opinionated, off-the-shelf observability for Django. Drop it in and get traces, structured logs, metrics, and profiling wired up with sensible defaults.

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

Documentation

To learn more about django-o11y, go to the complete documentation.

• Usage Guide
• Configuration Reference

License

Apache 2.0 - see LICENSE