com.alibaba.metrics

类 MetricManager

java.lang.Object

com.alibaba.metrics.MetricManager

public class MetricManager
extends Object

The design concept is heavily borrowed from SLF4j (http://www.slf4j.org/), the logging framework. The application only depends on the metrics api. The implementation will be dynamically bound. If the implementation if not found in classpath, by default the NOPMetricManager will be bound.

字段概要

字段

限定符和类型	字段和说明
static IMetricManager	NOP_METRIC_MANAGER

构造器概要

构造器

构造器和说明
MetricManager()

方法概要

限定符和类型	方法和说明
static ClusterHistogram	getClusterHistogram(String group, MetricName name) Create a ClusterHistogram metric in given group, and name if not exist, an instance will be created.
static ClusterHistogram	getClusterHistogram(String group, MetricName name, long[] buckets) Create a ClusterHistogram metric in given group, and name if not exist, an instance will be created.
static Compass	getCompass(String group, MetricName name) Create a Compass metric in given group, and name.
static Compass	getCompass(String group, MetricName name, ReservoirType type) Create a Compass metric in given group, name, and ReservoirType type.
static Counter	getCounter(String group, MetricName name) Create a Counter metric in given group, and name.
static FastCompass	getFastCompass(String group, MetricName name) Create a FastCompass metric in given group, and name if not exist, an instance will be created.
static Histogram	getHistogram(String group, MetricName name) Create a Histogram metric in given group, and name.
static Histogram	getHistogram(String group, MetricName name, ReservoirType type) Create a Histogram metric in given group, name, and ReservoirType type.
static IMetricManager	getIMetricManager() get dynamically bound IMetricManager instance
static Meter	getMeter(String group, MetricName name) Create a Meter metric in given group, and name.
static Timer	getTimer(String group, MetricName name) Create a Timer metric in given group, and name.
static Timer	getTimer(String group, MetricName name, ReservoirType type) Create a Timer metric in given group, name, and ReservoirType type.
static void	register(String group, MetricName name, Metric metric) Register a customized metric to specified group.

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

NOP_METRIC_MANAGER

public static final IMetricManager NOP_METRIC_MANAGER

构造器详细资料

MetricManager

public MetricManager()

方法详细资料

getMeter

public static Meter getMeter(String group,
                             MetricName name)

Create a Meter metric in given group, and name. if not exist, an instance will be created. 根据给定的group和name, 获取一个Meter实例，如果不存在则会创建 Meter(计量器)主要用于统计调用qps, 包括最近1min, 5min, 15min的移动平均qps

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of meter

getCounter

public static Counter getCounter(String group,
                                 MetricName name)

Create a Counter metric in given group, and name. if not exist, an instance will be created. 根据给定的group和name, 获取一个Counter实例，如果不存在则会创建 Counter(计数器), 主要用于用于计数，支持+1, -1, +n, -n等操作

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of counter

getHistogram

public static Histogram getHistogram(String group,
                                     MetricName name)

Create a Histogram metric in given group, and name. if not exist, an instance will be created. 根据给定的group和name, 获取一个Histogram实例，如果不存在则会创建 Histogram(直方图), 主要用于统计分布情况，例如调用rt分布， 能够迅速了解统计指标的最大值，最小值，平均值，方差，70%,85%,95%分位数等信息

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of histogram

getHistogram

public static Histogram getHistogram(String group,
                                     MetricName name,
                                     ReservoirType type)

Create a Histogram metric in given group, name, and ReservoirType type. if not exist, an instance will be created. 根据给定的group和name和type, 获取一个Histogram实例，如果不存在则会创建 Histogram(直方图), 主要用于统计分布情况，例如调用rt分布， 能够迅速了解统计指标的最大值，最小值，平均值，方差，70%，85%，95%分位数等信息

参数:

group - the group of MetricRegistry

name - the name of the metric

type - the type of the ReservoirType

返回:

an instance of histogram

getTimer

public static Timer getTimer(String group,
                             MetricName name)

Create a Timer metric in given group, and name. if not exist, an instance will be created. 根据给定的group和name, 获取一个Timer实例，如果不存在则会创建 Timer(计时器), 主要用于给定指标的qps, rt分布, 可以理解为Meter+Histogram 能够方便的统计某指标的qps, 和rt的最大值，最小值，平均值，方差，70%,85%,95%分位数等信息

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of timer

getTimer

public static Timer getTimer(String group,
                             MetricName name,
                             ReservoirType type)

Create a Timer metric in given group, name, and ReservoirType type. if not exist, an instance will be created. 根据给定的group, name, type, 获取一个Timer实例，如果不存在则会创建 Timer(计时器), 主要用于给定指标的qps, rt分布, 可以理解为Meter+Histogram 能够方便的统计某指标的qps, 和rt的最大值，最小值，平均值，方差，70%, 85%, 95%分位数等信息

参数:

group - the group of MetricRegistry

name - the name of the metric

type - the type of reservoir

返回:

an instance of timer

getCompass

public static Compass getCompass(String group,
                                 MetricName name)

Create a Compass metric in given group, and name. if not exist, an instance will be created. 根据给定的group和name, 获取一个Compass实例，如果不存在则会创建 Compass(罗盘), 主要用于统计给定指标的qps, rt分布，调用成功次数，以及错误码分布等信息

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of compass

getCompass

public static Compass getCompass(String group,
                                 MetricName name,
                                 ReservoirType type)

Create a Compass metric in given group, name, and ReservoirType type. if not exist, an instance will be created. 根据给定的group, name和type, 获取一个Compass实例，如果不存在则会创建 Compass(罗盘), 主要用于统计给定指标的qps, rt分布，调用成功次数，以及错误码分布等信息

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of compass

getFastCompass

public static FastCompass getFastCompass(String group,
                                         MetricName name)

Create a FastCompass metric in given group, and name if not exist, an instance will be created. 根据给定的group和name, 获取一个FastCompass实例，如果不存在则会创建 FastCompass, 主要用于在高吞吐率场景下，统计给定指标的qps, 平均rt，成功率，以及错误码等指标

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of FastCompass

getClusterHistogram

public static ClusterHistogram getClusterHistogram(String group,
                                                   MetricName name,
                                                   long[] buckets)

Create a ClusterHistogram metric in given group, and name if not exist, an instance will be created. 根据给定的group和name, 获取一个ClusterHistogram实例，如果不存在则会创建 ClusterHistogram, 主要用于集群分位数统计

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of ClusterHistogram

getClusterHistogram

public static ClusterHistogram getClusterHistogram(String group,
                                                   MetricName name)

Create a ClusterHistogram metric in given group, and name if not exist, an instance will be created. 根据给定的group和name, 获取一个ClusterHistogram实例，如果不存在则会创建 ClusterHistogram, 主要用于集群分位数统计

参数:

group - the group of MetricRegistry

name - the name of the metric

返回:

an instance of ClusterHistogram

register

public static void register(String group,
                            MetricName name,
                            Metric metric)

Register a customized metric to specified group.

参数:

group - the group name of MetricRegistry

metric - the metric to register

getIMetricManager

public static IMetricManager getIMetricManager()

get dynamically bound IMetricManager instance

返回:

the IMetricManager instance bound