Gauge
Gauge(仪表)是获取当前度量记录值的句柄,也就是它表示一个可以任意上下浮动的单数值度量Meter。Gauge通常用于变动的测量值,测量值用ToDoubleFunction参数的返回值设置,如当前的内存使用情况,同时也可以测量上下移动的”计数”,比如队列中的消息数量。
官网文档中提到Gauge的典型使用场景是用于测量集合或映射的大小或运行状态中的线程数。Gauge一般用于监测有自然上界的事件或者任务,而Counter一般使用于无自然上界的事件或者任务的监测,所以像Http请求总量计数应该使用Counter而非Gauge。
MeterRegistry中提供了一些便于构建用于观察数值、函数、集合和映射的Gauge相关的方法:
List list = registry.gauge(“listGauge”, Collections.emptyList(), new ArrayList<>(), List::size);
List list2 = registry.gaugeCollectionSize(“listSize2”, Tags.empty(), new ArrayList<>());
Map<String, Integer> map = registry.gaugeMapSize(“mapGauge”, Tags.empty(), new HashMap<>());
上面的三个方法通过MeterRegistry构建Gauge并且返回了集合或者映射实例,使用这些集合或者映射实例就能在其size变化过程中记录这个变更值。更重要的优点是,我们不需要感知Gauge接口的存在,只需要像平时一样使用集合或者映射实例就可以了。
此外,Gauge还支持java.lang.Number的子类,java.util.concurrent.atomic包中的Atom