Cat记录

坑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