Cacti —— 以 SNMP 轮询 + RRDtool 环形存储为核心的网络流量绘图与故障管理平台

分类：03 一体化监控平台 适用：路由器/交换机/防火墙/服务器等 SNMP 设备；LAN 到上万台设备、以带宽/流量/接口趋势图为核心的场景 一句话：SNMP 定时取数 → RRDtool 落盘 → 模板化出图，配 Spine 加速轮询、Weathermap 画链路流量图 官方：https://www.cacti.net/ ｜ https://github.com/Cacti/cacti ｜ https://docs.cacti.net/ 授权：GNU GPL v2 或更高版本，完全开源；插件生态由社区维护

1. 它解决什么问题

不擅长：秒级监控（默认 5 分钟轮询）、日志全文检索与链路追踪、云原生高基数标签模型（Prometheus 更合适）、复杂 PromQL/多维即席分析。

2. 核心概念与架构

2.1 术语表

2.2 组件与数据流（SNMP poller → RRD → Graph）

 网络设备（snmpd，UDP 161）─ SNMP GET/BULKWALK(v1/v2c/v3) ─▶ 采集层
 ┌──────────── 采集层（每 5 分钟，cron 或 cactid） ────────────┐
 │ poller.php ─▶ cmd.php（PHP 单进程）/ Spine（C 多线程）       │
 │      ▲ 从 MySQL 读 Poller Cache（设备→DS→OID 任务）          │
 └──────────┬────────────────────────────────────────────────┘
            │ Counter/Gauge 值（ifInOctets、ifOutOctets）
            ▼  rrdtool update（Boost 可选：先入 DB 再批量落盘）
      rra/<host>_<ds>.rrd（RRA 自动降采样，固定大小）
            ▼  rrdtool graph
 ┌──────────── 展示层（Apache/Nginx + PHP） ──────────────────┐
 │ graph_image.php → Graph Tree → RBAC → 浏览器 PNG/CSV/Realtime│
 └────────────────────────────────────────────────────────────┘
 旁路：Weathermap（地图）、Thold（阈值告警→邮件）、Syslog、Monitor

• 链路：poller.php 从 MySQL 读 Poller Cache → cmd.php/Spine 经 SNMP 取 OID 值 → rrdtool update 写 rra/*.rrd → 浏览器请求时 rrdtool graph 实时渲染 PNG。
• RRD 特性：创建时大小即固定，多个 RRA 分别保存 5m/30m/2h/1d 等粒度，旧数据自动归并，因此不随时间膨胀，适合长期趋势。
• 模板与取值：模板是 XML（Console → Import/Export → Import Templates 预览冲突）；改 Data Query/模板需 rebuild_poller_cache.php；流量用 COUNTER（差值/间隔算速率）、CPU 用 GAUGE，CDEF 做单位换算。

3. 安装与部署

当前稳定系列为 1.2.x（另有 1.3 开发分支），具体版本号以官方最新稳定版为准（https://www.cacti.net/info/downloads）。1.2.31 起官方要求 PHP 8.1+ 与 Composer；<xxx> 为占位符。

3.1 环境准备（含 SNMP 前提）

3.2 多种安装方式

方式 A：发行版包（最快）

sudo apt-get install -y cacti     # Debian/Ubuntu；RHEL/Rocky 用 sudo dnf install -y cacti（必要时启 EPEL）
# 安装向导会提示建库、选轮询器；Web 访问 http://<主机>/cacti

方式 B：官方源码 + LAMP（生产常用）

sudo yum install -y httpd php php-mysqlnd php-gd php-snmp php-mbstring php-xml \
  php-ldap php-gmp php-intl php-zip php-json php-process rrdtool net-snmp net-snmp-utils mariadb-server composer
sudo systemctl enable --now httpd mariadb
cd /tmp && wget https://www.cacti.net/downloads/cacti-1.y.z.tar.gz
tar -zxvf cacti-1.y.z.tar.gz && sudo mv cacti-1.y.z /var/www/html/cacti
cd /var/www/html/cacti && sudo composer install      # 1.2.31+ 用 Composer 装 PHP 依赖
mysql -uroot -p<密码> -e "CREATE DATABASE cacti DEFAULT CHARACTER SET utf8mb4;"
mysql -uroot -p<密码> -e "GRANT ALL ON cacti.* TO 'cactiuser'@'localhost' IDENTIFIED BY '<cacti_pass>'; FLUSH PRIVILEGES;"
mysql -uroot -p<密码> cacti < /var/www/html/cacti/cacti.sql
sudo cp include/config.php-dist include/config.php   # 编辑 $database_* 见第 4 章
sudo useradd -r -M cacti && sudo chown -R cacti rra/ log/

方式 C：Spine 编译安装（高并发轮询）

cd /tmp && wget https://www.cacti.net/downloads/spine/cacti-spine-1.y.z.tar.gz
tar -zxvf cacti-spine-1.y.z.tar.gz && cd cacti-spine-1.y.z
./configure && make && sudo make install          # 默认装到 /usr/local/spine/bin/spine
sudo cp /usr/local/spine/etc/spine.conf.dist /etc/spine.conf
sudo chown root:root /usr/local/spine/bin/spine && sudo chmod +s /usr/local/spine/bin/spine
/usr/local/spine/bin/spine                        # 应输出 Using spine config file [/etc/spine.conf]

Web 侧切换：Console → Settings → Poller 把 Poller Type 改为 spine；Paths 里填 Spine / RRDtool / SNMP 二进制路径。

方式 D：cron / systemd 定时任务

# 传统 cron（/etc/cron.d/cacti），每 5 分钟一次，与 300s 轮询周期对齐
echo '*/5 * * * * apache php /var/www/html/cacti/poller.php > /dev/null 2>&1' | sudo tee /etc/cron.d/cacti
sudo systemctl restart crond
# 1.2.16+ 可用 systemd cactid 替代 cron
sudo cp /var/www/html/cacti/service/cactid.service /etc/systemd/system/ && sudo touch /etc/sysconfig/cactid
sudo systemctl daemon-reload && sudo systemctl enable --now cactid

气隙/离线：源码包 + 本地 yum/apt 源即可；Weathermap、Thold 等插件放到 plugins/ 并在「Plugin Management」启用。

3.3 首次启动与验证（含 SNMP 探测）

sudo -u apache php /var/www/html/cacti/poller.php   # 应输出 OK u:... 与 SYSTEM STATS: Time:... Method:cmd.php/spine
tail -n 30 /var/www/html/cacti/log/cacti.log
ls -l /var/www/html/cacti/rra/ | head              # 出现 .rrd 文件即采集成功
snmpwalk -v2c -c <community> <设备IP> 1.3.6.1.2.1.1.1.0           # sysDescr
snmpwalk -v2c -c <community> <设备IP> IF-MIB::ifDescr              # 列接口
snmpget  -v2c -c <community> <设备IP> IF-MIB::ifInOctets.2         # 取单 OID
# Web http://<主机>/cacti 默认 admin/admin 首次强制改密；Console → Devices → Add → Create Graphs

4. 配置文件详解

4.1 路径与关键项

4.2 完整可运行最小示例

<?php
// /var/www/html/cacti/include/config.php
$database_type     = 'mysql';
$database_default  = 'cacti';
$database_hostname = 'localhost';
$database_username = 'cactiuser';
$database_password = '<cacti_pass>';
$database_port     = '3306';
$database_ssl      = false;     # 需 TLS 时再补 $database_ssl_key / _cert / _ca
$url_path = '/cacti/';

# /etc/spine.conf（Spine 与 Web 读同一套库；ICMP ping 需给 spine 加 suid）
DB_Host        localhost
DB_Database    cacti
DB_User        cactiuser
DB_Pass        <cacti_pass>
DB_Port        3306

改完校验：sudo -u apache php /var/www/html/cacti/poller.php 能连库、/usr/local/spine/bin/spine 能读配置。

5. 核心使用方法（CLI / Web UI / SNMP）

5.1 命令与操作速览（≥20 条）

5.2 SNMP 探测与模板导入

snmpwalk -v2c -c <community> -On <设备IP> 1.3.6.1.2.1.1.3.0        # sysUpTime
snmpwalk -v2c -c <community> <设备IP> IF-MIB::ifTable | head -n 20   # 接口表
snmpwalk -v3 -l authPriv -u <user> -a SHA -A <auth_pass> -x AES -X <priv_pass> <设备IP> 1.3.6.1.2.1.1.1.0
snmpbulkwalk -v2c -c <community> <设备IP> IF-MIB::ifHCInOctets        # 64 位计数器
snmpget -v2c -c <community> -On <设备IP> IF-MIB::ifHCInOctets.2       # 取两次差值/间隔即速率

模板导入（Web UI）：
1. Console → Import/Export → Import Templates → 选 XML → 预览依赖冲突 → Import
2. Console → Devices → 编辑设备 → 关联 Host Template / 勾选 Data Query
3. 改了 Data Query 或模板：CLI 执行 php -q cli/rebuild_poller_cache.php
4. 等 1~2 个轮询周期，Graphs 页出现新图

5.3 poller 与缓存维护

sudo -u apache php /var/www/html/cacti/poller.php   # SYSTEM STATS: Time / Method:cmd.php|spine
php -q cli/rebuild_poller_cache.php --help
php -q cli/rebuild_poller_cache.php                 # 大系统耗时数分钟~数小时，务必走 CLI
php -q cli/audit_database.php
php -q cli/upgrade_database.php --help
grep -E 'WARNING|ERROR|SPINE|POLLER' /var/www/html/cacti/log/cacti.log | tail -n 50

6. 告警与通知

6.1 阈值、静默与升级

⚠️ 告警能力依赖第三方插件（Thold/Monitor/Syslog/Maint），插件与 Cacti 版本需匹配，启用前在「Plugin Management」核对兼容性。

6.2 邮件配置示例（Web UI）

Console → Configuration → Settings → Mail/Reporting
  Mail Services: SMTP
  SMTP Hostname: <smtp.example.com>   SMTP Port: 587   SMTP Security: TLS
  SMTP Username: <user>   SMTP Password: <pass>
  From Address: cacti@<example.com>   From Name: Cacti
  勾选 "Notify Primary Admin of Issues"，保存后点 Send a Test Email 验证

# CLI 侧确认队列/日志（是否发出）
grep -iE 'mail|thold|notify' /var/www/html/cacti/log/cacti.log | tail -n 30

7. 实战场景

场景一：接入一台交换机并画出全部接口流量图

• 目标 / 步骤：SNMP 可达 → 加设备 → 用 Data Query 自动发现接口 → 批量建图 → 挂到图形树。

snmpwalk -v2c -c <community> <交换机IP> IF-MIB::ifDescr   # 不通查 snmpd/community/UDP 161/ACL
# Web：Console → Devices → Add（Host Template=Generic SNMP Device，SNMP Version=2c，Community=<community>）
# 设备页 Create Graphs for this Host → 勾选 Data Query [SNMP - Interface Statistics] → 选接口 → Create
sudo -u apache php /var/www/html/cacti/poller.php && sudo -u apache php /var/www/html/cacti/poller.php
ls /var/www/html/cacti/rra/ | grep <host_id>

• 验证：rrdtool info <对应.rrd> 有 DS、Graphs 页出现 In/Out Octets 曲线；snmpbulkwalk 与图量级一致。
• 回滚：Devices 中删除该主机 → System Utilities → RRDfile Cleaner 归档清理孤儿 RRD；⚠️ 删设备会连带删除其图形与历史 RRD，先导出模板/备份 rra/。

场景二：从 cmd.php 切到 Spine 并重建 Poller Cache

• 目标 / 步骤：设备数增长后 PHP 轮询超时，改用 Spine 多线程；改模板后重建缓存。

/usr/local/spine/bin/spine                                    # 确认可读库
# Web：Settings → Paths 填 Spine 路径；Settings → Poller 改 Poller Type=spine、调 Threads
php -q cli/rebuild_poller_cache.php                           # 模板/Data Query 变更后，CLI 重建
sudo -u apache php /var/www/html/cacti/poller.php
tail -n 20 /var/www/html/cacti/log/cacti.log | grep -i 'SYSTEM STATS'

• 验证：日志 SYSTEM STATS 显示 Method:spine 且 Time 明显下降；System Utilities → View Poller Cache 条目数与 DS 数一致，图持续更新。
• 回滚：Settings → Poller 改回 cmd.php 并重启 cron/cactid；⚠️ 切换期间会漏 1~2 个采集周期，选低峰操作。

场景三：用 Weathermap 画机房链路流量图

• 目标 / 步骤：把多条 WAN 链路的带宽利用率按颜色呈现在一张拓扑图上。

# 1) 插件放 plugins/，Console → Plugin Management → Install & Enable
# 2) Weathermap Editor → Add Map 命名 <campus-map>；加 NODE，用 LINK 连接并绑定 Cacti 图形数据源
#    （填 graph id 或 RRD 路径，字段以插件版本为准）；设 BANDWIDTH 与 0-50-80-100% 色阶
# 3) 地图渲染加入 cron（插件自带重建脚本，以插件文档为准）
rrdtool fetch /var/www/html/cacti/rra/<对应.rrd> AVERAGE -s -3600 | head
# Web：Weathermap 页查看 <campus-map>，链路颜色随利用率变化

• 验证：地图 LINK 显示实时利用率与颜色；改一条链路带宽上限后颜色随之变化。
• 回滚：Plugin Management 中 Disable/Uninstall Weathermap，删 plugins/weathermap 前先备份其 configs/ 地图定义；⚠️ 插件目录删除不会动 Cacti 的 RRD 数据。

8. 日常运维与故障排查

故障「现象 → 原因 → 处置」表

9. 性能、容量与高可用

10. 安全加固、备份与升级

11. 常见坑（现象 → 原因 → 解决）

12. 速查表

13. 选型建议与同类对比

何时选：以交换机/路由器/防火墙的 SNMP 接口流量与带宽趋势为核心、需要年级历史且容量可精确控制、想要 Weathermap 链路地图、已有 LAMP/MySQL 运维能力。

何时不选：需要秒级排障或容器/云原生高基数监控（选 Netdata / Prometheus）、需要开箱即用的强告警与升级链（选 Zabbix / 夜莺）、不愿维护 PHP+MySQL+RRDtool+SNMP 整套栈、需要日志/链路统一平台。

常见组合：Cacti 负责网络设备流量长期趋势图，Zabbix/夜莺负责主机与服务告警，Grafana 做统一展示层。

14. 参考链接

• 官网：https://www.cacti.net/
• GitHub 仓库：https://github.com/Cacti/cacti
• 官方文档：https://docs.cacti.net/
• 下载页（版本号以官方最新稳定版为准）：https://www.cacti.net/info/downloads
• 通用安装说明：https://docs.cacti.net/General-Installing-Instructions.md
• CentOS/RHEL/ROCKY 安装（含 Spine）：https://docs.cacti.net/Install-Under-CentOS_LAMP.md
• 系统工具（重建 Poller Cache 等）：https://docs.cacti.net/System-Utilities.md