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的部分
2
3
4
5
6
7
8
9
10
2 "IsOpen": true,
3 "DatabaseName": "AppMetricsDB",
4 "ConnectionString": "http://192.168.80.71:8086",
5 "UserName": "admin",
6 "Password": "edisonchou",
7 "App": "MSAD",
8 "Env": "Development"
9 }
10
（2）修改StartUp类，注入AppMetrics并设置
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
2 {
3 ......
4
5 // AppMetrics
6 bool isOpenMetrics = Convert.ToBoolean(Configuration["AppMetrics:IsOpen"]);
7 if (isOpenMetrics)
8 {
9 string database = Configuration["AppMetrics:DatabaseName"];
10 string connStr = Configuration["AppMetrics:ConnectionString"];
11 string app = Configuration["AppMetrics:App"];
12 string env = Configuration["AppMetrics:Env"];
13 string username = Configuration["AppMetrics:UserName"];
14 string password = Configuration["AppMetrics:Password"];
15
16 var uri = new Uri(connStr);
17 var metrics = AppMetrics.CreateDefaultBuilder().Configuration.Configure(options =>
18 {
19 options.AddAppTag(app);
20 options.AddEnvTag(env);
21 }).Report.ToInfluxDb(options =>
22 {
23 options.InfluxDb.BaseUri = uri;
24 options.InfluxDb.Database = database;
25 options.InfluxDb.UserName = username;
26 options.InfluxDb.Password = password;
27 options.HttpPolicy.BackoffPeriod = TimeSpan.FromSeconds(30);
28 options.HttpPolicy.FailuresBeforeBackoff = 5;
29 options.HttpPolicy.Timeout = TimeSpan.FromSeconds(10);
30 options.FlushInterval = TimeSpan.FromSeconds(5);
31 }).Build();
32
33 services.AddMetrics(metrics);
34 services.AddMetricsReportScheduler();
35 services.AddMetricsTrackingMiddleware();
36 services.AddMetricsEndpoints();
37 }
38 }
39
40 // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
41 public void Configure(IApplicationBuilder app, IHostingEnvironment env)
42 {
43 ......
44
45 // AppMetrics
46 bool isOpenMetrics = Convert.ToBoolean(Configuration["AppMetrics:IsOpen"]);
47 if (isOpenMetrics)
48 {
49 app.UseMetricsAllEndpoints();
50 app.UseMetricsAllMiddleware();
51 }
52
53 // Ocelot
54 app.UseOcelot().Wait();
55 }
56
五、运行效果展示
这时我们把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使用说明》
（8）InfluxDB官方文档：http://docs.influxdata.com/influxdb/v1.6/
