Metric是一个第三方包,用来帮助我们对应用程序的性能进行度量。曾有友商基于这个包编写的程序还申请了专利,总之这是一个使用方便的组件。我们日常进行应用程序性能度量时,最常用的方法是打日志记录每个交易的一些耗时数据,有了这些原始数据,自己再进行统计分析。通过使用Metrics这个包,我们可以很方便的定义一些度量值,抓取一些关键时点和变量的信息,还能按照自定义的周期进行总体的统计,来分析应用的性能。Metrics还能够将这些统计信息输出到Console、日志文件、JMX,甚至还支持以微服务的方式向外暴露数据接口,从而方便我们将这些数据接入到Grafana或自己的统计分析工具中。
<dependency> <groupId>io.dropwizard.metrics</groupId> <artifactId>metrics-core</artifactId> <version>4.0.5</version> </dependency>
本文发表时,最新版本是4.1.0
使用MetricRegistry注册一个或多个metrics。如果需要多个报告,则需要声明多个MetricRegistry对象。
有两种注册方式
MetricRegistry metricRegistry = new MetricRegistry(); Meter meter1 = new Meter(); metricRegistry.register("meter1", meter1); Meter meter2 = metricRegistry.meter("meter2");
更为详细的代码示例可以参考 我的Git
Gauge能做的就是返回一个变量的瞬时值,在此基础上还提供了 RatioGauge/CachedGauge/DerivativeGauge/JmxAttributeGauge
的使用。
Meter用来度量事件并发的数量和速度。
Counter度量类型是一种特殊的Gauge度量,因为其持有的值就是一个AtomicLong,可以递增也可以递减。
Histogram度量类型用于测量一个数据流各值的统计分布。其除了能够测量最大值、最小值、平均值外,还可以测量中位数、75、90、95、98、99和99.9%等。
Histogram支持四种数据采样方式 ExponentiallyDecayingReservior, UniformReservoir, SlidingTimeWindowReservior, SlidingWindowReservior
。
Timer度量类型包含了Meter和Histogram的统计,即比率和统计信息的综合。
使用Reporter可以输出测量结果,支持 ConsoleReporter, CsvReporter, Slf4Reporter, JmxReporter
等等。
通过 metrics-healthchecks
和 metrics-servlets
模块,还能支持健康检查和微服务的数据输出,有兴趣的朋友可以继续探索。