django-prometheus

What it is and what it does

django-prometheus is a Django middleware and instrumentation library that automatically collects and exports application metrics in Prometheus format. It hooks into Django's request/response cycle, ORM database operations, cache framework, and model lifecycle to generate counters, histograms, and gauges that Prometheus can scrape. You install it as a Django app, add two middleware classes to your stack, and expose a /metrics endpoint; the library then begins collecting latency, request counts, database query metrics, cache hit/miss rates, and model operation counts without requiring changes to your application code.

The package works with SQLite, MySQL, and PostgreSQL databases, supports filebased, memcached, and redis caches, and allows custom metric labels and namespacing. It integrates directly with prometheus-client and lets you add application-level metrics alongside the built-in Django instrumentation. Configuration is minimal—you can customize latency histogram buckets and metric prefixes in settings—making it suitable for both greenfield and legacy Django projects that need observability without heavy refactoring.

Use it for:

• Monitor HTTP request latency and throughput across your Django application endpoints in real time.
• Track database query performance and frequency to identify slow ORM operations and N+1 problems.
• Alert on cache hit/miss rates and eviction patterns to optimize caching strategy.
• Export model creation, update, and deletion rates to detect anomalous data mutation patterns.
• Collect migration status metrics to ensure all pending database migrations are applied.
• Add custom application-level metrics alongside Django internals using prometheus-client directly.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Exports Django application metrics (requests, database queries, cache operations, model changes) to Prometheus for monitoring and alerting.

Yes. django-prometheus is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It provides production-grade Prometheus instrumentation for Django with minimal setup—add middleware and a URL include, then scrape /metrics. Suitable for any Django project that needs observability without custom instrumentation code.

Install

django-prometheus on PyPI

pip install django-prometheus

uv add django-prometheus

poetry add django-prometheus

Installing django-prometheus

Before you install

Low friction install with just two runtime dependencies (Django and prometheus-client). Package is actively maintained with a recent release and no known vulnerabilities.

License in practice

Apache License (permissive) — you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart

pip install django-prometheus

# In settings.py
INSTALLED_APPS = ['django_prometheus', ...]
MIDDLEWARE = [
    'django_prometheus.middleware.PrometheusBeforeMiddleware',
    # ... other middleware ...
    'django_prometheus.middleware.PrometheusAfterMiddleware',
]

# In urls.py
urlpatterns = [path('', include('django_prometheus.urls')), ...]

Requires Django >= 4.2 and Python 3.9 or above.

Package facts

Evidence: django_prometheus-2.5.0-py2.py3-none-any.whl

Keywords: django, monitoring, prometheus

Tags

More Monitoring packages