可视化ASP.Net Core Web API健康检查
前言
ASP.NET Core提供運(yùn)行狀況檢查Middleware和庫(kù),以便于報(bào)告應(yīng)用的運(yùn)行狀況。
使用方式也很簡(jiǎn)單。
引用Nuget包Microsoft.Extensions.Diagnostics.HealthChecks。
然后修改Startup.cs文件:
public?void?ConfigureServices(IServiceCollection?services) {...services.AddHealthChecks(); } public?void?Configure(IApplicationBuilder?app,?IWebHostEnvironment?env) {...app.UseHealthChecks("/health"); }我們甚至可以為第三方組件,比如數(shù)據(jù)庫(kù)、緩存,提供健康狀態(tài)檢查。
最后,訪問(wèn)/health來(lái)查看應(yīng)用程序的健康狀態(tài):
這種文本方式不夠直觀,今天我們介紹一個(gè)輕量級(jí)的圖形UI,通過(guò)可視化的方式進(jìn)行健康檢查。
Demo
1.引用Nuget包
引用如下Nuget包:
AspNetCore.HealthChecks.UI AspNetCore.HealthChecks.UI.Client AspNetCore.HealthChecks.UI.InMemory.StorageUI支持不同的存儲(chǔ)類(lèi)型,如Sql Server、MySql等,這里選擇直接保存到內(nèi)存。
2.修改Startup.cs
添加UI,并設(shè)置了自定義健康檢查,用于演示不健康狀態(tài):
public?void?ConfigureServices(IServiceCollection?services) {...services.AddHealthChecksUI().AddInMemoryStorage();services.AddHealthChecks().AddCheck<DemoHealthCheck>("My?IO"); }public?class?DemoHealthCheck:?IHealthCheck {public?Task<HealthCheckResult>?CheckHealthAsync(HealthCheckContext?context,?CancellationToken?cancellationToken?=?default){if?(DateTime.Now.Second?>?30){return?Task.FromResult(HealthCheckResult.Healthy());}return?Task.FromResult(HealthCheckResult.Unhealthy("不健康"));} }指定健康檢查和UI的地址,并且使用UIResponseWriter.WriteHealthCheckUIResponse返回json格式健康檢查數(shù)據(jù):
public?void?Configure(IApplicationBuilder?app,?IWebHostEnvironment?env) {...app.UseEndpoints(endpoints?=>{endpoints.MapControllers();endpoints.MapHealthChecks("/health",?new?HealthCheckOptions(){Predicate?=?_?=>?true,ResponseWriter?=?UIResponseWriter.WriteHealthCheckUIResponse});endpoints.MapHealthChecksUI(options?=>?options.UIPath?=?"/health-ui");}); }3.添加配置項(xiàng)
修改appsettings.json文件:
"HealthChecksUI":?{"HealthChecks":?[{"Name":?"My?IO","Uri":?"/health"}],"Webhooks":?[{"Name":?"","Uri":?"","Payload":?"","RestoredPayload":?""}],"EvaluationTimeinSeconds":?10,"MinimumSecondsBetweenFailureNotifications":?60}HealthChecks是個(gè)數(shù)組,也就是說(shuō),UI同時(shí)可以監(jiān)控多個(gè)健康檢查API。
Webhooks用于當(dāng)API的健康狀態(tài)改變時(shí),向指定Uri發(fā)送告警數(shù)據(jù)。
4.使用
運(yùn)行程序,訪問(wèn)/health-ui即可打開(kāi)UI:
點(diǎn)擊Details按鈕,還可查看健康狀態(tài)歷史:
總結(jié)
以上是生活随笔為你收集整理的可视化ASP.Net Core Web API健康检查的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
 
                            
                        - 上一篇: .NET6 如期⽽⾄
- 下一篇: nameof() 到底是编译时还是运行时
