.Net Core實現健康檢查的示例代碼

 更新時間:2020-01-15 16:00:38   作者:佚名   我要評論(0)

ASP.NET Core 提供運行狀況檢查中間件和庫,以用于報告應用基礎結構組件的運行狀況。
運行狀況檢查由應用程序作為 HTTP 終結點公開。 可以為各種實時監視方案配置運

ASP.NET Core 提供運行狀況檢查中間件和庫,以用于報告應用基礎結構組件的運行狀況。

運行狀況檢查由應用程序作為 HTTP 終結點公開。 可以為各種實時監視方案配置運行狀況檢查終結點:

  • 運行狀況探測可以由容器業務流程協調程和負載均衡器用于檢查應用的狀態。 例如,容器業務流程協調程序可以通過停止滾動部署或重新啟動容器來響應失敗的運行狀況檢查。 負載均衡器可以通過將流量從失敗的實例路由到正常實例,來應對不正常的應用。
  • 可以監視內存、磁盤和其他物理服務器資源的使用情況來了解是否處于正常狀態。
  • 運行狀況檢查可以測試應用的依賴項(如數據庫和外部服務終結點)以確認是否可用和正常工作。

這個示例展示數據庫的運行狀態,他在其驗證數據庫連接并返回相應的結果

 [Route("health")]
    public ActionResult Health()
    {
      using (var connection = new SqlConnection("Server=.;Initial Catalog=master;Integrated Security=true"))
      {
        try
        {
          connection.Open();
        }
        catch (SqlException)
        {
          return new StatusCodeResult(503);
        
        }
      }

      return new EmptyResult();
    }

當我們請求該地址的時候時,如果連接到數據庫時出現任何連接問題,它將顯示一條包含200狀態代碼和503狀態代碼的空消息​​。

現在基于這些結果狀態碼,我們可以監視系統采取相關的操作。

從.NET Core2.2開始,我們不需要為運行狀態在去自定義檢查控制器和接口,而是框架本身已經為我們提供了運行狀況的檢查服務。

安裝和運行

Install-Package Microsoft.Extensions.Diagnostics.HealthChecks

安裝后,我們需要在Startup.cs文件的ConfigureServices()和Configure()方法中添加。

  public void ConfigureServices(IServiceCollection services)
    {
      services.AddHealthChecks();
    }
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
      app
        .UseHealthChecks("/health");
     
    }

我們在configure()方法中配置完端點后,我們就可以通過 /health 來請求查看我們的應用程序的健康程度的。

但是這樣對于我們剛才的需求是滿足不了的,那么我們如何自定義我們的健康度檢查呢?

兩種方式來處理

option 1

   public void ConfigureServices(IServiceCollection services)
    {
      services.AddHealthChecks()
 .AddCheck("sql", () =>
 {

   using (var connection = new SqlConnection("Server=.;Initial Catalog=master;Integrated Security=true"))
   {
     try
     {
       connection.Open();
     }
     catch (SqlException)
     {
       return HealthCheckResult.Unhealthy();
     }
   }

   return HealthCheckResult.Healthy();

 });
    }

在這里我們使用匿名方法AddCheck(),來編寫我們的自定義的驗證邏輯,結果是HealthCheckResult對象,該對象包含3個選項

  • Healthy 健康
  • Unhealthy 不良
  • Degraded 降級

option 2

實現IHealthCheck接口并實現CheckHealthAsync()方法,如下所示:

 public class DatabaseHealthCheck : IHealthCheck
    {
      public Task<HealthCheckResult> CheckHealthAsync(HealthCheckContext context, CancellationToken cancellationToken =
       default)
      {
        using (var connection = new SqlConnection("Server=.;Initial Catalog=master;Integrated Security=true"))
        {
          try
          {
            connection.Open();
          }
          catch (SqlException)
          {
            return Task.FromResult(HealthCheckResult.Unhealthy());
          }
        }

        return Task.FromResult(HealthCheckResult.Healthy());

      }
    }

創建該類之后,我們需要通過使用一些有效的唯一名稱,AddCheck ()方法在ConfigureServices()方法中提及該類,如下所示。

  public void ConfigureServices(IServiceCollection services)
    {
      services.AddHealthChecks() 
     .AddCheck<DatabaseHealthCheck>("sql");
    }

現在我們的代碼就寫完了,我們可以像上面那樣添加任意數量的Health Task,它將按照我們在此處聲明的順序運行。

自定義狀態碼

在之前我們也說過200為健康,503為不健康那么Healthcheck服務甚至通過以下方式使用其options對象提供自定義狀態代碼,為我們提供了更改此默認的狀態碼。

config.MapHealthChecks("/health", new HealthCheckOptions
           {
            ResultStatusCodes = new Dictionary<HealthStatus, int> { { HealthStatus.Unhealthy, 420 }, { HealthStatus.Healthy, 200 }, { HealthStatus.Degraded, 419 } }

             
           }); 

自定義輸出

我們可以自定義輸出,以獲取有關每個運行狀況檢查任務的更清晰詳細的信息。如果我們有多個運行狀況檢查任務來分析哪個任務使整個服務健康狀態變為”不正常“,這將非常有用。

我們可以通過HealthCheckOptions ResponseWriter屬性來實現。

   public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
      app
         .UseRouting()
         .UseEndpoints(config =>
         {
           config.MapHealthChecks("/health", new HealthCheckOptions
           {
            ResponseWriter=CustomResponseWriter
            
           }); 

         });

    }
    private static Task CustomResponseWriter(HttpContext context, HealthReport healthReport)
    {
      context.Response.ContentType = "application/json";

      var result = JsonConvert.SerializeObject(new
      {
        status = healthReport.Status.ToString(),
        errors = healthReport.Entries.Select(e => new
        {
          key = e.Key,
          value = e.Value.Status.ToString()
        })
      });
      return context.Response.WriteAsync(result);

    }

現在以json顯示我們的詳細信息,完成了健康狀態的檢查.

健康檢查界面

Install-Package AspNetCore.HealthChecks.UI

安裝完成后,需要相應地在ConfigureServices()和Configure()方法中調用相應的服務方法。

public void ConfigureServices(IServiceCollection services) 
{ 
  services.AddHealthChecksUI(); 
} 
 
public void Configure(IApplicationBuilder app, IHostingEnvironment env) 
{ 
  app.UseHealthChecksUI(); 
} 

配置完成后,您可以運行應用程序并指向/ healthchecks-ui地址,該端點顯示如下的UI.

但是界面上沒有我們剛才自定義的,那我們在進行配置

Appsetting.json

{
 "ApplicationInsights": {
  "InstrumentationKey": "your-instrumentation-key"
 },
 "Logging": {
  "LogLevel": {
   "Default": "Warning"
  }
 },
 "AllowedHosts": "*",
 "HealthChecksUI": {
  "HealthChecks": [
   {
    "Name": "Test Health",
    "Uri": "https://localhost:44342/health"
   }
  ],
  "EvaluationTimeinSeconds": 10,
  "MinimumSecondsBetweenFailureNotifications": 60
 }
}

這樣就可以看到健康狀態了

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。

您可能感興趣的文章:

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

相關文章

  • .Net Core實現健康檢查的示例代碼

    .Net Core實現健康檢查的示例代碼

    ASP.NET Core 提供運行狀況檢查中間件和庫,以用于報告應用基礎結構組件的運行狀況。 運行狀況檢查由應用程序作為 HTTP 終結點公開。 可以為各種實時監視方案配置運
    2020-01-15
  • 詳解在ASP.NET Core中如何編寫合格的中間件

    詳解在ASP.NET Core中如何編寫合格的中間件

    這篇文章探討了讓不同的請求去使用不同的中間件,那么我們應該如何配置ASP.NET Core中間件?其實中間件只是在ASP.NET Core中處理Web請求的管道。所有ASP.NET Core應
    2020-01-15
  • .NET 開發環境搭建圖文詳解

    .NET 開發環境搭建圖文詳解

    1 概述 在接下來的時間里,將會入手ASP.NET MVC這一專題,盡量用最快的時間,最有效的方法,分別從深度和廣度上剖析這一專題,力求講明白、講透。以此來與大家分享,
    2020-01-15
  • .NET Core 實現微信小程序支付功能(統一下單)

    .NET Core 實現微信小程序支付功能(統一下單)

    最近公司研發了幾個電商小程序,還有一個核心的電商直播,只要是電商一般都會涉及到交易信息,離不開支付系統,這里我們統一實現小程序的支付流程(與服務號實現步驟
    2020-01-15
  • 利用.net core實現反向代理中間件的方法

    利用.net core實現反向代理中間件的方法

    最近在將一些項目的rest api遷移到.net core中,最開始是用的Nginx做反向代理,將已經完成切換的部分切入系統,如下圖所示: 由于遷移過程中也在進行代碼重構,需要
    2020-01-15
  • ASP.NET MVC實現依賴注入的完整過程

    ASP.NET MVC實現依賴注入的完整過程

    前言 在java的spring中有自動注入功能,使得代碼變得更加簡潔靈活,所以想把這個功能移植到c#中,接下來逐步分析實現過程 1.使用自動注入場景分析 在asp.net mvc中,
    2020-01-15
  • .NET資源泄露與處理方案知識點分享

    .NET資源泄露與處理方案知識點分享

    .NET雖然擁有強大易用的垃圾回收機制,但并不是因為這樣,你就可以對資源管理放任不管,其實在稍不注意的時候,可能就造成了資源泄露,甚至因此導致系統崩潰,到那時
    2020-01-15
  • asp.net大文件上傳解決方案實例代碼

    asp.net大文件上傳解決方案實例代碼

    以ASP.NET Core WebAPI 作后端 API ,用 Vue 構建前端頁面,用 Axios 從前端訪問后端 API ,包括文件的上傳和下載。 準備文件上傳的API #region 文件上傳 可以帶參
    2020-01-15
  • .Net Core讀取Json配置文件的實現示例

    .Net Core讀取Json配置文件的實現示例

    前言:在與傳統的asp.net MVC項目相比,.net core項目在項目目錄的文件結構上和功能上與前者都有很大的區別。例如:在.net core中使用Startup.cs取代Global.asax文件
    2020-01-15
  • .net core部署到windows服務上的完整步驟

    .net core部署到windows服務上的完整步驟

    前言 Net core 項目部門在Windows有很多種方式,大致有以下幾種, dotnet 命令, iis(windowshosts), 一些開源的應用容器(docker ) 基于一些exe 程
    2020-01-15

最新評論

老快3投注技巧