如何在 ASP.Net Core 中实现健康检查

本文转载自微信公众号「码农读书」，作者码农读书 。转载本文请联系码农读书公众号。

成都创新互联长期为数千家客户提供的网站建设服务，团队从业经验10年，关注不同地域、不同群体，并针对不同对象提供差异化的产品和服务；打造开放共赢平台，与合作伙伴共同营造健康的互联网生态环境。为沙县企业提供专业的成都网站制作、做网站、外贸营销网站建设，沙县网站改版等技术服务。拥有10余年丰富建站经验和众多成功案例,为您定制开发。

健康检查 常用于判断一个应用程序能否对 request 请求进行响应，ASP.Net Core 2.2 中引入了 健康检查 中间件用于报告应用程序的健康状态。

ASP.Net Core 中的 健康检查 落地做法是暴露一个可配置的 Http 端口，你可以使用 健康检查 去做一个最简单的活性检测，比如说：检查网络和系统的资源可用性，数据库资源是否可用，应用程序依赖的消息中间件或者 Azure cloud service 的可用性 等等，这篇文章我们就来讨论如何使用这个 健康检查中间件。

注册健康检查服务

要注册 健康检查 服务，需要在 Startup.ConfigureServices 下调用 AddHealthChecks 方法，然后使用 UseHealthChecks 将其注入到 Request Pipeline 管道中，如下代码所示：

 
 
 
 
      
  
  
  
  1. public class Startup 
    2.   
  
  
  
  2.     { 
    3.   
  
  
  
  3.  
    4.   
  
  
  
  4.         // This method gets called by the runtime. Use this method to add services to the container. 
    5.   
  
  
  
  5.         public void ConfigureServices(IServiceCollection services) 
    6.   
  
  
  
  6.         { 
    7.   
  
  
  
  7.             services.AddControllersWithViews(); 
    8.   
  
  
  
  8.  
    9.   
  
  
  
  9.             services.AddHealthChecks(); 
    10.   
  
  
  
  10.         } 
    11.   
  
  
  
  11.  
    12.   
  
  
  
  12.         // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. 
    13.   
  
  
  
  13.         public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 
    14.   
  
  
  
  14.         { 
    15.   
  
  
  
  15.             app.UseHealthChecks("/health"); 
    16.   
  
  
  
  16.  
    17.   
  
  
  
  17.             app.UseStaticFiles(); 
    18.   
  
  
  
  18.             app.UseRouting(); 
    19.   
  
  
  
  19.             app.UseEndpoints(endpoints => 
    20.   
  
  
  
  20.             { 
    21.   
  
  
  
  21.                 endpoints.MapControllerRoute( 
    22.   
  
  
  
  22.                     name: "default", 
    23.   
  
  
  
  23.                     pattern: "{controller=Home}/{action=Index}/{id?}"); 
    24.   
  
  
  
  24.             }); 
    25.   
  
  
  
  25.         } 
    26.   
  
  
  
  26.     } 
    27.

上图的 /health 就是一个可供检查此 web 是否存活的暴露端口。

其他服务的健康检查

除了web的活性检查，还可以检查诸如：SQL Server, MySQL, MongoDB, Redis, RabbitMQ, Elasticsearch, Hangfire, Kafka, Oracle, Azure Storage 等一系列服务应用的活性，每一个服务需要引用相关的 nuget 包即可，如下图所示：

然后在 ConfigureServices 中添加相关服务即可，比如下面代码的 AddSqlServer。

 
 
 
 
      
  
  
  
  1. public void ConfigureServices(IServiceCollection services) 
    2.   
  
  
  
  2.         { 
    3.   
  
  
  
  3.             services.AddControllersWithViews(); 
    4.   
  
  
  
  4.  
    5.   
  
  
  
  5.             services.AddHealthChecks().AddSqlServer("server=.;database=PYZ_L;Trusted_Connection=SSPI"); 
    6.   
  
  
  
  6.         } 
    7.

自定义健康检查

除了上面的一些开源方案，还可以自定义实现 健康检查 类，比如自定义方式来检测 数据库 或 外部服务 的可用性，那怎么实现呢?只需要实现系统内置的 IHealthCheck 接口并实现 CheckHealthAsync() 即可，如下代码所示：

 
 
 
 
      
  
  
  
  1. public class MyCustomHealthCheck : IHealthCheck 
    2.   
  
  
  
  2.    { 
    3.   
  
  
  
  3.        public async Task CheckHealthAsync(HealthCheckContext context, 
    4.   
  
  
  
  4.                                                        CancellationToken cancellationToken = default(CancellationToken)) 
    5.   
  
  
  
  5.        { 
    6.   
  
  
  
  6.            bool canConnect = IsDBOnline(); 
    7.   
  
  
  
  7.  
    8.   
  
  
  
  8.            if (canConnect) 
    9.   
  
  
  
  9.                return HealthCheckResult.Healthy(); 
    10.   
  
  
  
  10.            return HealthCheckResult.Unhealthy(); 
    11.   
  
  
  
  11.        } 
    12.   
  
  
  
  12.    } 
    13.

这里的 IsDBOnline 方法用来判断当前数据库是否是运行状态，实现代码如下：

 
 
 
 
      
  
  
  
  1. private bool IsDBOnline() 
    2.   
  
  
  
  2.         { 
    3.   
  
  
  
  3.             string connectionString = "server=.;database=PYZ_L;Trusted_Connection=SSPI"; 
    4.   
  
  
  
  4.  
    5.   
  
  
  
  5.             try 
    6.   
  
  
  
  6.             { 
    7.   
  
  
  
  7.                 using (SqlConnection connection = new SqlConnection(connectionString)) 
    8.   
  
  
  
  8.                 { 
    9.   
  
  
  
  9.                     if (connection.State != System.Data.ConnectionState.Open) connection.Open(); 
    10.   
  
  
  
  10.                 } 
    11.   
  
  
  
  11.  
    12.   
  
  
  
  12.                 return true; 
    13.   
  
  
  
  13.             } 
    14.   
  
  
  
  14.             catch (System.Exception) 
    15.   
  
  
  
  15.             { 
    16.   
  
  
  
  16.                 return false; 
    17.   
  
  
  
  17.             } 
    18.   
  
  
  
  18.         } 
    19.

然后在 ConfigureServices 方法中进行注入。

 
 
 
 
      
  
  
  
  1. public void ConfigureServices(IServiceCollection services) 
    2.   
  
  
  
  2.         { 
    3.   
  
  
  
  3.             services.AddControllersWithViews(); 
    4.   
  
  
  
  4.             services.AddHealthChecks().AddCheck("sqlcheck"); 
    5.   
  
  
  
  5.         } 
    6.   
  
  
  
  6.  
    7.   
  
  
  
  7.         public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 
    8.   
  
  
  
  8.         { 
    9.   
  
  
  
  9.             app.UseRouting().UseEndpoints(config => 
    10.   
  
  
  
  10.             { 
    11.   
  
  
  
  11.                 config.MapHealthChecks("/health"); 
    12.   
  
  
  
  12.             }); 
    13.   
  
  
  
  13.  
    14.   
  
  
  
  14.             app.UseStaticFiles(); 
    15.   
  
  
  
  15.             app.UseRouting(); 
    16.   
  
  
  
  16.  
    17.   
  
  
  
  17.             app.UseEndpoints(endpoints => 
    18.   
  
  
  
  18.             { 
    19.   
  
  
  
  19.                 endpoints.MapControllerRoute( 
    20.   
  
  
  
  20.                     name: "default", 
    21.   
  
  
  
  21.                     pattern: "{controller=Home}/{action=Index}/{id?}"); 
    22.   
  
  
  
  22.             }); 
    23.   
  
  
  
  23.         } 
    24.

接下来可以浏览下 /health 页面，可以看出该端口自动执行了你的 MyCustomHealthCheck 方法，如下图所示：

可视化健康检查

上面的检查策略虽然好，但并没有一个好的可视化方案，要想实现可视化的话，还需要单独下载 Nuget 包：AspNetCore.HealthChecks.UI , HealthChecks.UI.Client 和 AspNetCore.HealthChecks.UI.InMemory.Storage，命令如下：

 
 
 
 
      
  
  
  
  1. Install-Package AspNetCore.HealthChecks.UI 
    2.   
  
  
  
  2. Install-Package AspNetCore.HealthChecks.UI.Client 
    3.   
  
  
  
  3. Install-Package AspNetCore.HealthChecks.UI.InMemory.Storage 
    4.

一旦包安装好之后，就可以在 ConfigureServices 和 Configure 方法下做如下配置。

 
 
 
 
      
  
  
  
  1. public class Startup 
    2.   
  
  
  
  2.    { 
    3.   
  
  
  
  3.        // This method gets called by the runtime. Use this method to add services to the container. 
    4.   
  
  
  
  4.        public void ConfigureServices(IServiceCollection services) 
    5.   
  
  
  
  5.        { 
    6.   
  
  
  
  6.            services.AddControllersWithViews(); 
    7.   
  
  
  
  7.            services.AddHealthChecks(); 
    8.   
  
  
  
  8.            services.AddHealthChecksUI().AddInMemoryStorage(); 
    9.   
  
  
  
  9.        } 
    10.   
  
  
  
  10.  
    11.   
  
  
  
  11.        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. 
    12.   
  
  
  
  12.        public void Configure(IApplicationBuilder app, IWebHostEnvironment env) 
    13.   
  
  
  
  13.        { 
    14.   
  
  
  
  14.            
    15.   
  
  
  
  15.            app.UseRouting().UseEndpoints(config => 
    16.   
  
  
  
  16.            { 
    17.   
  
  
  
  17.                config.MapHealthChecks("/health", new HealthCheckOptions 
    18.   
  
  
  
  18.                { 
    19.   
  
  
  
  19.                    Predicate = _ => true, 
    20.   
  
  
  
  20.                    ResponseWriter = UIResponseWriter.WriteHealthCheckUIResponse 
    21.   
  
  
  
  21.                }); 
    22.   
  
  
  
  22.            }); 
    23.   
  
  
  
  23.  
    24.   
  
  
  
  24.            app.UseHealthChecksUI(); 
    25.   
  
  
  
  25.  
    26.   
  
  
  
  26.            app.UseStaticFiles(); 
    27.   
  
  
  
  27.  
    28.   
  
  
  
  28.            app.UseRouting(); 
    29.   
  
  
  
  29.  
    30.   
  
  
  
  30.            app.UseEndpoints(endpoints => 
    31.   
  
  
  
  31.            { 
    32.   
  
  
  
  32.                endpoints.MapControllerRoute( 
    33.   
  
  
  
  33.                    name: "default", 
    34.   
  
  
  
  34.                    pattern: "{controller=Home}/{action=Index}/{id?}"); 
    35.   
  
  
  
  35.            }); 
    36.   
  
  
  
  36.        } 
    37.   
  
  
  
  37.    } 
    38.

最后还要在 appsettings.json 中配一下 HealthChecks-UI 中的检查项，如下代码所示：

 
 
 
 
      
  
  
  
  1. { 
    2.   
  
  
  
  2.   "Logging": { 
    3.   
  
  
  
  3.     "LogLevel": { 
    4.   
  
  
  
  4.       "Default": "Information", 
    5.   
  
  
  
  5.       "Microsoft": "Warning", 
    6.   
  
  
  
  6.       "Microsoft.Hosting.Lifetime": "Information" 
    7.   
  
  
  
  7.     } 
    8.   
  
  
  
  8.   }, 
    9.   
  
  
  
  9.   "AllowedHosts": "*", 
    10.   
  
  
  
  10.   "HealthChecks-UI": { 
    11.   
  
  
  
  11.     "HealthChecks": [ 
    12.   
  
  
  
  12.       { 
    13.   
  
  
  
  13.         "Name": "Local", 
    14.   
  
  
  
  14.         "Uri": "http://localhost:65348/health" 
    15.   
  
  
  
  15.       } 
    16.   
  
  
  
  16.     ], 
    17.   
  
  
  
  17.     "EvaluationTimeOnSeconds": 10, 
    18.   
  
  
  
  18.     "MinimumSecondsBetweenFailureNotifications": 60 
    19.   
  
  
  
  19.   } 
    20.   
  
  
  
  20. } 
    21.

最后在浏览器中输入 /healthchecks-ui 看一下 可视化UI 长成啥样。

使用 ASP.Net Core 的 健康检查中间件 可以非常方便的对 系统资源，数据库 或者其他域外资源进行监控，你可以使用自定义检查逻辑来判断什么样的情况算是 Healthy，什么样的算是 UnHealthy，值得一提的是，当检测到失败时还可以使用失败通知机制，类似 github 发布钩子。

译文链接：https://www.infoworld.com/article/3379187/how-to-implement-health-checks-in-aspnet-core.html

本文名称：如何在 ASP.Net Core 中实现健康检查
本文网址：http://www.mswzjz.cn/qtweb/news25/28625.html

攀枝花网站建设、攀枝花网站运维推广公司-贝锐智能，是专注品牌与效果的网络营销公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 贝锐智能

贝锐智能技术为您推荐以下文章

网站排名知识

同城分类信息

特丽尔硅藻泥　　 　成都虚拟主机　　 　定制网站建设　　 　成都门户网站建设　　 　复盛机电设备　　 　微信小程序开发　　 　成都劢可为　　 　成都网站设计　　 　温江做网站　　 　小谭网创广告　　 　广西弘博建站　　 　成都网站维护　　 　微信小程序开发　　 　广告品牌策划设计　　 　攀枝花网站设计　　 　app软件开发公司　　 　中国（西部）云计算中心　　 　雅安做网站　　 　西云主机托管　　 　网站设计公司