.Net Core實現(xiàn)健康檢查的示例代碼
ASP.NET Core 提供運行狀況檢查中間件和庫,以用于報告應用基礎(chǔ)結(jié)構(gòu)組件的運行狀況。
運行狀況檢查由應用程序作為 HTTP 終結(jié)點公開。 可以為各種實時監(jiān)視方案配置運行狀況檢查終結(jié)點:
- 運行狀況探測可以由容器業(yè)務流程協(xié)調(diào)程和負載均衡器用于檢查應用的狀態(tài)。 例如,容器業(yè)務流程協(xié)調(diào)程序可以通過停止?jié)L動部署或重新啟動容器來響應失敗的運行狀況檢查。 負載均衡器可以通過將流量從失敗的實例路由到正常實例,來應對不正常的應用。
- 可以監(jiān)視內(nèi)存、磁盤和其他物理服務器資源的使用情況來了解是否處于正常狀態(tài)。
- 運行狀況檢查可以測試應用的依賴項(如數(shù)據(jù)庫和外部服務終結(jié)點)以確認是否可用和正常工作。
這個示例展示數(shù)據(jù)庫的運行狀態(tài),他在其驗證數(shù)據(jù)庫連接并返回相應的結(jié)果
[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(); }
當我們請求該地址的時候時,如果連接到數(shù)據(jù)庫時出現(xiàn)任何連接問題,它將顯示一條包含200狀態(tài)代碼和503狀態(tài)代碼的空消息。
現(xiàn)在基于這些結(jié)果狀態(tài)碼,我們可以監(jiān)視系統(tǒng)采取相關(guān)的操作。
從.NET Core2.2開始,我們不需要為運行狀態(tài)在去自定義檢查控制器和接口,而是框架本身已經(jīng)為我們提供了運行狀況的檢查服務。
安裝和運行
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 來請求查看我們的應用程序的健康程度的。
但是這樣對于我們剛才的需求是滿足不了的,那么我們?nèi)绾巫远x我們的健康度檢查呢?
兩種方式來處理
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(),來編寫我們的自定義的驗證邏輯,結(jié)果是HealthCheckResult對象,該對象包含3個選項
- Healthy 健康
- Unhealthy 不良
- Degraded 降級
option 2
實現(xiàn)IHealthCheck接口并實現(xiàn)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()); } }
創(chuàng)建該類之后,我們需要通過使用一些有效的唯一名稱,AddCheck
public void ConfigureServices(IServiceCollection services) { services.AddHealthChecks() .AddCheck<DatabaseHealthCheck>("sql"); }
現(xiàn)在我們的代碼就寫完了,我們可以像上面那樣添加任意數(shù)量的Health Task,它將按照我們在此處聲明的順序運行。
自定義狀態(tài)碼
在之前我們也說過200為健康,503為不健康那么Healthcheck服務甚至通過以下方式使用其options對象提供自定義狀態(tài)代碼,為我們提供了更改此默認的狀態(tài)碼。
config.MapHealthChecks("/health", new HealthCheckOptions { ResultStatusCodes = new Dictionary<HealthStatus, int> { { HealthStatus.Unhealthy, 420 }, { HealthStatus.Healthy, 200 }, { HealthStatus.Degraded, 419 } } });
自定義輸出
我們可以自定義輸出,以獲取有關(guān)每個運行狀況檢查任務的更清晰詳細的信息。如果我們有多個運行狀況檢查任務來分析哪個任務使整個服務健康狀態(tài)變?yōu)椤辈徽!?,這將非常有用。
我們可以通過HealthCheckOptions ResponseWriter屬性來實現(xiàn)。
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); }
現(xiàn)在以json顯示我們的詳細信息,完成了健康狀態(tài)的檢查.
健康檢查界面
Install-Package AspNetCore.HealthChecks.UI
安裝完成后,需要相應地在ConfigureServices()和Configure()方法中調(diào)用相應的服務方法。
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 } }
這樣就可以看到健康狀態(tài)了
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持我們。
上一篇:ASP.NET Core 過濾器中使用依賴注入知識點總結(jié)
欄 目:ASP.NET
下一篇:DataGridView使用自定義控件實現(xiàn)簡單分頁功能(推薦)
本文標題:.Net Core實現(xiàn)健康檢查的示例代碼
本文地址:http://mengdiqiu.com.cn/a1/ASP_NET/10860.html
您可能感興趣的文章
- 01-11如何給asp.net core寫個簡單的健康檢查
- 01-11淺析.Net Core中Json配置的自動更新
- 01-11.net core高吞吐遠程方法如何調(diào)用組件XRPC詳解
- 01-11.NET Core 遷移躺坑記續(xù)集之Win下莫名其妙的超時
- 01-11.NET開發(fā)人員關(guān)于ML.NET的入門學習
- 01-11docker部署Asp.net core應用的完整步驟
- 01-11.net core webapi jwt 更為清爽的認證詳解
- 01-11ASP.NET Core靜態(tài)文件的使用方法
- 01-11.NET Core 3.0之創(chuàng)建基于Consul的Configuration擴展組件
- 01-11.net core EF Core調(diào)用存儲過程的方式


閱讀排行
本欄相關(guān)
- 01-11vscode extension插件開發(fā)詳解
- 01-11VsCode插件開發(fā)之插件初步通信的方法
- 01-11如何給asp.net core寫個簡單的健康檢查
- 01-11.net core高吞吐遠程方法如何調(diào)用組件
- 01-11淺析.Net Core中Json配置的自動更新
- 01-11.NET開發(fā)人員關(guān)于ML.NET的入門學習
- 01-11.NET Core 遷移躺坑記續(xù)集之Win下莫名其
- 01-11.net core webapi jwt 更為清爽的認證詳解
- 01-11docker部署Asp.net core應用的完整步驟
- 01-11ASP.NET Core靜態(tài)文件的使用方法
隨機閱讀
- 04-02jquery與jsp,用jquery
- 01-10delphi制作wav文件的方法
- 08-05dedecms(織夢)副欄目數(shù)量限制代碼修改
- 01-10使用C語言求解撲克牌的順子及n個骰子
- 01-11Mac OSX 打開原生自帶讀寫NTFS功能(圖文
- 01-10C#中split用法實例總結(jié)
- 08-05織夢dedecms什么時候用欄目交叉功能?
- 01-10SublimeText編譯C開發(fā)環(huán)境設置
- 01-11ajax實現(xiàn)頁面的局部加載
- 08-05DEDE織夢data目錄下的sessions文件夾有什