TinyHealthCheck 0.0.3
See the version list below for details.
dotnet add package TinyHealthCheck --version 0.0.3
NuGet\Install-Package TinyHealthCheck -Version 0.0.3
<PackageReference Include="TinyHealthCheck" Version="0.0.3" />
paket add TinyHealthCheck --version 0.0.3
#r "nuget: TinyHealthCheck, 0.0.3"
// Install TinyHealthCheck as a Cake Addin #addin nuget:?package=TinyHealthCheck&version=0.0.3 // Install TinyHealthCheck as a Cake Tool #tool nuget:?package=TinyHealthCheck&version=0.0.3
TinyHealthCheck
A very small library for adding health checks to C# ServiceWorkers. It can be used anywhere you want a health check endpoint, but don't want to drag in the entire MVC ecosystem to support it. It has very few dependencies(2), and utilizes a low priority thread pool for low impact on your service worker processes.
Notes
- This health check is meant to be used for internal/private health checks only
- Expose it to the internet at your own peril
- Only GET operations are supported
- I have no plans to support other HttpMethods
- Only one endpoint per port is allowed, as well as one UrlPath per port
- This library was created for Service Workers that normally have no usable HTTP web server
- This library allows endpoints without the full MVC package
- No middleware, auth, validation, etc
- You can run different HealthChecks on different ports
Simple Usage
Simply add the TinyHealthCheck as a Hosted Service to have it run as a background process:
public static IHostBuilder CreateHostBuilder(string[] args)
{
var processStartTime = DateTimeOffset.Now;
return Host.CreateDefaultBuilder(args)
.ConfigureServices((hostContext, services) =>
{
services.AddHostedService<Worker>();
services.AddBasicTinyHealthCheck(config =>
{
config.Hostname = "*";
config.Port = 8080;
config.UrlPath = "/healthz";
return config;
});
});
}
This will create an endpoint on http://localhost:8080/healthz
with the following response body:
{
"Status": "Healthy!"
}
Uptime Monitor Endpoint
Call AddBasicTinyHealthCheckWithUptime
to add an uptime counter to the output:
public static IHostBuilder CreateHostBuilder(string[] args)
{
var processStartTime = DateTimeOffset.Now;
return Host.CreateDefaultBuilder(args)
.ConfigureServices((hostContext, services) =>
{
services.AddHostedService<Worker>();
services.AddBasicTinyHealthCheckWithUptime(config =>
{
config.Hostname = "*";
config.Port = 8081;
config.UrlPath = "/healthz";
return config;
});
});
}
This will create an endpoint on http://localhost:8081/healthz
with the following response body:
{
"Status": "Healthy!",
"Uptime": "<ever increasing timespan>"
}
Advanced Usage
Calling AddCustomTinyHealthCheck
with a class that inheirits from IHealthCheck allows you to create whatever type of response you want.
It also allows you to leverage DI to gain access to values from your other DI service containers. You could use this to get queue lengths,
check if databases are accessible, etc.
public static IHostBuilder CreateHostBuilder(string[] args)
{
var processStartTime = DateTimeOffset.Now;
return Host.CreateDefaultBuilder(args)
.ConfigureServices((hostContext, services) =>
{
services.AddHostedService<Worker>();
services.AddCustomTinyHealthCheck<CustomHealthCheck>(config =>
{
config.Hostname = "*";
config.Port = 8082;
config.UrlPath = "/healthz";
return config;
});
});
}
public class CustomHealthCheck : IHealthCheck
{
private readonly ILogger<CustomHealthCheck> _logger;
public CustomHealthCheck(ILogger<CustomHealthCheck> logger)
{
_logger = logger;
}
public async Task<string> Execute(CancellationToken cancellationToken)
{
_logger.LogInformation("This is an example of accessing the DI containers for logging. You can access any service that is registered");
return JsonSerializer.Serialize(new { Status = "Healthy!", CustomValue = "SomeValueFromServices" });
}
}
This will return the following body:
{
"Status": "Healthy!",
"CustomValue": "SomeValueFromServices"
}
Hostname consideration
By default, the hostname
parameter is set to localhost
. This will work fine for local development, but will not work across the network.
To allow listening on all interfaces, you must set hostname to *
. There are also security implications to doing this, which is why it is not
recommended to expose these health check endpoints to the internet.
On windows, you must run the process as an administrator to use * as the hostname! Failure to do this will result in the TinyHealthCheck process failing
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. 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. |
-
net5.0
- Microsoft.Extensions.Hosting.Abstractions (>= 5.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 5.0.0)
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 |
---|---|---|
1.1.1 | 108,594 | 12/9/2023 |
1.1.0 | 371 | 12/9/2023 |
1.0.1 | 2,452 | 11/29/2023 |
1.0.0 | 29,476 | 6/28/2023 |
0.0.16 | 66,349 | 5/11/2022 |
0.0.15 | 10,570 | 1/13/2022 |
0.0.14 | 413 | 1/13/2022 |
0.0.13 | 401 | 1/11/2022 |
0.0.12 | 417 | 1/11/2022 |
0.0.11 | 411 | 1/11/2022 |
0.0.10 | 406 | 1/11/2022 |
0.0.9 | 18,559 | 6/22/2021 |
0.0.8 | 344 | 6/22/2021 |
0.0.7 | 352 | 6/22/2021 |
0.0.6 | 378 | 6/22/2021 |
0.0.5 | 291 | 6/22/2021 |
0.0.4 | 308 | 6/22/2021 |
0.0.3 | 346 | 6/22/2021 |