Metrics 简介

本文目录

1 Metric Registry

2 Reporter

3 Metric

4 Snapshot 数据快照

5 完整示例代码

---

 

1 Metric Registry

存放所有Metrics的容器，以Name-Metric（Key-Value）形式维护其中的Metric对象。

 

2 Reporter

定期将Metric Registry对象发送至监控服务器，即定期将其中存放的所有Metric对象发送给监控服务器。

 

3 Metric

3.1 Gauge/RatioGauge 数值/比率

gauge.getValue()

获取数值

 

gauge.getRatio()

获取比率

 

3.2 Counter 计数

counter.inc()

增加1次

 

counter.inc(long n)

增加n次

 

counter.dec()

减少1次

 

counter.dec(long n)

减少n次

 

counter.getCount()

获取当前次数

 

3.3 Meter 频率

meter.mark()

记录1次

 

meter.mark(long n)

记录n次

 

meter.getCount()

自创建Meter时起，一共mark多少次；

 

meter.getMeanRate()

自创建Meter时起，平均每秒mark多少次；

 

meter.getOne/Five/FifteenMinuteRate()

最近1/5/15分钟，每秒mark的指数加权移动平均值；

 

3.4 Histogram 统计数据

histogram.update(int/long n)

增加一个n值记录

 

histogram.getCount()

获取记录总个数

 

histogram.getSnapshot()

获取当前快照

 

3.5 Timer 计时（Meter+ Histogram）

Context ctx = timer.time()

开始计时

 

ctx.stop()

结束计时，记录1次，增加一个计时值记录；

内部：meter.mark() + histogram.update(time)

 

timer.update(long duration, TimeUnit unit)

记录1次，增加一个计时值duration记录，单位由unit指定；

 

timer.getCount/getMeanRate/getOne/Five/FifteenMinuteRate()

详见Meter对应方法

 

timer.getSnapshot()

获取当前快照

 

4 Snapshot 数据快照

snapshot.size()

获取记录总个数

 

snapshot.getValues()

获取记录数组

 

snapshot.getValue(double quantile)

获取指定百分位记录值

 

snapshot.getMin/Max/Median/Mean()

获取其中最小值/最大值/中位值/平均值

 

snapshot.get75/95/98/99/999thPercentile()

获取75/95/98/99/99.9百分位记录值

 

5 完整示例代码

public static void main(String[] args) {

  // 创建 Metric Registry 对象
  MetricRegistry registry = new MetricRegistry();

  // 创建 Reporter 并绑定 Metric Registry 对象（本示例：创建一个控制台Reporter）
  ConsoleReporter reporter = ConsoleReporter.forRegistry(registry).build();
  // 定期将 Metric Registry 对象内容发送至监控服务器（本示例：发送至控制台）
  reporter.start(5, TimeUnit.SECONDS);

  // 模拟一群玩家
  final Set