HealthCheckr 1.0.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package HealthCheckr --version 1.0.1
                    
NuGet\Install-Package HealthCheckr -Version 1.0.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="HealthCheckr" Version="1.0.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="HealthCheckr" Version="1.0.1" />
                    
Directory.Packages.props
<PackageReference Include="HealthCheckr" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add HealthCheckr --version 1.0.1
                    
#r "nuget: HealthCheckr, 1.0.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package HealthCheckr@1.0.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=HealthCheckr&version=1.0.1
                    
Install as a Cake Addin
#tool nuget:?package=HealthCheckr&version=1.0.1
                    
Install as a Cake Tool

HealthCheckr

A lightweight, async-friendly health check library for .NET and Azure Functions. Runs multiple health checks in parallel, preserves execution order, and produces a clean JSON response with status, durations, and optional error details.


CI Build Nuget

Features

  • Async health checks with support for CancellationToken
  • Preserve registration order in JSON response
  • Optional duration tracking per check
  • Optional error reporting per check
  • Configurable HTTP status codes for Healthy, Degraded, and Unhealthy states
  • JSON output with enum status serialized as string
  • Compatible with .NET 8+ (future .NET 10 support)

Installation

Install via NuGet:

dotnet add package HealthCheckr

Or via the NuGet Package Manager:

PM> Install-Package HealthCheckr

Usage

using HealthCheckr;

var checker = new HealthChecker()
    .AddCheck("Database", async ct => {
        // perform your database check
        return HealthStatus.Healthy;
    }, "Checks database connectivity")
    .AddCheck("Cache", async ct => {
        // perform cache check
        return HealthStatus.Degraded;
    }, "Checks Redis cache availability");

var result = await checker.CheckAsync();

Console.WriteLine(result.ToJson());

Example JSON Output

{
  "status": "Degraded",
  "checks": [
    {
      "name": "Database",
      "description": "Checks database connectivity",
      "status": "Healthy",
      "durationMs": 12
    },
    {
      "name": "Cache",
      "description": "Checks Redis cache availability",
      "status": "Degraded",
      "durationMs": 8
    }
  ],
  "totalDurationMs": 20,
  "timestamp": "2026-01-19T11:15:23.123Z"
}

Configuration

  • IncludeErrors – Include exception details for failing checks.
  • IncludeDuration – Include execution duration per check.
  • HealthyHttpStatusCode / DegradedHttpStatusCode / UnhealthyHttpStatusCode – Customize HTTP response codes for overall status.

Contributing

Contributions are welcome. Please open an issue or pull request on GitHub.


License

© Kirill Polishchuk

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.1.0 116 2/1/2026
2.0.0 106 1/22/2026
1.0.1 97 1/19/2026
1.0.0 111 1/19/2026