坑1：
部署cat的服务器，时间一定要正确，不然有可能会报500（就是那个两小时内的无法访问，两小时前的才正常访问）。并且时间正确的话，看dashboard显示的时间才对。
坑2：
打包过程注意依赖即可，只要刷新maven没有错，基本都是打包正常，如果还是失败，看看失败原因，有可能是网络问题下载某些包失败，要把本地仓库的对应包对应版本的目录删除（也就是删除lastupdate），重新打包即可 mvn clean install -DskipTests。如果某些包没法下载，是因为没有上传到中央仓库，可以到cat的github那里选择mvn-repo分支拉取下来，把里面的包复制到本地仓库
坑3：
网上的教程，都是大同小异，没有说清楚配置，就是说要创建client.xml和datasources.xml，因为官网也是这样的步骤，但这种情况的话，是cat和你的程序都在同一个环境下才这样，如果cat和程序不在同一个环境下，就不是这样配置了。例如docker创建一个tomcat容器，cat部署上去，springboot项目是本地开发，直接run的，这样就不在同一个环境，下面记录一下怎么配置
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目录下创建appdatas/cat和applogs/cat，在appdatas/cat下创建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> <!-- 请替换为真实数据库URL及Port -->
<user>root</user> <!-- 请替换为真实数据库用户名 -->
<password>root</password> <!-- 请替换为真实数据库密码 -->
<connectionProperties><![CDATA[useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&autoReconnect=true&socketTimeout=120000]]></connectionProperties>
</properties>
</data-source>
</data-sources>
这里的配置根据情况修改，数据库名，账号密码，连接参数
到这里，cat服务就可以了，不需要client.xml的，另外注意一下修改data目录的读写权限，chmod -R 777 /xxx/myDocker/tomcat/data/
现在可以启动tomcat容器，cat就可以访问了，一般没有其他问题，有问题再查吧。
这个时候虽然cat能访问，但不能正常工作，需要改一下配置（都是跟着官方文档做的，为什么要这样做还不清楚）
进入config（或http://{ip:port}/cat/s/config?op=serverConfigUpdate）
进入全局系统配置-服务端配置
<?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即可（网络偏好设置ip），没有用到hdfs，ip不用管，另外注意本地节点的角色，job-machine&alarm-machine都可以配置为true，以便于debug。
全局系统配置-客户端路由，同理，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
自己创建这个文件，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）运行参数
-DCAT_HOME=/xxx/yyy
随便指定一个目录，不指定的话会默认/data/appdatas/cat/，后果就是mac根本无法在根下创建data目录，然后在这个目录下创建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，数据就会提交到client.xml指定的server，这个时候可以查看cat的dashboard，会看到一个app.name名称的
| 14:53 |
| 系统 | 个 |
| mall| 1 |
可以点击超链接进入查看信息。
在过程中，如果有任何问题，都可以到CAT_HOME那里查看日志，配置了CAT_HOME的话，一切都会顺利很多，当时我就是不知道要配置CAT_HOME，走了很多弯路，老是说没有/data/appdatas/cat之类的话，然后全局系统配置那里的ip又很模糊不知道在容器里怎么填，都是一步步测试走过来的，要善于看日志。
Cat官方文档中文文档地址
https://www.bookstack.cn/read/dianping-cat/HOME.md
