Java Metric使用介绍1

Metrics是一个给JAVA提供度量工具的包,在JAVA代码中嵌入Metrics代码,可以方便的对业务代码的各个指标进行监控,同一时候,Metrics可以非常好的跟Ganlia、Graphite结合,方便的提供图形化接口。

         以下简介下Metrics怎样使用。

Maven地址:

仅仅须要添加metrics-core就可以使用

    <dependency>

        <groupId>com.yammer.metrics</groupId>

        <artifactId>metrics-core</artifactId>

        <version>2.2.0</version>

    </dependency>

 

源文档 <​​http://metrics.codahale.com/getting-started/​​>

 

以下通过一些測试代码介绍Metrics每一个组件的使用,比較简单,基本看代码就懂了,这里不做过多介绍,请结合​​http://metrics.codahale.com/getting-started/​​介绍一起看,这里相当于完好代码。

Gauges

最简单的度量指标,每次相当于重置这个值。



package com.alibaba.cxf.test.metric;

import java.util.LinkedList;
import java.util.Queue;
import java.util.concurrent.TimeUnit;

import com.yammer.metrics.Metrics;
import com.yammer.metrics.core.Counter;
import com.yammer.metrics.core.Gauge;
import com.yammer.metrics.reporting.ConsoleReporter;

/**
* TODO
* @author scutshuxue.chenxf
*/
public class TestGauges {
public static Queue<String> queue = new LinkedList<String>();

public static void main(String[] args) throws InterruptedException{
ConsoleReporter.enable(5,TimeUnit.SECONDS);

Gauge<Integer>g = Metrics.newGauge(TestGauges.class, "pending-jobs", newGauge<Integer>() {
@Override
public Integer value() {
return queue.size();
}
});
queue.add("ssss");
System.out.println(g.value());
while(true){
Thread.sleep(1000);
}
}
}



运行效果例如以下:



12-12-20 14:48:53==============================================================
com.alibaba.cxf.test.metric.TestGauges:
pending-jobs:
value = 1



 


 

代码中都添加了ConsoleReporter.enable(1, TimeUnit.SECONDS);语句,通过这个命令,能够每秒钟将度量指标打印在屏幕上,理解起来会有更清楚的理解。

 

Counter,计数器



package com.alibaba.cxf.test.metric;

import java.util.LinkedList;
import java.util.Queue;
import java.util.concurrent.TimeUnit;

import com.yammer.metrics.Metrics;
import com.yammer.metrics.core.Counter;
import com.yammer.metrics.reporting.ConsoleReporter;

/**
* TODO
* @author scutshuxue.chenxf
*/
public class TestCounter {

private final Counter pendingJobs = Metrics.newCounter(TestCounter.class, "pending-jobs");
private final Queue<String> queue = new LinkedList<String>();

public void add(Stringstr) {
pendingJobs.inc();
queue.offer(str);
}

public String take() {
pendingJobs.dec();
return queue.poll();
}
/**
* TODO
* @author scutshuxue.chenxf
* @param args
* void
* @throws InterruptedException
*/
public static void main(String[]args) throws InterruptedException {
// TODOAuto-generated method stub
TestCounter tc =new TestCounter();
ConsoleReporter.enable(1,TimeUnit.SECONDS);
while(true){
tc.add("1");
Thread.sleep(1000);
}
}

}



 


效果例如以下:



12-12-20 14:48:53==============================================================
com.alibaba.cxf.test.metric.TestGauges:
pending-jobs:
value = 1



 


Meters

Meters会将近期1分钟,5分钟,15分钟的TPS(每秒处理的request数)给打印出来,还有全部时间的TPS。



 

package com.alibaba.cxf.test.metric;

import java.util.concurrent.TimeUnit;

import com.yammer.metrics.Metrics;
import com.yammer.metrics.core.Meter;
import com.yammer.metrics.reporting.ConsoleReporter;

/**
* TODO
* @author scutshuxue.chenxf
*/
public class TestMeters {
private static Meter meter = Metrics.newMeter(TestMeters.class, "requests","requests", TimeUnit.SECONDS);

public static void main(String[] args) throws InterruptedException{
ConsoleReporter.enable(1,TimeUnit.SECONDS);
while(true){
meter.mark();
meter.mark();
Thread.sleep(1000);
}
}
}



效果例如以下:



12-12-20 15:02:50==============================================================
com.alibaba.cxf.test.metric.TestMeters:
requests:
count = 20
mean rate = 2.20requests/s
1-minute rate = 2.00requests/s
5-minute rate = 2.00requests/s
15-minute rate = 2.00requests/s



Histograms 直方图

最大值,最小值,平均值,方差,中位值,百分比数据,如75%,90%,98%,99%的数据在哪个范围内。



 

package com.alibaba.cxf.test.metric;

import java.util.concurrent.TimeUnit;

import com.yammer.metrics.Metrics;
import com.yammer.metrics.core.Histogram;
import com.yammer.metrics.reporting.ConsoleReporter;

/**
* TODO
* @author scutshuxue.chenxf
*/
public class TestHistograms {
private static Histogram histo = Metrics.newHistogram(TestHistograms.class,"histo-sizes");

/**
* TODO
* @author scutshuxue.chenxf
* @param args
* void
* @throws InterruptedException
*/
public static void main(String[] args) throws InterruptedException {
// TODOAuto-generated method stub

ConsoleReporter.enable(1,TimeUnit.SECONDS);
int i=0;
while(true){
histo.update(i++);
Thread.sleep(1000);
}
}

}



效果例如以下:

com.alibaba.cxf.test.metric.TestHistograms:
histo-sizes:
min = 0.00
max = 5.00
mean = 2.50
stddev = 1.87
median = 2.50
75% <= 4.25
95% <= 5.00
98% <= 5.00
99% <= 5.00
99.9% <= 5.00




Timers

时间统计



package com.alibaba.cxf.test.metric;

import java.util.Random;
import java.util.concurrent.TimeUnit;

import com.yammer.metrics.Metrics;
import com.yammer.metrics.core.Timer;
import com.yammer.metrics.core.TimerContext;
import com.yammer.metrics.reporting.ConsoleReporter;

/**
* TODO
* @author scutshuxue.chenxf
*/
public class TestTimers {
private static Timer timer = Metrics.newTimer(TestTimers.class, "responses", TimeUnit.MILLISECONDS,TimeUnit.SECONDS);
/**
* TODO
* @author scutshuxue.chenxf
* @param args
* void
* @throws InterruptedException
*/
public static voidmain(String[] args) throws InterruptedException {
// TODOAuto-generated method stub
ConsoleReporter.enable(2,TimeUnit.SECONDS);
Random rn = newRandom();
timer.time();
System.out.println();
while(true){
TimerContextcontext = timer.time();

Thread.sleep(rn.nextInt(1000));
context.stop();
}
}

}



效果例如以下:



com.alibaba.cxf.test.metric.TestTimers:
responses:
count = 26
mean rate = 2.15calls/s
1-minute rate = 1.70calls/s
5-minute rate = 1.62calls/s
15-minute rate = 1.61calls/s
min = 35.47ms
max = 878.76ms
mean = 462.50ms
stddev = 284.91ms
median = 419.90ms
75% <=764.13ms
95% <=877.76ms
98% <=878.76ms
99% <=878.76ms
99.9% <=878.76ms



 

Health Checks

健康检查,如心跳:



 

package com.alibaba.cxf.test.metric;

import java.util.Map;
import java.util.Map.Entry;
import java.util.Random;
import java.util.concurrent.TimeUnit;

import com.yammer.metrics.HealthChecks;
import com.yammer.metrics.core.HealthCheck;
import com.yammer.metrics.reporting.ConsoleReporter;

public class DatabaseHealthCheck extends HealthCheck {
private static Databasedatabase;
private static final Map<String, Result> results = HealthChecks.runHealthChecks();

public DatabaseHealthCheck(Databasedatabase) {
super("database");
this.database =database;
}

@Override
public Result check()throws Exception {

if(database.isConnected()) {
returnResult.healthy();
} else {
return Result.unhealthy("Cannotconnect to database" );
}
}

public static void main(String[] args) throws Exception{
Database db = new Database();
DatabaseHealthCheck checkHealth = new DatabaseHealthCheck(db);
HealthChecks.register(checkHealth);

while(true){
Map<String,Result> results = HealthChecks.runHealthChecks();
for(Entry<String, Result> entry : results.entrySet()) {
if (entry.getValue().isHealthy()) {
System.out.println(entry.getKey() +" is healthy");
} else {
System.err.println(entry.getKey() +" is UNHEALTHY: " + entry.getValue().getMessage());
}
}
Thread.sleep(1000);
}
}
}
class Database{
static Random rn = newRandom();

public booleanisConnected() {
// TODOAuto-generated method stub
returnrn.nextBoolean();
}

}



效果例如以下:



com.alibaba.cxf.test.metric.TestTimers:
responses:
count = 26
mean rate = 2.15calls/s
1-minute rate = 1.70calls/s
5-minute rate = 1.62calls/s
15-minute rate = 1.61calls/s
min = 35.47ms
max = 878.76ms
mean = 462.50ms
stddev = 284.91ms
median = 419.90ms
75% <=764.13ms
95% <=877.76ms
98% <=878.76ms
99% <=878.76ms
99.9% <=878.76ms