This is a mono repository for several NuGet packages based on the Microsoft.Extensions.Diagnostics.HealthChecks package. The main goal of this repository is to provide a set of health checks for different services and frameworks, which are fully configurable either via code or configuration.
What is the difference between this repository and the AspNetCore.Diagnostics.HealthChecks repository?
The main difference is that we try to focus on providing packages that are fully configurable via code or configuration. This means that you can configure the health checks in your Program.cs file, or in your appsettings.json file, or in any other configuration provider. While we continue to focus on configurability, we always consider the possibility of performance optimization. In some cases, we provide the same healthcheck for a service with an alternative implementation. For example, we provide a healthcheck for MySql that is based on MySql.Data and one that is based on MySqlConnector. This allows you to choose the implementation that best suits your needs or fits your existing dependencies.
While we continue to focus on configurability, we always consider the possibility of performance optimization.
| Method | Mean | Error | StdDev | Median | Ratio | RatioSD | Allocated | Alloc Ratio |
|---|---|---|---|---|---|---|---|---|
| AspNetCore.HealthChecks.SqlServer | 722.9 μs | 43.67 μs | 127.38 μs | 704.4 μs | baseline | 9.7 KB | ||
| NetEvolve.HealthChecks.SqlServer | 592.6 μs | 15.79 μs | 43.49 μs | 585.7 μs | 1.23x faster | 0.23x | 5.2 KB | 1.98x less |
In addition, we try to support the latest LTS and STS versions of .NET (.NET Support Policy) as well as the latest preview version of .NET for at least 3 years, but we can't guarantee this. This depends on the support of related NuGet packages and the .NET platform itself. See the Supported .NET Version section for more details.
The following table lists all currently available NuGet packages. For more details about the packages, please visit the corresponding NuGet page.
| Package Name | NuGet Link |
|---|---|
| NetEvolve.HealthChecks Contains general application HealthChecks. |
|
| NetEvolve.HealthChecks.Abstractions ❌ DEPRECATED Contains abstract implementations for the NetEvolve.HealthChecks. |
|
| NetEvolve.HealthChecks.Apache.ActiveMq Contains HealthChecks for Apache ActiveMq, based on the NuGet package Apache.NMS.ActiveMQ. |
|
| NetEvolve.HealthChecks.Apache.Kafka Contains HealthChecks for Apache Kafka, based on the NuGet package Confluent.Kafka. |
|
| NetEvolve.HealthChecks.Apache.Pulsar Contains HealthChecks for Pulsar, based on the nuget package DotPulsar. |
|
| NetEvolve.HealthChecks.ArangoDb Contains HealthChecks for ArangoDb, based on the nuget package ArangoDBNetStandard. |
|
| NetEvolve.HealthChecks.AWS Contains HealthChecks for various AWS services. |
|
| NetEvolve.HealthChecks.AWS.DynamoDB Contains HealthChecks for AWS DynamoDB. |
|
| NetEvolve.HealthChecks.AWS.EC2 Contains HealthChecks for AWS Elastic Compute Cloud (EC2). |
|
| NetEvolve.HealthChecks.AWS.S3 Contains HealthChecks for AWS Simple Storage Service (S3). |
|
| NetEvolve.HealthChecks.AWS.SNS Contains HealthChecks for AWS Simple Notification Service (SNS). |
|
| NetEvolve.HealthChecks.AWS.SQS Contains HealthChecks for AWS Simple Queue Service (SQS). |
|
| NetEvolve.HealthChecks.Azure Contains HealthChecks for various Azure services. |
|
| NetEvolve.HealthChecks.Azure.ApplicationInsights Contains HealthChecks for Azure Application Insights. |
|
| NetEvolve.HealthChecks.Azure.Blobs Contains HealthChecks for Azure Blob Storage. |
|
| NetEvolve.HealthChecks.Azure.EventHubs Contains HealthChecks for Azure Event Hubs. |
|
| NetEvolve.HealthChecks.Azure.Kusto Contains HealthChecks for Azure Kusto. |
|
| NetEvolve.HealthChecks.Azure.Queues Contains HealthChecks for Azure Queue Storage. |
|
| NetEvolve.HealthChecks.Azure.Search Contains HealthChecks for Azure AI Search. |
|
| NetEvolve.HealthChecks.Azure.ServiceBus Contains HealthChecks for Azure Service Bus. |
|
| NetEvolve.HealthChecks.Azure.Tables Contains HealthChecks for Azure Table Storage. |
|
| NetEvolve.HealthChecks.Cassandra Contains HealthChecks for Cassandra, based on the nuget package CassandraCSharpDriver. |
|
| NetEvolve.HealthChecks.ClickHouse Contains HealthChecks for ClickHouse, based on the nuget package ClickHouse.Client. |
|
| NetEvolve.HealthChecks.CockroachDb Contains HealthChecks for CockroachDb, based on the nuget package Npgsql. |
|
| NetEvolve.HealthChecks.Consul Contains HealthChecks for HashiCorp Consul, based on the nuget package Consul. |
|
| NetEvolve.HealthChecks.Couchbase Contains HealthChecks for Couchbase, based on the nuget package CouchbaseNetClient. |
|
| NetEvolve.HealthChecks.CouchDb Contains HealthChecks for CouchDb, based on the nuget package MyCouch. |
|
| NetEvolve.HealthChecks.Dapr Contains HealthChecks for Dapr, based on the nuget package Dapr.Client. |
|
| NetEvolve.HealthChecks.DB2 Contains HealthChecks for Db2, based on the nuget packages Net.IBM.Data.Db2 (Windows), Net.IBM.Data.Db2-lnx (Linux) and Net.IBM.Data.Db2-osx (OSX). |
|
| NetEvolve.HealthChecks.DuckDB Contains HealthChecks for DuckDB, based on the nuget package DuckDB.NET.Data. |
|
| NetEvolve.HealthChecks.Elasticsearch Contains HealthChecks for Elasticsearch, based on the nuget package Elastic.Clients.Elasticsearch. |
|
| NetEvolve.HealthChecks.EventStoreDb ❌ DEPRECATED Contains HealthChecks for EventStoreDb, based on the nuget package EventStore.Client.Grpc.Streams. |
|
| NetEvolve.HealthChecks.Firebird Contains HealthChecks for Firebird, based on the nuget package FirebirdSql.Data.FirebirdClient. |
|
| NetEvolve.HealthChecks.Garnet Contains HealthChecks for Microsoft Garnet, based on the NuGet package Microsoft.Garnet. |
|
| NetEvolve.HealthChecks.GCP Contains HealthChecks for various GCP services. |
|
| NetEvolve.HealthChecks.GCP.BigQuery Contains HealthChecks for Google Cloud Platform BigQuery, based on the nuget package Google.Cloud.BigQuery.V2. |
|
| NetEvolve.HealthChecks.GCP.Bigtable Contains HealthChecks for Google Cloud Platform Bigtable, based on the nuget package Google.Cloud.Bigtable.Admin.V2. |
|
| NetEvolve.HealthChecks.GCP.Firestore Contains HealthChecks for Google Cloud Platform Firestore, based on the nuget package Google.Cloud.Firestore. |
|
| NetEvolve.HealthChecks.GCP.PubSub Contains HealthChecks for Google Cloud Platform Pub/Sub, based on the nuget package Google.Cloud.PubSub.V1. |
|
| NetEvolve.HealthChecks.Http Contains HealthChecks for HTTP endpoints, based on the HttpClient. |
|
| NetEvolve.HealthChecks.InfluxDB Contains HealthChecks for InfluxDB, based on the nuget package InfluxDB.Client. |
|
| NetEvolve.HealthChecks.JanusGraph Contains HealthChecks for JanusGraph, based on the nuget package JanusGraph.Net. |
|
| NetEvolve.HealthChecks.Keycloak Contains HealthChecks for the Keycloak service, based on the nuget package Keycloak.Net.Core. |
|
| NetEvolve.HealthChecks.Kubernetes Contains HealthChecks for Kubernetes, based on the nuget package KubernetesClient. |
|
| NetEvolve.HealthChecks.KurrentDb Contains HealthChecks for KurrentDb, based on the nuget package KurrentDB.Client. |
|
| NetEvolve.HealthChecks.LiteDB Contains HealthChecks for litedb, based on the nuget package LiteDB. |
|
| NetEvolve.HealthChecks.MariaDb Contains HealthChecks for MariaDb, based on the nuget package MySqlConnector. |
|
| NetEvolve.HealthChecks.Meilisearch Contains HealthChecks for Meilisearch, based on the nuget package MeiliSearch. |
|
| NetEvolve.HealthChecks.Milvus Contains HealthChecks for Milvus, based on the nuget package Milvus.Client. |
|
| NetEvolve.HealthChecks.Minio Contains HealthChecks for Minio, based on the nuget package Minio. |
|
| NetEvolve.HealthChecks.MongoDb Contains HealthChecks for MongoDb, based on the nuget package MongoDB.Driver. |
|
| NetEvolve.HealthChecks.Mosquitto Contains HealthChecks for Mosquitto, based on the nuget package MQTTnet. |
|
| NetEvolve.HealthChecks.MySql Contains HealthChecks for MySql, based on the nuget package MySql.Data. |
|
| NetEvolve.HealthChecks.MySql.Connector Contains HealthChecks for MySql, based on the nuget package MySqlConnector. |
|
| NetEvolve.HealthChecks.MySql.Devart Contains HealthChecks for MySql, based on the nuget package Devart.Data.MySql. |
|
| NetEvolve.HealthChecks.NATS Contains HealthChecks for NATS, based on the nuget package NATS.Client. |
|
| NetEvolve.HealthChecks.Neo4j Contains HealthChecks for Neo4j, based on the nuget package Neo4j.Driver. |
|
| NetEvolve.HealthChecks.Npgsql Contains HealthChecks for PostgreSQL, based on the nuget package Npgsql. |
|
| NetEvolve.HealthChecks.Npgsql.Devart Contains HealthChecks for PostgreSQL, based on the nuget package Devart.Data.PostgreSql. |
|
| NetEvolve.HealthChecks.Odbc Contains HealthChecks for ODBC data sources, based on the nuget package System.Data.Odbc. |
|
| NetEvolve.HealthChecks.Ollama Contains HealthChecks for Ollama, based on the NuGet package OllamaSharp. |
|
| NetEvolve.HealthChecks.OpenSearch Contains HealthChecks for OpenSearch, based on the nuget package OpenSearch.Client. |
|
| NetEvolve.HealthChecks.Oracle Contains HealthChecks for Oracle Databases, based on the nuget package Oracle.ManagedDataAccess.Core. |
|
| NetEvolve.HealthChecks.Oracle.Devart Contains HealthChecks for Oracle Databases, based on the nuget package Devart.Data.Oracle. |
|
| NetEvolve.HealthChecks.Qdrant Contains HealthChecks for Qdrant Vector database, based on the nuget package Qdrant.Client. |
|
| NetEvolve.HealthChecks.RabbitMQ Contains HealthChecks for RabbitMQ, based on the nuget package RabbitMQ.Client. |
|
| NetEvolve.HealthChecks.RavenDb Contains HealthChecks for RavenDb, based on the nuget package RavenDB.Client. |
|
| NetEvolve.HealthChecks.Redis Contains HealthChecks for Redis, based on the NuGet package StackExchange.Redis. |
|
| NetEvolve.HealthChecks.Redpanda Contains HealthChecks for Redpanda, based on the NuGet package Confluent.Kafka. This is a temporary measure; if a dedicated Redpanda client is provided in the future, we will use it immediately. |
|
| NetEvolve.HealthChecks.SqlEdge ❌ DEPRECATED Contains HealthChecks for SqlEdge, based on the nuget package Microsoft.Data.SqlClient. |
|
| NetEvolve.HealthChecks.SQLite Contains HealthChecks for SQLite, based on the nuget package Microsoft.Data.Sqlite. |
|
| NetEvolve.HealthChecks.SQLite.Devart Contains HealthChecks for SQLite, based on the nuget package Devart.Data.SQLite. |
|
| NetEvolve.HealthChecks.SQLite.Legacy Contains HealthChecks for SQLite, based on the nuget package System.Data.Sqlite. |
|
| NetEvolve.HealthChecks.SqlServer Contains HealthChecks for Microsoft SqlServer, based on the nuget package Microsoft.Data.SqlClient. |
|
| NetEvolve.HealthChecks.SqlServer.Devart Contains HealthChecks for Microsoft SqlServer, based on the nuget package Devart.Data.SqlServer. |
|
| NetEvolve.HealthChecks.SqlServer.Legacy Contains HealthChecks for Microsoft SqlServer, based on the nuget package System.Data.SqlClient. |
The package names are based on the following naming schema - NetEvolve.HealthChecks.<ServiceGroup?>.<ServiceName>.<ServiceVersion?>
NetEvolveis the name of the organization that maintains this repository.HealthChecksindicates that this package contains health checks for various services.<ServiceGroup?>is an optional part that groups related services together. It helps to categorize the health checks based on the service provider or technology.<ServiceName>is the name of the service for which the health check is provided. It specifies the actual service that the health check is targeting.<ServiceVersion?>is an optional suffix that identifies a specific implementation or version of the client library used to connect to the service. This is useful when there are multiple client libraries available for the same service, each with different implementations or approaches.
The ServiceGroup is optional and is used to group related services. For example, all azure platform services are grouped under Azure. The ServiceName is the name of the service for which the health check is provided. For example, SqlServer or MySql.
The following table lists all planned and used groups. We will add more groups maybe in the future, if the demand is there.
- Apache
- AWS
- Azure
- GCP
The ServiceVersion in the package naming schema NetEvolve.HealthChecks.<ServiceGroup?>.<ServiceName>.<ServiceVersion?> refers to an optional suffix that identifies a specific implementation or version of the client library used to connect to the service.
This component is used when:
- Multiple Client Libraries: When there are multiple client libraries available for the same service, each with different implementations or approaches.
- Legacy vs Modern Implementations: To distinguish between older
Legacyand newer implementations of a client library for the same service.
This naming convention allows developers to choose the specific client implementation that best matches their existing dependencies without having to change their application architecture. For example, if your application already uses MySqlConnector, you would choose the corresponding health check package that uses the same client library.
The ServiceVersion is particularly valuable in scenarios where:
- Different client libraries have varying features, performance characteristics, or compatibility.
- You need to maintain compatibility with specific versions of a service.
-
SQL Server Client Libraries:
NetEvolve.HealthChecks.SqlServer- Uses the modernMicrosoft.Data.SqlClientNetEvolve.HealthChecks.SqlServer.Legacy- Uses the legacySystem.Data.SqlClient
-
MySQL Client Libraries:
NetEvolve.HealthChecks.MySql- Uses the implementation ofMySql.DataNetEvolve.HealthChecks.MySql.Connector- Uses the alternative implementation ofMySqlConnector
-
RabbitMQ Client Libraries:
NetEvolve.HealthChecks.RabbitMQ- Uses the latest version ofRabbitMQ.ClientNetEvolve.HealthChecks.RabbitMQ.V6- Uses the older version ofRabbitMQ.Client(version 6.x)
We try to support the LTS and STS versions of .NET (.NET Support Policy), as well as the latest preview version of .NET. We will try to support each framework version for at least 3 years, but we can't guarantee it. This depends on the support of related NuGet packages and the .NET platform itself.
| .NET Version | Supported |
|---|---|
| .NET Standard | ❌ No |
| .NET 7.0 or earlier versions | ❌ No |
| .NET 8.0 | ✅ Yes |
| .NET 9.0 | ✅ Yes |
| .NET 10.0 | ✅ Yes |
Why did we choose this approach? Because we want to be able to take advantage of the latest language features of the .NET platform and the performance gains that come with them. We know that not all of our NuGet packages will gain performance from this, but this is our general strategy and nobody knows what the future will bring.
To get more information about the end-of-life (EOL) date for the relevant components, please visit the website of the creators of the components or try the website endoflife.date.
With the .NET Standard Microsoft created a specification for APIs that are intended to be available on all .NET implementations. This was a great idea, but it also has some drawbacks. The main drawback is that the .NET Standard is a specification and not an implementation. This means that the real work is done by .NET implementations, such as .NET 5.0 and later versions. Which is why we decided us against the .NET Standard and for the concrete .NET implementations.
See The future of .NET Standard for more details.