Java客户端官方文档地址:https://github.com/dianping/cat/blob/master/lib/java/README.zh-CN.md
存储模型官方文档:https://github.com/dianping/cat/wiki/model
1.介绍
CAT主要支持以下四种监控模型:
Transaction 适合记录跨越系统边界的程序访问行为,比如远程调用,数据库调用,也适合执行时间较长的业务逻辑监控,Transaction用来记录一段代码的执行时间和次数
Event 用来记录一件事发生的次数,比如记录系统异常,它和transaction相比缺少了时间的统计,开销比transaction要小
Heartbeat 表示程序内定期产生的统计信息, 如CPU利用率, 内存利用率, 连接池状态, 系统负载等
Metric 用于记录业务指标、指标可能包含对一个指标记录次数、记录平均值、记录总和,业务指标最低统计粒度为1分钟
2.引入Maven依赖
<dependency>
<groupId>com.dianping.cat</groupId>
<artifactId>cat-client</artifactId>
<version>3.1.0</version>
</dependency>
3.添加拦截器
import com.dianping.cat.servlet.CatFilter;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 对URL进行拦截的类
* @author tengx
*/
@Configuration
public class CatFilterConfigure {
@Bean
public FilterRegistrationBean catFilter() {
FilterRegistrationBean registration = new FilterRegistrationBean();
CatFilter filter = new CatFilter();
registration.setFilter(filter);
registration.addUrlPatterns("/*");
registration.setName("MQTT");
registration.setOrder(1);
return registration;
}
}
添加完毕后每次请求项目接口,Cat客户端都会向Cat服务器推送一条URL记录
在Transaction、Event、Problem中均可看到
4.Transaction的使用
示例代码如下(经过测试异步代码监控不到):
@PostMapping("/message")
public void sendMessage(@RequestBody IOTMessage iotMessage) {
Transaction t = Cat.newTransaction("MQTT", "sendMessage1");
try {
Thread.sleep(1000);
t.setStatus(Transaction.SUCCESS);
} catch (Exception e) {
t.setStatus(e);
Cat.logError(e);
} finally {
t.complete();
}
Transaction t1 = Cat.newTransaction("MQTT", "sendMessage2");
try {
Thread.sleep(1000);
t1.setStatus(Transaction.SUCCESS);
} catch (Exception e) {
t1.setStatus(e);
Cat.logError(e);
} finally {
t1.complete();
}
}
请求后可以去Transaction>MQTT>Log View>Graph中查看视图,这里查看的是最近一次请求
也可以去Problem>long-url>log中查看每一次请求的视图
5.Event及Error的使用
示例代码如下:
@PostMapping("/message")
public void sendMessage(@RequestBody IOTMessage iotMessage) {
Cat.logError(new Exception("测试"));
Cat.logEvent("MQTT","sendMessage");
}
请求后在Problem中可以看到一条ERROR日志
错误也能在Dashboard中直接看到