mac部署CAT监控服务

在 Mac 上部署美团点评开源的 CAT 监控服务端，可以按照以下步骤操作：

---

1. 环境准备

1.1 安装依靠

确保已安装以下工具：

• JDK 8+（发起 OpenJDK 11）
  
• MySQL 5.7+（存储监控数据）（8.0+不支持。。）
  如果须要支持8.0，可以使用这个工程
  https://github.com/lazeyliu/cat（最低支持tomcat-10。。）
  https://github.com/carlzhangweiwen/cat（编译不通过）
  
• Maven 3.6+（构建 CAT 源码）
  
• Tomcat 8/9（部署 CAT Web 控制台）
  

通过 Homebrew 安装：

1. # 安装 Homebrew（若未安装）
2. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
4. # 安装依赖
5. brew install openjdk@11 mysql maven tomcat@9

复制代码

1.2 设置环境变量

在 ~/.zshrc 或 ~/.bash_profile 中添加：

1. # Java
2. export JAVA_HOME=/usr/local/opt/openjdk@11
3. export PATH=$JAVA_HOME/bin:$PATH
5. # Maven
6. export MAVEN_HOME=/usr/local/Cellar/maven/3.8.6
7. export PATH=$MAVEN_HOME/bin:$PATH
9. # Tomcat
10. export CATALINA_HOME=/usr/local/opt/tomcat@9/libexec
11. export PATH=$CATALINA_HOME/bin:$PATH

复制代码

生效设置：

1. source ~/.zshrc

复制代码

---

2. 初始化 MySQL 数据库

2.1 启动 MySQL

1. brew services start mysql

复制代码

2.2 创建 CAT 数据库

登录 MySQL：

1. mysql -u root -p

复制代码

实行以下 SQL：

1. -- 创建数据库
2. CREATE DATABASE `cat` DEFAULT CHARACTER SET utf8mb4;
4. -- 创建用户并授权
5. CREATE USER 'cat'@'localhost' IDENTIFIED BY 'cat_password';
6. GRANT ALL PRIVILEGES ON `cat`.* TO 'cat'@'localhost';
7. FLUSH PRIVILEGES;

复制代码

2.3 导入 CAT 初始表布局

下载 CAT 源码并导入 SQL：

1. git clone https://github.com/dianping/cat.git
2. cd cat/script
3. mysql -u cat -p cat < CatApplication.sql
4. mysql -u cat -p cat < CatDailyReport.sql

复制代码

输入暗码 cat_password（与 SQL 中设置同等）。

---

3. 编译 CAT 服务端

3.1 下载源码

1. git clone https://github.com/dianping/cat.git
2. cd cat

复制代码

3.2 修改数据库设置

在Linux系统安装时，CAT应用要求对/data/appdatas/cat和/data/applogs/cat路径有读写权限。
CAT服务端应用会对这两个目录举行读写操作，因此须要首先创建这两个目录。并且应确保启动CAT应用的用户对这两个目录有读写权限。
服务端部署/data/appdatas/cat/client.xml和 server.xml设置无用(限3.0+war包)，可以去掉
部署。
须要在data目录下创建文件夹：

1. # mkdir -p /data/appdatas/cat && mkdir -p /data/applogs/cat

复制代码

如果提示mkdir: /data: Read-only file system，表示mac根目录无法创建文件夹，则可以通过软链解决，具体解决方法检察：
https://blog.csdn.net/youwen21/article/details/115000907
编辑文件 cat-home/src/main/resources/datasources.xml：

1. <?xml version="1.0" encoding="utf-8"?>
2. <data-sources>
3.     <data-source id="cat">
4.         <properties>
5.             <driver>com.mysql.jdbc.Driver</driver>
6.             <url>jdbc:mysql://127.0.0.1:3306/cat</url>
7.             <user>cat</user>
8.             <password>cat_password</password>
9.             <connectionProperties>useUnicode=true&amp;characterEncoding=UTF-8&amp;autoReconnect=true</connectionProperties>
10.         </properties>
11.     </data-source>
12. </data-sources>

复制代码

3.3 编译打包

1. mvn clean install -DskipTests

复制代码

编译成功后，生成以下文件：

• cat-home/target/cat-home.war（Web 控制台）
  
• cat-client/target/cat-client.jar（客户端依靠）
  cat-client.jar如今没有maven仓库下载，须要自己上传到自己的私服，大概存放到本地依靠目录。
  

---

自己编译的部署有问题，最好照旧下载官方提供的war包吧https://github.com/dianping/cat/releases/tag/3.1.0
4. 部署到 Tomcat

4.1 复制 WAR 包到 Tomcat

1. cp cat-home/target/cat-home.war $CATALINA_HOME/webapps/

复制代码

4.2 启动 Tomcat

1. catalina start

复制代码

访问控制台：
http://localhost:8080/cat
默认账号：admin，暗码：admin。

---

5. 设置 CAT 服务端

5.1 开放端口

确保以下端口可用：

• 8080：Tomcat Web 端口（CAT 控制台）
  
• 2280：CAT 服务端 TCP 端口（客户端上报数据）
  

5.2 修改服务端设置（可选）

编辑 cat-home/src/main/resources/server.xml，调整服务端参数：

1. <config local-mode="true">
2.     <server id="default">
3.         <property name="local-mode" value="true"/>
4.         <property name="http-port" value="8080"/>
5.         <property name="tcp-port" value="2280"/>
6.     </server>
7. </config>

复制代码

---

6. 验证部署

6.1 检查 CAT 控制台

登录后检察以下报表是否正常：

• Transaction：事务统计
  
• Event：自定义事件
  
• Heartbeat：心跳检测
  

6.2 客户端测试

在 Spring Boot 应用的 cat-client.xml 中设置：

1. <servers>
2.     <server ip="localhost" port="2280" http-port="8080"/>
3. </servers>

复制代码

重启应用后，观察 CAT 控制台是否有数据上报。

---

常见问题排查

1. 控制台无法访问

把文件cat.war (如果叫cat-home.war 重定名为cat.war)
常见问题：https://www.cnblogs.com/jingch/p/17141552.html
http://localhost:8080/cat/s/config?op=serverConfigUpdate

• 检查 Tomcat 是否启动：
  
  1. ps aux | grep tomcat

  复制代码
• 检察 Tomcat 日志：
  
  1. tail -f $CATALINA_HOME/logs/catalina.out

  复制代码

2. 客户端数据未上报

• 验证端口连通性：
  
  1. telnet localhost 2280

  复制代码
• 检查 cat-client.xml 中的服务端 IP 和端口。
  

3. 数据库连接失败

• 检查 MySQL 用户权限：
  
  1. SHOW GRANTS FOR 'cat'@'localhost';

  复制代码
• 确认 SQL 脚本已完整导入。
  

---

优化发起

• 数据清算策略
  修改 cat-home/src/main/resources/datasources.xml，设置主动清算历史数据：
  
  1. <property name="hdfs-clean-period">86400</property> <!-- 清理周期（秒） -->

  复制代码
• 集群部署
  若需高可用，可部署多个 CAT 服务端节点，并设置负载均衡。
  

---

通过以上步骤，即可在 Mac 上完成 CAT 监控服务端的部署。如果碰到问题，可根据日志和端口连通性逐步排查。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。