美团点评CAT部署了各种环境不下10次，遇到的坑整理

CAT是什么

我的理解是一个收集服务调用等运行情况的监控系统。

 相信你能搜到这篇博客我就不多介绍了，这里有链接 传送门

本博客仅仅只帮助大家解决部署方面的问题

来自一个用户的吐槽

1.部署真他娘的困难，坑点太多了。

2.初期部署经常被难住点：源代码拉下来编译不通过

3.mysql版本要求5.7及以下，现在都普遍8.0了

4.cat-client 服务启动找CAT-HOME ,找不到默认/data/appdatas/cat 固定目录，对mac系统非常不友好

5.配置化的东西太多了，操作难度直线上升

   a.客户端需要到META_INF/app.properties 读取app.name 作为应用名称

   b.客户端需要到指定目录创建/data/appdatas/cat 文件夹，并在里面创建client.xml文件，加上服务端配置

   c.服务端需要生成cat数据库，利用手中的sql脚本 这个在公司内网云平台执行校验时各种索引命名规范问题，大文本不可空问题，搞死了

   d.服务端把war包放到tomcat/webapps目录下后，点啥菜单都出现500，可能导致的问题太多了，还每次都不一样，运行环境是个大问题

   e.服务端部署好后，还得设置服务端配置、客户端配置、单机和集群环境还不太一样

   d.客户端连不上服务端问题，又是一顿排查

 

如何部署（linux环境）

环境准备：

linux centos7（华为云or阿里云等云服务器）

tomcat8.5

jdk1.8 (配置好环境变量)

mysql5.7

cat.war文件，一般3.0版

数据库脚本 CatApplication.sql  先创建数据库cat 到mysql执行建表

datasource.xml 文件，里面的连接字符串改成自己的

client.xml(这个文件服务部署用不到，客户端接入的时候用，亲测)

材料就是这些，不过云服务器需要开通外部访问的端口，切记 保证如果cat服务和数据库不在一台机器上时能连接上

服务端部署/data/appdatas/cat/client.xml和 server.xml配置无用(限3.0+war包)，可以去掉

部署

1.把apache-tomcat-8.5.84.tar.gz 上传到服务器/usr/local目录 解压成文件夹 tar -zxvf apache-tomcat-8.5.84.tar.gz 得到文件目录apache-tomcat-8.5.84

2.把jdk-8u333-linux-x64.tar.gz 上传到服务器/usr/local目录 解压成文件夹 tar -zxvf jdk-8u333-linux-x64.tar.gz 得到文件目录 jdk1.8.0_333

3.把文件cat.war (如果叫cat-home.war 重命名为cat.war) 上传到目录/usr/local/apache-tomcat-8.5.84/webapps/

4.配置java_home环境变量 vim ~/etc/profile 在最结尾输入

export JAVA_HOME =/usr/local/jdk1.8.0_333
export CLASSPATH =.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export PATH=$JAVA_HOME/bin:$PATH

wq保存后执行source ~/etc/profile 刷新缓存

执行java -version 如果不成功搜教程

5.服务器新建cat运行目录并授权

  mkdir -p /data/appdatas/cat 

  mkdir -p /data/applogs/cat 

  chmod 777 /data/appdatas/cat 

  chmod 777 /data/applogs/cat 

6.把改好的datasource.xml 文件上传到/data/appdatas/cat 目录

7.启动tomcat 

   cd /usr/local/apache-tomcat-8.5.84/bin

   sh ./startup.sh  启动后tomcat会自动解压cat.war 并启动cat服务,cat服务会去加载配置

    观察/usr/local/apache-tomcat-8.5.84/logs里面的日志，看看有没有异常

    观察/data/applogs/cat 里面的cat启动日志，一般看数据库能不能连接上

　　cd /data/applogs/cat

      cat cat_xxx.log xx自己换一下日期

8. 访问cat地址 

      在浏览器输入ip:8080/cat/r

9.修改服务端配置

     （2者选其一）：

　　　在浏览器输入　ip:8080/cat/s/config?op=serverConfigUpdate    

         或者页面点Configs->全局系统配置->服务端配置 效果是一样的

 

 

       如果是集群部署，还需要改一下本文件 default里面的，搜一下remote-servers

     <property name="remote-servers" value="ip1:8080,ip2:8080"/>

　　此配置用于同步各个机器配置

    点提交

10.客户端路由配置

    在浏览器输入　ip:8080/cat/s/config?op=routerConfigUpdate

         或者页面点Configs->全局系统配置->客户端路由 效果是一样的

 此配置主要是告诉客户端 应该连接哪个服务器，单台部署就配一个，多台部署配多个，也是替换掉ip为自己的就行了

 

 

11.项目信息配置

  在Configs->项目信息配置中，加入自己的项目信息，联系人之类的，方便后续添加监控，告警联系人之类的 

 

如果客户端接入不成功，出现connection error的错误，就要来客户端路由这里看看是不是配错什么了

部署完成！！！

不出意外的话，点击applition ->tranaction 应该不会出现500了。

 

如果还是出现500，那当我没说 - -！

 

出现问题的解决方法

1.出问题CAT的服务端

在浏览器输入　ip:8080/cat/s/config?op=serverConfigUpdate    

<property name="remote-servers" value="xx:8080,xx2:8080"/>

如果是集群，把这里配置好，如果这里配置的是外网地址就会一直出现，不过不影响使用

如果是公司内网，把内网ip写上去就行

 

2.点任何地方都是500

1.检查jdk版本，我部署过多套，1.8基本不会出问题，1.7偶尔会有问题

2.检查tomcat版本，和启动日志

3.检查我上诉安装流程，有没有没有做到的，例如文件夹路径，权限，java_home环境变量

4.启动后tomcat会自动解压cat.war 并启动cat服务,cat服务会去/data/appdatas/cat加载配置文件datasource.xml，

 所以要确定mysql可用，表建立完整，连接字符串配置无问题，无特殊字符 圆角，配置确定无误进行下一项

5.再次执行一遍安装步骤中的9，10 两项，必要情况下可以重启tomcat ,甚至服务器

6.确认war包来源无问题，如果自己用编译的war包有问题，尽量用官网的 3.0的

 

3.客户端连接不上cat

  1.检查网络环境，特别是公司内网，有时候是不能访问外网的

  2.检查客户端client.xml 文件路径，app.properties路径

  3.查看cat_home/cat_xx.log日志 排查问题，不外乎配置文件找不到，配置文件配置错误，配置文件ip无法访问，cat服务器未正常对外提供服务

 

 

云服务器部署注意

 对外通信端口 如3306，8080，2280，2281等端口要放开，可以在控制台设置

 云服务器下载什么的都非常简单，部署几分钟就好了

 

公司内网部署注意

公司内网生产环境一般无法访问外网，无法在线安装和下载，所以一些文件上传解压会麻烦一些，特别是有些端口是置顶的，如tomcat不是8080，要改成8000这张，还要集群部署，配置nginx，配置域名

 

集群部署注意

集群要注意的是多个机器之间的通信，例如我2台机器一个在阿里云一个在华为云，ip用的都是公网ip，会出现 【出问题的cat服务端】，正常在公司内网部署，用的都是内网ip，不会出现这个，当然 出现这个提示不影响使用

在浏览器输入　ip:8080/cat/s/config?op=serverConfigUpdate    

<property name="remote-servers" value="xx:8080,xx2:8080"/>

remote-servers 是在一台机器上配置这个后，多台机器会自动同步服务器配置

 

客户端路由设置

<default-server id="10.xx" weight="1.0" port="2280" enable="true"/>
<default-server id="10.xx2" weight="1.0" port="2280" enable="true"/>

enable="true" 要注意，默认可能是false

单机部署注意

如果客户端和服务端 都部署在一台服务器上，/data/appdatas/cat/client.xml文件是给客户端用的，/data/appdatas/cat/datasource.xml是给服务端用的

 

指定CAT_HOME

客户端应用在自动化部署或者本地测试时，不想使用默认路径时，除了自己编译cat-client修改源代码外，还可以指定系统变量CAT_HOME的路径

 

 

 

我的配置参考

服务端配置

<?xml version="1.0" encoding="utf-8"?>
<server-config>
   <server id="default">
      <properties>
         <property name="local-mode" value="false"/>
         <property name="job-machine" value="true"/> 
         <property name="send-machine" value="true"/>
         <property name="alarm-machine" value="true"/>
         <property name="hdfs-enabled" value="false"/>
         <property name="remote-servers" value="139.196.1.1:8080,123.60.1.2:8080"/>
      </properties>
      <storage local-base-dir="/data/appdatas/cat/bucket/" max-hdfs-storage-time="15" local-report-storage-time="2" local-logivew-storage-time="1" har-mode="true" upload-thread="5">
         <hdfs id="dump" max-size="128M" server-uri="hdfs://127.0.0.1/" base-dir="/user/cat/dump"/>
         <harfs id="dump" max-size="128M" server-uri="har://127.0.0.1/" base-dir="/user/cat/dump"/>
         <properties>
            <property name="hadoop.security.authentication" value="false"/>
            <property name="dfs.namenode.kerberos.principal" value="hadoop/[email protected]"/>
            <property name="dfs.cat.kerberos.principal" value="[email protected]"/>
            <property name="dfs.cat.keytab.file" value="/data/appdatas/cat/cat.keytab"/>
            <property name="java.security.krb5.realm" value="value1"/>
            <property name="java.security.krb5.kdc" value="value2"/>
         </properties>
      </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="139.196.1.1">
      <properties>
         <property name="job-machine" value="true"/>
         <property name="send-machine" value="true"/>
         <property name="alarm-machine" value="true"/>
      </properties>
   </server>
</server-config>

 

客户端路由配置

<?xml version="1.0" encoding="utf-8"?>
<router-config backup-server="139.196.1.1" backup-server-port="2280">
   <default-server id="139.196.1.1" weight="1.0" port="2280" enable="true"/>
   <default-server id="123.60.1.2" weight="1.0" port="2280" enable="true"/>
   <network-policy id="default" title="默认" block="false" server-group="default_group">
   </network-policy>
   <server-group id="default_group" title="default-group">
      <group-server id="139.196.1.1"/>
      <group-server id="123.60.1.2"/>
   </server-group>
   <domain id="cat">
      <group id="default">
         <server id="139.196.1.1" port="2280" weight="1.0"/>
         <server id="123.60.1.2" port="2280" weight="1.0"/>
      </group>
   </domain>
</router-config>

 

datasource.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://xx:3306/cat]]></url>  <!-- 请替换为真实数据库URL及Port  -->
                        <user>root</user>
                        <password>123456</password>
                        <connectionProperties><![CDATA[useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&socketTimeout=120000]]></connectionProperties>
                </properties>
        </data-source>
</data-sources>

 

client.xml

<?xml version="1.0" encoding="utf-8"?>
<config mode="client">
    <servers>
        <server ip="139.196.1.1" port="2280" http-port="8001"/>
        <server ip="123.60.1.2" port="2280" http-port="8001"/>
    </servers>
</config>

 

app.name =xxx-app

路径 项目中resource/META-INF/app.properties

 

结尾

各种环境的cat我都部署了好多次，每次遇到的情况也不一样，只能说想要在公司搭一套进行简单的使用，上手难度还是非常高的，不像skywalking 部署超级简单docker环境下 docker compose 直接搞定，不过skywalking擅长的是链路追踪和日志查询，对于metrics+监控告警 方面还不够。结合使用效果更佳。

目前cat已经属于比较老的中间件了，美团方面开源部分没维护了，部署起来又困难，加上代码侵入性，用的人不多了。

但是用过cat的人，基本都会喜欢用cat,那种服务可视化、透明化，超强控制力的感觉，以agent为代表的skywaling们是远远比不了的。