DotNetDiag HealthChecks
Health checks for every .NET service
Liveness and readiness probes for 50+ databases, queues, cloud services, and HTTP dependencies, with an optional dashboard UI and a Kubernetes operator.
A community-maintained continuation of Xabaril/AspNetCore.Diagnostics.HealthChecks. That project, shepherded by Xabaril and its many contributors, shaped the modern .NET health-check ecosystem. With upstream maintenance paused, DotNetDiag carries the work forward, with deep thanks to every original author whose code and APIs this fork continues.
60-second quickstart
Install a provider package:
dotnet add package DotNetDiag.HealthChecks.SqlServer
Register the check and map the endpoint in Program.cs:
builder.Services.AddHealthChecks()
.AddSqlServer(builder.Configuration.GetConnectionString("Default"));
app.MapHealthChecks("/health");
That's it. GET /health now returns Healthy or Unhealthy. Add the UI, more providers, or Kubernetes probes from the paths below.
Pick your path
Three ways to roll out
Most teams start with the minimal service and layer on the UI or Kubernetes pieces as the rollout grows.
Minimal service
Health checks only
Register checks, choose provider packages, and expose /health endpoints in a few lines.
Dashboard rollout
Add the UI
Stand up the HealthChecks UI for storage, polling, branding, and failure notifications.
Cluster rollout
Add Kubernetes
Probes, service discovery, and the operator for cluster-managed deployments.
Popular checks
Common integrations
Hand-picked starting points. The full catalog has 50+ packages.
SQL Server
Probe SQL Server availability and query responsiveness.
PostgreSQL
Check PostgreSQL connectivity through Npgsql.
Redis
Verify Redis responsiveness for cached and session data.
RabbitMQ
Confirm broker reachability before processing messages.
HTTP endpoints
Probe upstream URIs and external HTTP dependencies.
Kubernetes
Surface cluster service state for liveness and readiness probes.
Keep going
Deeper references
Reference Manual
Setup, package selection, UI, publishers, deployment, and the generated package index.
Guides
Task-oriented articles for Docker, branding, webhooks, probes, and the operator.
News
Documentation updates and the historical UI changelog.
About the fork
Why this fork exists, what it continues from Xabaril, and how to contribute.