Skip to content

django-watchman

PyPI version Coverage

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

Ozymandias

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.

PyCon Canada Presentation (10 minutes)

PyCon Canada Talk

Features

  • Status endpoint -- JSON response with the status of all backing services
  • Human-friendly dashboard -- HTML dashboard at /watchman/dashboard/
  • Token-based authentication -- Protect the endpoint with configurable tokens
  • Custom checks -- Write your own checks and plug them in
  • Management command -- Run checks from the command line
  • Ping endpoint -- Simple /watchman/ping/ endpoint returning pong
  • Bare status view -- Minimal HTTP 200/500 response for load balancers
  • APM integration -- Disable tracing for health check endpoints (Datadog, New Relic)

Get started with the installation guide or explore the full configuration options.