部署点评Cat监控项目(转)
原文地址:http://www.bubuko.com/infodetail-986338.html
在项目中监控代码运行的状况,可以采用点评的Cat项目来监控整个项目,但是按照官方的文档来部署cat,总会遇到各种问题,讲解的也不够简明清楚,现在用一个单机来部署运行cat监控项目。
首先,到项目的git网页下载整个项目:
https://github.com/dianping/cat
接着就是进入这个项目的目录,运行打包安装命令:
mvn clean install -DskipTests (需要maven)
执行完成后,运行 CAT 安装插件命令:
mvn cat:install
会提示输入mysql数据库的连接信息,账户和密码。可能会提示缺少\data\appdatas\cat 目录,手动添加就可以了。
最后进入cat-home目录:cd cat-home,运行mvn jetty:run
没有任何错误的提示就可以启动了。在浏览器输入地址:
localhost:2281会进入界面,这个界面有说明文档还要演示效果等,没什么用,关掉。
进入项目,拷贝/cat-home/target/cat-alpha-1.3.6-SNAPSHOT.war这个文件到tomcat的webapps里面,修改名字成:cat.war。在tomcat所在的盘根目录需要有data文件夹,里面有:
\data\appdatas\cat和\data\applogs\cat 文件夹,没有的话就手动创建。
\data\appdatas\cat文件夹里面的内容在mvn cat:install这个步骤会自动创建出来client.xml、datasources.xml和server.xml三个文件,datasources.xml是数据库连接信息,不用改变的话就无需修改,client.xml和server.xml两个文件里,有多少台服务器,就要写多少台服务器的地址上去。由于我是在本机上做实验,所以就只有一台机器的地址。
client.xml文件只需改红色框内的内容就可以了:
server.xml文件改红色框的内容,有多台机器,就像红框下面注释的那样改就可以了。
修改完,启动tomcat(bin\startup.bat)
没有任何问题,我们可以根据提示在\data\applogs\cat目录中查看到日志。
在浏览器里面输入http://localhost:8080/cat/r,可以看到CAT下面部署后的界面。左上角的“实时”功能才是我们最需要的!
点击后发现都是demo的实例,可以查看相应的代码来学习怎么使用。
在项目的home模块里面的test部分,有个com.dianping.cat.demo.TestStorageMessage类,里
面的代码在我们的界面都可以找到对应的效果。
如sendSQLMsg这个方法,在界面的“Event”监控功能中,会发现监控的名字和方法。
private void sendSQLMsg(String name, String domain, String method, String serverIp) throws InterruptedException { Transaction t = Cat.newTransaction("SQL", "sql.method"); Cat.logEvent("SQL.Method", method); Cat.logEvent("SQL.Database", String.format(JDBC_CONNECTION, serverIp, name)); MessageTree tree = Cat.getManager().getThreadLocalMessageTree(); ((DefaultMessageTree) tree).setDomain(domain); Thread.sleep(500 + new Random().nextInt(1000)); int nextInt = new Random().nextInt(3); if (nextInt % 2 == 0) { t.setStatus(Transaction.SUCCESS); } else { t.setStatus(String.valueOf(nextInt)); } t.complete(); }
对应代码里面的这两行名称:
Cat.logEvent("SQL.Method", method); Cat.logEvent("SQL.Database", String.format(JDBC_CONNECTION, serverIp, name));
因此,我们可根据这个很容易地学习怎么使用。因为Cat项目已经启动了,整个机器都在监控的范围内,编写的项目有指定受cat项目监控便可实现实时监控,分析我们代码的执行效果了。
新建一个工程,在工程里面加入cat-home\target\cat-home-1.3.6-SNAPSHOT\WEB-INF\lib里面的所有jar包,暂时不知道哪些有用,哪些没用,所以全部加入工程中是没错的了。
在工程里面编写一个类,内容如下:
public class MyTest { public static void main(String[] args) { Transaction t = Cat.newTransaction("TEST", "test.method"); Cat.logEvent("Method_test", "good"); Cat.logEvent("Method_event", "bad"); int nextInt = new Random().nextInt(3); if (nextInt % 2 == 0) { t.setStatus(Transaction.SUCCESS); } else { t.setStatus(String.valueOf(nextInt)); } t.complete(); } }
运行,发现很快就结束了!输入提示看日志。
打开日志,发现有如下提示:
[07-20 22:05:34.780] [INFO] [DefaultModuleContext] Starting thread(Cat-ModelService-0) ... [07-20 22:10:08.922] [INFO] [DefaultModuleContext] Starting thread(Cat-ModelService-1) ... [07-20 22:20:00.677] [INFO] [DefaultModuleContext] Current working directory is C:\hadoop_java [07-20 22:20:00.699] [INFO] [DefaultClientConfigManager] Global config file(\data\appdatas\cat\client.xml) found. [07-20 22:20:00.700] [INFO] [DefaultClientConfigManager] Can't find app.properties in /META-INF/app.properties [07-20 22:20:00.711] [WARN] [DefaultTransportManager] CAT was DISABLED due to not initialized yet!
提示很明白,就是没有app.properties这个文件,在项目的说明文档里面也有说到,这个文档主要是指定监控的Cat项目的。因为我们的监控项目改为了cat.war来启动了,所以就在源代码的目录下添加META-INF文件夹,里面添加app.properties这个文件,内容就是很简单的:
app.name=cat
这个名称和浏览器里面的domain对应,如果要改成其他名称,那么这个domain的值也要改成对应的名称。
注意:META-INF文件夹必须改为源文件的指定格式的。
再次运行代码,有如下效果,程序不会自动关闭了,说明在监控中……
查看日志,一切正常:
[07-20 22:25:58.541] [INFO] [ChannelManager] Connected to CAT server at /127.0.0.1:2280 [07-20 22:25:58.543] [INFO] [ChannelManager] success when init CAT server, new active holderactive future :/127.0.0.1:2280 index:0 ip:127.0.0.1 server config:null [07-20 22:25:58.545] [INFO] [DefaultModuleContext] Thread group(cat) created. [07-20 22:25:58.546] [INFO] [DefaultModuleContext] Starting thread(cat-TcpSocketSender-ChannelManager) ... [07-20 22:25:58.546] [INFO] [DefaultModuleContext] Starting thread(cat-TcpSocketSender) ... [07-20 22:25:58.547] [INFO] [DefaultModuleContext] Starting thread(cat-merge-atomic-task) ... [07-20 22:25:58.557] [INFO] [DefaultModuleContext] Starting thread(cat-StatusUpdateTask) ...
刷新cat页面,发现新建了一个Transaction
和两个event事件了!
到此,应用cat实时监控系统部署成功,剩下的事情就是慢慢研究代码怎么更好地使用Cat了!
==========================================================
有时会发现实时监控页面什么数据都没有显示了,查看日志记录,会发现一大堆找不到10.0.0.1:2280的错误:
这需要我们点击右上角的登陆,用账号和密码都是catadmin来登陆,在“配置”的最后一项“全局告警配置”的“客户端路由”里面改为127.0.0.1:2280后,提交刷新实时页面,数据又回来了!
<?xml version="1.0" encoding="utf-8"?> <router-config backup-server="127.0.0.1" backup-server-port="2280"> <default-server id="127.0.0.1" port="2280" enable="true" weight="1.0"/> </router-config>