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個選項

1. Healthy 健康
2. Unhealthy 不良
3. 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);

        }

相關推薦