RepletoryLib.HealthChecks 1.0.0

RepletoryLib.HealthChecks

Health check configuration for SQL Server, PostgreSQL, Redis, RabbitMQ, and external URIs.

Part of the RepletoryLib ecosystem -- standalone, reusable .NET 10 libraries with zero business logic.

Overview

RepletoryLib.HealthChecks provides a configuration-driven approach to health checks for ASP.NET Core applications. Enable checks for your infrastructure dependencies via appsettings.json and get a detailed JSON health report at /health.

Key Features

• SQL Server -- Connection check
• PostgreSQL -- Connection check
• Redis -- Connection check
• RabbitMQ -- Connection check
• External URIs -- HTTP reachability check for any URL
• JSON response -- Detailed health report with per-check status and duration
• Configuration-driven -- Enable/disable checks via config

Installation

dotnet add package RepletoryLib.HealthChecks

Dependencies

Quick Start

using RepletoryLib.HealthChecks;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRepletoryHealthChecks(builder.Configuration);

var app = builder.Build();
app.UseRepletoryHealthChecks();

{
  "HealthChecks": {
    "EnableSqlServer": true,
    "SqlServerConnection": "Server=localhost,1433;Database=MyApp;User Id=sa;Password=Repletory@123!;TrustServerCertificate=true",
    "EnablePostgres": true,
    "PostgresConnection": "Host=localhost;Port=5432;Database=myapp;Username=repletory;Password=Repletory@123!",
    "EnableRedis": true,
    "RedisConnection": "localhost:6379",
    "EnableRabbitMq": true,
    "RabbitMqConnection": "amqp://repletory:Repletory@123!@localhost:5672",
    "ExternalUrls": ["https://api.example.com/health"]
  }
}

Configuration

HealthCheckOptions

Usage Examples

Health Check Response

GET /health returns:

{
  "status": "Healthy",
  "totalDuration": "00:00:00.1234567",
  "entries": {
    "sqlserver": {
      "status": "Healthy",
      "duration": "00:00:00.0234567",
      "description": null,
      "tags": ["database", "sqlserver"]
    },
    "redis": {
      "status": "Healthy",
      "duration": "00:00:00.0012345",
      "description": null,
      "tags": ["cache", "redis"]
    },
    "rabbitmq": {
      "status": "Degraded",
      "duration": "00:00:05.0000000",
      "description": "Connection timed out",
      "tags": ["messaging", "rabbitmq"]
    }
  }
}

Kubernetes / Docker Health Probes

# docker-compose.yml
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
  interval: 30s
  timeout: 10s
  retries: 3

# Kubernetes
livenessProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 10
  periodSeconds: 30

Integration with Other RepletoryLib Packages

License

This project is licensed under the MIT License.

Copyright (c) 2024-2026 Repletory.

For complete documentation, infrastructure setup, and configuration reference, see the RepletoryLib main repository.