快捷導(dǎo)航

如何給asp.net core寫個簡單的健康檢查

更新時間：2019年05月18日 13:13:20 作者：weihanli

這篇文章主要給大家介紹了關(guān)于如何給asp.net core寫個簡單的健康檢查的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家學(xué)習(xí)或者使用asp.net core具有一定的參考學(xué)習(xí)價值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧

Intro

健康檢查可以幫助我們知道應(yīng)用的當(dāng)前狀態(tài)是不是處于良好狀態(tài)，現(xiàn)在無論是 docker 還是 k8s 還是現(xiàn)在大多數(shù)的服務(wù)注冊發(fā)現(xiàn)大多都提供了健康檢查機(jī)制來檢測應(yīng)用的健康狀態(tài)，如果應(yīng)用本身就提供一個健康檢查的機(jī)制會更友好，更能真實(shí)的反映出應(yīng)用的健康狀態(tài)。

我們的開發(fā)環(huán)境虛擬機(jī)配置有點(diǎn)低，所以有時候虛擬機(jī)會卡死。。導(dǎo)致接口無響應(yīng)，有時可能有些服務(wù)啟動有問題會掛掉，所以需要一個簡單的健康檢查機(jī)制去檢查應(yīng)用的健康狀態(tài)來第一時間知道應(yīng)用出現(xiàn)異常。

健康檢查擴(kuò)展實(shí)現(xiàn)

實(shí)現(xiàn)源碼

  public static IApplicationBuilder UseHealthCheck(this IApplicationBuilder applicationBuilder)
  {
   return UseHealthCheck(applicationBuilder, new PathString("/api/health"));
  }

  public static IApplicationBuilder UseHealthCheck(this IApplicationBuilder applicationBuilder, string path)
  {
   return UseHealthCheck(applicationBuilder, new PathString(path));
  }

  public static IApplicationBuilder UseHealthCheck(this IApplicationBuilder applicationBuilder, PathString path)
  {
   applicationBuilder.Map(path, builder => builder.Use(
    (context, next) =>
    {
     context.Response.StatusCode = 200;
     return context.Response.WriteAsync("healthy");
    }));
   return applicationBuilder;
  }

  public static IApplicationBuilder UseHealthCheck(this IApplicationBuilder applicationBuilder, string path, Func<IServiceProvider, bool> checkFunc)
  {
   return UseHealthCheck(applicationBuilder, new PathString(path), serviceProvider => Task.FromResult(checkFunc(serviceProvider)));
  }

  public static IApplicationBuilder UseHealthCheck(this IApplicationBuilder applicationBuilder, string path,
   Func<IServiceProvider, Task<bool>> checkFunc)
  {
   return UseHealthCheck(applicationBuilder, new PathString(path), checkFunc);
  }

  public static IApplicationBuilder UseHealthCheck(this IApplicationBuilder applicationBuilder, PathString path, Func<IServiceProvider, bool> checkFunc)
  {
   if (checkFunc == null)
   {
    checkFunc = serviceProvider => true;
   }
   return UseHealthCheck(applicationBuilder, path, serviceProvider => Task.FromResult(checkFunc(serviceProvider)));
  }

  public static IApplicationBuilder UseHealthCheck(this IApplicationBuilder applicationBuilder, PathString path, Func<IServiceProvider, Task<bool>> checkFunc)
  {
   if (checkFunc == null)
   {
    checkFunc = serviceProvider => Task.FromResult(true);
   }
   applicationBuilder.Map(path, builder => builder.Use(
    async (context, next) =>
    {
     try
     {
      var healthy = await checkFunc.Invoke(context.RequestServices);
      if (healthy)
      {
       context.Response.StatusCode = StatusCodes.Status200OK;
       await context.Response.WriteAsync("healthy");
      }
      else
      {
       context.Response.StatusCode = StatusCodes.Status503ServiceUnavailable;
       await context.Response.WriteAsync("unhealthy");
      }
     }
     catch (Exception ex)
     {
      context.RequestServices.GetService<ILoggerFactory>().CreateLogger("HealthCheck").Error(ex);
      context.Response.StatusCode = StatusCodes.Status503ServiceUnavailable;
      await context.Response.WriteAsync("unhealthy");
     }
    }));
   return applicationBuilder;
  }

配置健康檢查

在 Startup 里配置健康檢查，示例代碼

app.UseHealthCheck(); // 最基本的健康檢查， 默認(rèn)檢查路徑為 ""/api/health"，直接返回 healthy
app.UseHealthCheck("/heath"); // 配置健康檢查的路徑為 "/health"，直接返回 healthy

app.UseHealthCheck("/health", serviceProvider =>
 {
  // 檢查數(shù)據(jù)連接是否正常，這里只是一個示例，可以根據(jù)需要自定義自己的實(shí)現(xiàn)
  var configuration = serviceProvider.GetService<IConfiguration>();
  var connString = configuration.GetConnectionString("DefaultConnection");
  try
  {
   using (var conn = new SqlConnection(connString))
   {
    conn.EnsureOpen();
   }
   return true;
  }
  catch (Exception)
  {
   return false;
  }
 });

實(shí)際效果

直接啟動訪問 "/health"