День 1552. #ЗаметкиНаПолях
Проверки Работоспособности в ASP.NET Core. Начало
Мы все хотим создавать надёжные приложения, которые можно бесконечно масштабировать, чтобы обрабатывать любое количество запросов. Крайне важно, чтобы у вас была система для получения быстрой обратной связи о работоспособности приложения. В этом помогут проверки работоспособности (Health Checks).

Они позволяют отслеживать работоспособность различных компонентов, в том числе: баз данных, API, кэша, внешних сервисов. ASP.NET Core имеет встроенную поддержку проверки работоспособности.

Вот базовая конфигурация, которая регистрирует сервис проверки работоспособности:

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddHealthChecks();

var app = builder.Build();

app.MapHealthChecks("/health");

app.Run();

Проверка возвращает значение HealthStatus, которое может быть 3х видов:
- Healthy
- Degraded
- Unhealthy
Например, если приложение работает медленнее обычного, можно возвратить HealthStatus.Degraded.

Специальные проверки
Специальные проверки можно создавать, реализуя интерфейс IHealthCheck. Например, для базы данных SQL, можно использовать запрос, который быстро выполняется, вроде SELECT 1:

public class SqlHealthCheck : IHealthCheck
{
  private readonly string connStr;

  public SqlHealthCheck(IConfiguration cfg)
  {
    connStr = 
     cfg.GetConnectionString("Database");
  }

  public async Task<HealthCheckResult> 
   CheckHealthAsync(
    HealthCheckContext context,
    CancellationToken ct = default)
  {
    try
    {
      using var conn = 
       new SqlConnection(connStr);

      await conn.OpenAsync(ct);
      using var cmd = conn.CreateCommand();
      cmd.CommandText = "SELECT 1";
      await cmd.ExecuteScalarAsync(ct);

      return HealthCheckResult.Healthy();
    }
    catch(Exception ex)
    {
      return HealthCheckResult.Unhealthy(
        context.Registration.FailureStatus,
        exception: ex);
    }
  }
}

Проверку необходимо зарегистрировать, для этого добавим метод к AddHealthChecks:

builder.Services.AddHealthChecks()
  .AddCheck<SqlHealthCheck>(
   "custom-sql",
   HealthStatus.Unhealthy);

Мы задаём имя проверки и устанавливаем, какой статус использовать в качестве результата сбоя.

Окончание следует…

Источник: https://www.milanjovanovic.tech/blog/health-checks-in-asp-net-core