1. 源代碼下載
登陸碼雲或者github把CAT代碼down到本地,碼雲下載地址:https://gitee.com/mirrors/CAT/tags
圖片.png
2. 代碼導入idea
導入後maven會自動下載相關依賴,導入後效果如下:
圖片.png
3. 初始化數據庫並修改配置文件
- CAT數據存儲於MySQL數據庫script文件夾下面的Cat.sql 導入Mysql 數據庫,版本要求5.7+
-
修改datasources.xml配置文件,將數據庫鏈接替換成自己的數據庫配置
圖片.png
4. 源代碼編譯
點擊如下圖所示按鈕,並輸入命令clean install -Dmaven.test.skip=true
編譯打成war包
圖片.png
5. war包部署
將編譯後的war包部署到tomcat 下,注意:暫不啓動
6. 本地配置文件創建
在項目部署所在目錄的根目錄創建/data/appdatas/cat文件夾,例如我項目部署在C:\tools\apache-tomcat-8.0.9,那麼創建好的目錄結構就應該是:C:\data\appdatas\cat
並將script文件夾中的3個xml配置文件複製粘貼到剛創建好的目錄下
7. 啓動tomcat並測試
若顯示如下畫面,表示服務端配置成功
下面是CAT 客戶端集成步驟:
本次集成工程爲spring boot2 工程,集成步驟如下:
- 集成POM文件
在pom.xml中引入CAT 客戶端包<dependency> <groupId>com.dianping.cat</groupId> <artifactId>cat-client</artifactId> <version>2.0.0</version> </dependency>
若maven編譯不通過,找不到該包,則需要手動安裝到本地,手動安裝步驟爲
1.去idea 圖片目錄找到cat-client-2.0.0.jar ,並複製到本地目錄圖片.png
2.進入到jar包複製目錄的文件夾下面,並執行
mvn install:install-file -DgroupId=com.dianping.cat -DartifactId=cat-client -Dversion=2.0.0 -Dpackaging=jar -Dfile=cat-client-2.0.0.jar
- 官方文檔中只體現了集成spring mvc 客戶端的方式,現修改爲spring boot 2的方式,方式如下:添加過濾器
/**
* Cat 過濾器初始化
*/
public class CatFilterConfigure{
@Bean
public FilterRegistrationBean catFilter() {
FilterRegistrationBean registration = new FilterRegistrationBean();
CatFilter filter = new CatFilter();
registration.setFilter(filter);
registration.addUrlPatterns("/*");
registration.setName("cat-filter");
registration.setDispatcherTypes(DispatcherType.REQUEST,DispatcherType.FORWARD);
registration.setOrder(1);
return registration;
}
}
- 添加客戶端配置類,代碼如下:
/**
* Cat客戶端配置
*/
public class CatClientConfigProvider implements ClientConfigProvider {
@Override
public ClientConfig getClientConfig() {
ClientConfig config = new ClientConfig();
config.addServer(new Server("127.0.0.1"));
config.addDomain(new Domain("Tunny"));
return config;
}
}
-
添加resourece 目錄配置文件,目錄結構及配置如下:
圖片.png
-
編寫客戶端埋點代碼,註釋寫的比較詳細,代碼結構如下:
圖片.png
-
啓動客戶端服務,並調用埋點所在Controller接口
-
埋點效果測試,登陸cat服務端
效果如下,表示客戶端與服務端通信正常圖片.png
=============================================================================================
1:配置文件添加cat服務地址
2:導入自定義 cat-client
3:添加resources/META-INF/app.properties