Metrics.NET源码阅读笔记

概述

Metrics.NET提供的是度量工具，他是移植自Java的metrics。Metrics将度量抽象成Gauges，Counters，Histograms,Meters,Timers五种。基于这五种度量类型，我们能够向系统中添加计数代码来统计监视应用程序的即时或准即时运行性能。

通过Metrics的Report机制，我们可以比较方便地将这些度量值输送到其他的监控系统解决方案中。这样可以很方便地集成成熟的数据可视化，系统异常报警解决方案。

启动入口

Metric静态类提供了Metrics.NET的主要操作入口，构建一个控制台应用程序或者ASP.NET MVC项目，在应用程序入口（Program.Main | MvcApplication Application_Start）通过以下简单代码即可以构建一个简单的监控数据采集程序。

Metric.Config
    .WithHttpEndpoint("http://localhost:1234/")
    .WithAllCounters();

.WithHttpEndpoint("http://localhost:1234/")提供一个内置的基于Http的web ui，可以使用http://localhost:1234/来访问收集到的度量指标的即时状态。

.WithAllCounters()注册了内部实现的一些性能监视指标，其实它是由两部分构成的：.WithSystemCounters()和.WithAppCounters。这个方法是由一个PerformanceCountersConfigExtensions的扩展类提供的。

度量指标的分组

如果一个系统的度量指标越来越多的话，那么想要查看一个度量指标会变得非常尴尬。基于Metrics.NET解决这个问题有很两种方案可选，或者可以混合使用它们：

1. Metric Contexts 度量上下文
2. Tags 标签

主要接口描述

度量上下文，Metric静态类内保持着一个全局的度量上下文（GlobalContext），使用Metric静态类直接注册的度量指标都是注册到GlobalContext中。

Metric.Context 可以创建GlobalContext的子上下文，如果已经有同名的子上下文，则不创建并返回已存在的上下文。

Metric.ShutdownContext 移除GlobalContext的子上下文。

Metric.Gauge、Metric.PerformanceCounter、Meter、Counter、Histogram、Timer 注册各种类型的度量指标

度量类型

Gauges 

Gauge是最简单的度量类型，存储了一个double类型的值，所以一般用它记录系统的一些即时值，比如最近的一次的内存占用或者是系统CPU百分比。

Counters

Counter顾名思义是计数器的意思，用于存储一个64位长计数器，由应用系统的代码逻辑控制Counter的自增或自减。而且该计数器是支持明细计数的，Counter保持一个总的计数，并且保持一个子项的计数明细数组。

计数器可以用来记录当前系统的并发数。在进入调用时计数器自增，退出之前自减。并且还可以支持使用一个Counter实现针对各个接口进行明细统计。

Histograms

Histogram直方图，度量流数据中Value的分布情况，将会计算最大/最小、平均值、方差、分位数（75%，90%，98%，99%的数据在哪个范围）。例如可以统计每一个POST请求中的内容的大小或者处理所花的时间。

Meters

Meter度量的是事件在一定单位时间内发生的次数。比如单位时间内事件发生的平均次数，或者1分钟、5分钟或15分钟内发生次数的滑动平均值。可以使用Meter统计异常发生的频率。

Timers

Timer是Histogram跟Meter的一个组合，他在Meter的基础上，增加了对处理耗时的Histogram的度量，并且他还度量了一个ActiveSession的值，他代表了一个并发数。Timer是五种度量里最复杂的度量类型。

健康检查

HealthChecks静态类提供了健康检查的功能。通过HealthChecks可以注册很多应用程序的各种依赖资源是否正常运作。比如网络是否连通，硬盘空间是否足够等等。

Report报告

Report是将Metric的度量数据导出的功能，内部实现了Console、CSVFile等的报告导出。也支持定制，并且实现比较简单，可以非常方便的实现将Metric的度量数据导出到第三方的监控系统中。

参考

使用Metrics.NET 构建 ASP.NET MVC 应用程序的性能指标

https://github.com/etishor/Metrics.NET