NET Core微服务之基于App.Metrics+InfluxDB+Grafana实现统一性能监控

Tip:此篇已加入

.NET Core微服务基础系列文章索引

一、关于App.Metrics+InfluxDB+Grafana

1.1 App.Metrics

App.Metrics是一款开源的支持.NET Core的监控插件,它可以支持跑在.NET Framework上的应用程序(版本 >= 4.5.2)。官方文档地址:https://www.app-metrics.io/

1.2 InfluxDB

InfluxDB是一款开源的分布式时序、时间和指标数据库,使用go语言编写,无需外部依赖。官网地址:https://portal.influxdata.com

1.3 Grafana

Grafana是一个可视化面板(Dashboard),有着非常漂亮的图表和布局展示,功能齐全的度量仪表盘和图形编辑器,支持Graphite、zabbix、InfluxDB、Prometheus和OpenTSDB作为数据源。官网地址:https://grafana.com/

二、InfluxDB的安装与配置

2.1 Linux下的安装

请参考focus-lei的文章《.NET Core使用App.Metrics + InfluxDB + Grafana进行APM监控》,我这里只是做demo,所以选择了在我的Windows Server虚拟机中安装,快速一点。当然,你可以通过docker拉取influxdb的镜像创建一个容器,这样更快。

# docker pull tutm/influxdb

2.2 Windows下的安装

(1)下载Windows版本(64位),下载地址:https://dl.influxdata.com/influxdb/releases/influxdb-1.5.2_windows_amd64.zip

(2)解压之后放到你想要放置的位置,然后编辑influxdb.conf配置文件:(因为其默认配置是针对Linux的)

[meta]

# Where the metadata/raft database is stored

dir = "C:/APM/influxdb/meta"

[data]

# The directory where the TSM storage engine stores TSM files.

dir = "C:/APM/influxdb/data"

# The directory where the TSM storage engine stores WAL files.

wal-dir = "C:/APM/influxdb/wal"

(3)进入cmd,以命令模式运行influxd:

cmd >> .\influxd -config influxdb.conf

(4)然后新开一个cmd,连上influxdb,然后创建一个database

cmd >> .\influx -host 127.0.0.1 -port 8086 -username "admin" -password "edisonchou"

关于influxdb的更多命令,可以浏览参考资料关于influxdb的InfluxDB入门教程。

三、Grafana的安装与配置

2.1 Linux下的安装

同1.1部分,不再赘述。

2.2 Windows下的安装

(1)下载Windows版本(64位),下载地址:https://s3-us-west-2.amazonaws.com/grafana-releases/release/grafana-5.2.2.windows-amd64.zip

(2)直接运行grafana-server.exe即可,默认绑定3000端口号。

(3)浏览器打开serverip:3000,使用默认账号admin/admin(账号密码都是admin)登录,主界面如下图所示:

(4)为InfluxDB添加数据源

在Configuration中点击Add data source按钮,进入如下图所示的添加界面,输入你安装的InfluxDB数据库信息

(5)为Grafana添加InfluxDB的Dashboard仪表盘的JSON文件

这里有两种方式:一种是直接给URL=>https://grafana.com/dashboards/2125,另一种是我们手动下载这个URL的JSON,然后把JSON粘贴过来。

(6)导入之后,查看这个Dashboard:

四、App.Metrics的使用与API网关集成

注意:以下的配置和代码都只是在API网关(Ocelot)中做的,至于具体API服务中不需要做配置。

4.1 安装App.Metrics

通过NuGet安装以下几个package:

4.2 集成API网关

(1)添加配置文件关于InfluxDB的部分

"AppMetrics": {"IsOpen":true,"DatabaseName":"AppMetricsDB","ConnectionString":"http://192.168.80.71:8086","UserName":"admin","Password":"edisonchou","App":"MSAD","Env":"Development"}

(2)修改StartUp类,注入AppMetrics并设置

publicvoidConfigureServices(IServiceCollection services) { ......//AppMetricsboolisOpenMetrics = Convert.ToBoolean(Configuration["AppMetrics:IsOpen"]);if(isOpenMetrics) {stringdatabase = Configuration["AppMetrics:DatabaseName"];stringconnStr = Configuration["AppMetrics:ConnectionString"];stringapp = Configuration["AppMetrics:App"];stringenv = Configuration["AppMetrics:Env"];stringusername = Configuration["AppMetrics:UserName"];stringpassword = Configuration["AppMetrics:Password"];varuri =newUri(connStr);varmetrics = AppMetrics.CreateDefaultBuilder().Configuration.Configure(options =>{ options.AddAppTag(app); options.AddEnvTag(env); }).Report.ToInfluxDb(options=>{ options.InfluxDb.BaseUri=uri; options.InfluxDb.Database=database; options.InfluxDb.UserName=username; options.InfluxDb.Password=password; options.HttpPolicy.BackoffPeriod= TimeSpan.FromSeconds(30); options.HttpPolicy.FailuresBeforeBackoff=5; options.HttpPolicy.Timeout= TimeSpan.FromSeconds(10); options.FlushInterval= TimeSpan.FromSeconds(5); }).Build(); services.AddMetrics(metrics); services.AddMetricsReportScheduler(); services.AddMetricsTrackingMiddleware(); services.AddMetricsEndpoints(); } }//This method gets called by the runtime. Use this method to configure the HTTP request pipeline.publicvoidConfigure(IApplicationBuilder app, IHostingEnvironment env) { ......//AppMetricsboolisOpenMetrics = Convert.ToBoolean(Configuration["AppMetrics:IsOpen"]);if(isOpenMetrics) { app.UseMetricsAllEndpoints(); app.UseMetricsAllMiddleware(); }//Ocelotapp.UseOcelot().Wait(); }

五、运行效果展示

这时我们把API网关、ClientService和ProductService同时启动起来,然后通过浏览器不停的请求这两个服务的某个API接口。

请求一段时间后,我们进入Grafana的Dashboard来查看:

可以看到,原本空荡荡的仪表盘已经满血复活,各种曲线和数据出来了。这里Error有数据是因为我的程序中有bug,出现了异常。

我们也也可以设置Grafana的Alerting设置,让其可以为我们发送告警邮件(可以选择Include Image),当然你事先得改一下Grafana的配置文件,贴上你的SMTP服务器和账号密码信息。

六、小结

本篇首先简单介绍了一下App.Metrics、InfluxDB与Grafana,然后介绍了如何安装和配置这套开源监控组合,最后通过与API网关Ocelot的集成,让我们的ASP.NET Core程序可以跑在监控平台之下,并可以通过Grafana的Dashboard实时查看性能数据。当然,本篇只是一个简单的Quick Start,很多细节没有深究,有兴趣的园友可以通过参考资料去仔细研究。

参考资料

(1)顾镇印,《ASP.NET Core之跨平台的实时监控》

(2)老衲平僧,《InfluxDB+Grafana+AppMetrics监控系统》

(3)landon,《.NET Core 2.0+InfluxDB+Grafana+AppMetrics实现跨平台的实时性能监控》

(4)focus-lei,《.net core使用App.Metrics+InfluxDB+Grafana进行APM监控》

(5)桂素伟,《Ocelot监控》

(6)仰望星空脚踏实地,《InfluxDB入门教程》

(7)JackyRoc,《InfluxDB使用说明》

(3)InfluxDB官方文档:http://docs.influxdata.com/influxdb/v1.6/

  • 发表于:
  • 原文链接:https://kuaibao.qq.com/s/20180729G0NCW800?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。

扫码关注云+社区

领取腾讯云代金券