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 安装：

# 安装 Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装依赖
brew install openjdk@11 mysql maven tomcat@9

1.2 配置环境变量

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

# Java
export JAVA_HOME=/usr/local/opt/openjdk@11
export PATH=$JAVA_HOME/bin:$PATH

# Maven
export MAVEN_HOME=/usr/local/Cellar/maven/3.8.6
export PATH=$MAVEN_HOME/bin:$PATH

# Tomcat
export CATALINA_HOME=/usr/local/opt/tomcat@9/libexec
export PATH=$CATALINA_HOME/bin:$PATH

生效配置：

source ~/.zshrc

---

2. 初始化 MySQL 数据库

2.1 启动 MySQL

brew services start mysql

2.2 创建 CAT 数据库

登录 MySQL：

mysql -u root -p

执行以下 SQL：

-- 创建数据库
CREATE DATABASE `cat` DEFAULT CHARACTER SET utf8mb4;

-- 创建用户并授权
CREATE USER 'cat'@'localhost' IDENTIFIED BY 'cat_password';
GRANT ALL PRIVILEGES ON `cat`.* TO 'cat'@'localhost';
FLUSH PRIVILEGES;

2.3 导入 CAT 初始表结构

下载 CAT 源码并导入 SQL：

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

输入密码 cat_password（与 SQL 中配置一致）。

---

3. 编译 CAT 服务端

3.1 下载源码

git clone https://github.com/dianping/cat.git
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目录下创建文件夹：

# 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：

<?xml version="1.0" encoding="utf-8"?>
<data-sources>
    <data-source id="cat">
        <properties>
            <driver>com.mysql.jdbc.Driver</driver>
            <url>jdbc:mysql://127.0.0.1:3306/cat</url>
            <user>cat</user>
            <password>cat_password</password>
            <connectionProperties>useUnicode=true&amp;characterEncoding=UTF-8&amp;autoReconnect=true</connectionProperties>
        </properties>
    </data-source>
</data-sources>

3.3 编译打包

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

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

4.2 启动 Tomcat

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，调整服务端参数：

<config local-mode="true">
    <server id="default">
        <property name="local-mode" value="true"/>
        <property name="http-port" value="8080"/>
        <property name="tcp-port" value="2280"/>
    </server>
</config>

---

6. 验证部署

6.1 检查 CAT 控制台

登录后查看以下报表是否正常：

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

6.2 客户端测试

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

<servers>
    <server ip="localhost" port="2280" http-port="8080"/>
</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 是否启动：

  ps aux | grep tomcat

• 查看 Tomcat 日志：

  tail -f $CATALINA_HOME/logs/catalina.out

2. 客户端数据未上报

• 验证端口连通性：

  telnet localhost 2280

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

3. 数据库连接失败

• 检查 MySQL 用户权限：

  SHOW GRANTS FOR 'cat'@'localhost';

• 确认 SQL 脚本已完整导入。

---

优化建议

1. 数据清理策略
   修改 cat-home/src/main/resources/datasources.xml，配置自动清理历史数据：

   <property name="hdfs-clean-period">86400</property> <!-- 清理周期（秒） -->

2. 集群部署
   若需高可用，可部署多个 CAT 服务端节点，并配置负载均衡。

---

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