django-watchman

django-watchman exposes a status endpoint for your backing services like databases, caches, etc.

Ozymandias

Documentation

The full documentation is at django-watchman.readthedocs.io.

Testimonials

We're in love with django-watchman. External monitoring is a vital part of our service offering. Using django-watchman we can introspect the infrastructure of an application via a secure URL. It's very well written and easy to extend. We've recommended it to many of our clients already.

-- Hany Fahim, CEO, VM Farms.

Quickstart

Install django-watchman:

pip install django-watchman

Or with uv:

uv add django-watchman

Add watchman to your INSTALLED_APPS setting:

INSTALLED_APPS = (
    ...
    'watchman',
)

Include the watchman URLconf in your project urls.py:

re_path(r'^watchman/', include('watchman.urls')),

Start the development server and visit http://127.0.0.1:8000/watchman/ to get a JSON response of your backing service statuses:

{
    "databases": [
        {
            "default": {
                "ok": true
            }
        }
    ],
    "caches": [
        {
            "default": {
                "ok": true
            }
        }
    ],
    "storage": {"ok": true}
}

License

BSD-3-Clause

Release files for django-watchman 1.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-watchman 1.5.0
File	Size	Uploaded
django_watchman-1.5.0.tar.gz	22.9 kB	Mar 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-watchman 1.5.0
File	Interpreter	ABI	Platform	Reset
django_watchman-1.5.0-py3-none-any.whl 16.4 kB Mar 8, 2026	Python 3	none	any	Details

Total release size: 39.3 kB

Release files / django_watchman-1.5.0.tar.gz

Download URL	django_watchman-1.5.0.tar.gz
Size	22.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`924e819e51a10a6e08210cde12588544317d6697725634fccef40b9d675bc19e`
BLAKE2b-256 checksum How to use checksums	`8f9cc5703777a4fcfdf030ba79c6a91e0872da66a89004018bec4f5db15cf7d4`
Upload date	Mar 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mwarkentin/django-watchman
Publishing commit: github.com/mwarkentin/django-watchman/tree/44f35230b2ee67e4b8cd5d62028926edccdfd8f1

Workflow

Publishing configuration: github.com/mwarkentin/django-watchman/blob/44f35230b2ee67e4b8cd5d62028926edccdfd8f1/.github/workflows/publish.yml
Publishing logs: github.com/mwarkentin/django-watchman/actions/runs/22812864056/attempts/1

Artifact

Subject: django_watchman-1.5.0.tar.gz
SHA-256 checksum: 924e819e51a10a6e08210cde12588544317d6697725634fccef40b9d675bc19e Verifying attestations

Release files / django_watchman-1.5.0-py3-none-any.whl

Download URL	django_watchman-1.5.0-py3-none-any.whl
Size	16.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cd9b5d9796102db0d49f1162ad30b47e054d1413ce03214c580d19a274c02a0c`
BLAKE2b-256 checksum How to use checksums	`412a090b999822578194bf2c4842744429ee8768f3a7c18c3cf95fb0983d7683`
Upload date	Mar 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mwarkentin/django-watchman
Publishing commit: github.com/mwarkentin/django-watchman/tree/44f35230b2ee67e4b8cd5d62028926edccdfd8f1

Workflow

Publishing configuration: github.com/mwarkentin/django-watchman/blob/44f35230b2ee67e4b8cd5d62028926edccdfd8f1/.github/workflows/publish.yml
Publishing logs: github.com/mwarkentin/django-watchman/actions/runs/22812864056/attempts/1

Artifact

Subject: django_watchman-1.5.0-py3-none-any.whl
SHA-256 checksum: cd9b5d9796102db0d49f1162ad30b47e054d1413ce03214c580d19a274c02a0c Verifying attestations