坑1:
部署cat的服務器蟀悦,時間一定要正確,不然有可能會報500(就是那個兩小時內(nèi)的無法訪問尸折,兩小時前的才正常訪問)。并且時間正確的話缕贡,看dashboard顯示的時間才對翁授。
坑2:
打包過程注意依賴即可,只要刷新maven沒有錯晾咪,基本都是打包正常收擦,如果還是失敗,看看失敗原因谍倦,有可能是網(wǎng)絡問題下載某些包失敗塞赂,要把本地倉庫的對應包對應版本的目錄刪除(也就是刪除lastupdate),重新打包即可 mvn clean install -DskipTests昼蛀。如果某些包沒法下載宴猾,是因為沒有上傳到中央倉庫,可以到cat的github那里選擇mvn-repo分支拉取下來叼旋,把里面的包復制到本地倉庫
坑3:
網(wǎng)上的教程仇哆,都是大同小異,沒有說清楚配置夫植,就是說要創(chuàng)建client.xml和datasources.xml讹剔,因為官網(wǎng)也是這樣的步驟油讯,但這種情況的話,是cat和你的程序都在同一個環(huán)境下才這樣延欠,如果cat和程序不在同一個環(huán)境下陌兑,就不是這樣配置了。例如docker創(chuàng)建一個tomcat容器由捎,cat部署上去兔综,springboot項目是本地開發(fā),直接run的狞玛,這樣就不在同一個環(huán)境软驰,下面記錄一下怎么配置
docker run -d -p 8080:8080 -p 2280:2280 --name tomcat -e TZ="Asia/Shanghai" -v /xxx/myDocker/tomcat/webapps/:/usr/local/tomcat/webapps/ -v /xxx/myDocker/tomcat/logs/:/usr/local/tomcat/logs/ -v /etc/localtime:/etc/localtime -v /xxx/myDocker/tomcat/data/:/data/ tomcat:9.0
然后把war包放進webapps目錄,在data目錄下創(chuàng)建appdatas/cat和applogs/cat为居,在appdatas/cat下創(chuàng)建datasources.xml
<?xml version="1.0" encoding="utf-8"?>
<data-sources>
<data-source id="cat">
<maximum-pool-size>3</maximum-pool-size>
<connection-timeout>1s</connection-timeout>
<idle-timeout>10m</idle-timeout>
<statement-cache-size>1000</statement-cache-size>
<properties>
<driver>com.mysql.jdbc.Driver</driver>
<url><![CDATA[jdbc:mysql://mysql地址:3306/cat]]></url> <!-- 請?zhí)鎿Q為真實數(shù)據(jù)庫URL及Port -->
<user>root</user> <!-- 請?zhí)鎿Q為真實數(shù)據(jù)庫用戶名 -->
<password>root</password> <!-- 請?zhí)鎿Q為真實數(shù)據(jù)庫密碼 -->
<connectionProperties><![CDATA[useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&autoReconnect=true&socketTimeout=120000]]></connectionProperties>
</properties>
</data-source>
</data-sources>
這里的配置根據(jù)情況修改碌宴,數(shù)據(jù)庫名,賬號密碼蒙畴,連接參數(shù)
到這里贰镣,cat服務就可以了,不需要client.xml的膳凝,另外注意一下修改data目錄的讀寫權限碑隆,chmod -R 777 /xxx/myDocker/tomcat/data/
現(xiàn)在可以啟動tomcat容器,cat就可以訪問了蹬音,一般沒有其他問題上煤,有問題再查吧。
這個時候雖然cat能訪問著淆,但不能正常工作劫狠,需要改一下配置(都是跟著官方文檔做的,為什么要這樣做還不清楚)
進入config(或http://{ip:port}/cat/s/config?op=serverConfigUpdate)
進入全局系統(tǒng)配置-服務端配置
<?xml version="1.0" encoding="utf-8"?>
<server-config>
<server id="default">
<properties>
<property name="local-mode" value="false"/>
<property name="job-machine" value="false"/>
<property name="send-machine" value="false"/>
<property name="alarm-machine" value="false"/>
<property name="hdfs-enabled" value="false"/>
<property name="remote-servers" value="192.168.宿主:8080"/>
</properties>
<storage local-base-dir="/data/appdatas/cat/bucket/" max-hdfs-storage-time="15" local-report-storage-time="7" local-logivew-storage-time="7" har-mode="true" upload-thread="5">
<hdfs id="logview" max-size="128M" server-uri="hdfs://10.1.77.86/" base-dir="user/cat/logview"/>
<hdfs id="dump" max-size="128M" server-uri="hdfs://10.1.77.86/" base-dir="user/cat/dump"/>
<hdfs id="remote" max-size="128M" server-uri="hdfs://10.1.77.86/" base-dir="user/cat/remote"/>
</storage>
<consumer>
<long-config default-url-threshold="1000" default-sql-threshold="100" default-service-threshold="50">
<domain name="cat" url-threshold="500" sql-threshold="500"/>
<domain name="OpenPlatformWeb" url-threshold="100" sql-threshold="500"/>
</long-config>
</consumer>
</server>
<server id="192.168.宿主">
<properties>
<property name="job-machine" value="true"/>
<property name="alarm-machine" value="true"/>
<property name="send-machine" value="true"/>
</properties>
</server>
</server-config>
修改這兩個地址為宿主機ip即可(網(wǎng)絡偏好設置ip)永部,沒有用到hdfs独泞,ip不用管,另外注意本地節(jié)點的角色苔埋,job-machine&alarm-machine都可以配置為true懦砂,以便于debug。
全局系統(tǒng)配置-客戶端路由组橄,同理荞膘,4處ip修改為宿主機ip
<?xml version="1.0" encoding="utf-8"?>
<router-config backup-server="192.168.宿主" backup-server-port="2280">
<default-server id="192.168.宿主" weight="1.0" port="2280" enable="true"/>
<network-policy id="default" title="default" block="false" server-group="default_group">
</network-policy>
<server-group id="default_group" title="default-group">
<group-server id="192.168.宿主"/>
</server-group>
<domain id="cat">
<group id="default">
<server id="192.168.宿主" port="2280" weight="1.0"/>
</group>
</domain>
</router-config>
都保存之后,可以返回到cat的dashboard看看玉工,我當時仍然是顯示“出問題CAT的服務端:[192.168.宿主]”羽资,未清楚,但沒影響測試就不管了遵班。
接下來就是springboot集成cat
(1)導包
<dependency>
<groupId>com.dianping.cat</groupId>
<artifactId>cat-client</artifactId>
<version>3.0.0</version>
</dependency>
(2)配置resources/META-INF/app.properties
app.name=mall
自己創(chuàng)建這個文件削罩,app名字隨意瞄勾,不要搞特殊就好
(3)簡單測試
@RestController
public class CatTest {
@GetMapping("/lyc")
public String lyc(){
Transaction t = Cat.newTransaction("URL", "pageName");
try {
Cat.logEvent("URL.Server", "serverIp", Event.SUCCESS, "ip=127.0.0.1");
Cat.logMetricForCount("metric.key");
Cat.logMetricForDuration("metric.key", 5);
int i = 1/0;
t.setStatus(Transaction.SUCCESS);
} catch (Exception e) {
Cat.logError(e);
t.setStatus(e);
throw e;
} finally {
t.complete();
}
return "cat"+ DateUtil.now();
}
}
(4)運行參數(shù)
-DCAT_HOME=/xxx/yyy
隨便指定一個目錄,不指定的話會默認/data/appdatas/cat/弥激,后果就是mac根本無法在根下創(chuàng)建data目錄,然后在這個目錄下創(chuàng)建client.xml愿阐,
<?xml version="1.0" encoding="utf-8"?>
<config mode="client">
<servers>
<server ip="192.168.宿主" port="2280" http-port="8080"/>
</servers>
</config>
之前tomcat是開放了這兩個端口的微服,所以可以訪問禀横,不然會提示連不到2280
ok纵顾,到這里就可以啟動springboot了厢钧,然后訪問controller滥玷,數(shù)據(jù)就會提交到client.xml指定的server偎窘,這個時候可以查看cat的dashboard固惯,會看到一個app.name名稱的
| 14:53 |
| 系統(tǒng) | 個 |
| mall| 1 |
可以點擊超鏈接進入查看信息洲守。
在過程中涡驮,如果有任何問題魄缚,都可以到CAT_HOME那里查看日志宝与,配置了CAT_HOME的話,一切都會順利很多冶匹,當時我就是不知道要配置CAT_HOME习劫,走了很多彎路,老是說沒有/data/appdatas/cat之類的話嚼隘,然后全局系統(tǒng)配置那里的ip又很模糊不知道在容器里怎么填诽里,都是一步步測試走過來的,要善于看日志飞蛹。
Cat官方文檔中文文檔地址
https://www.bookstack.cn/read/dianping-cat/HOME.md