Topologie Dot3

概述

Dot3 是 PmaControl 的拓扑映射引擎。它通过 Graphviz 自动生成整个 MariaDB / MySQL 基础设施的交互式 SVG 地图。

• 单机服务器、主从、Galera、InnoDB Cluster
• 代理：ProxySQL、MaxScale、HAProxy
• VIP 服务器及故障切换历史
• Galera 仲裁节点（garb）作为虚拟节点
• 可配置的语义着色

执行

# Génération via CLI
php /srv/www/pmacontrol/glial dot3 run

# Reconstruction historique à une date donnée
php /srv/www/pmacontrol/glial dot3 run "2026-01-15 14:30:00"

Dot3 也可以通过 Web 界面执行。拓扑图会被缓存（MD5 存储在 dot3_information 中），仅在基础设施发生变化时才重新生成。

分组与子图

Dot3 将服务器组织为 Graphviz 分组：

• Galera Cluster — 每个集群一个子图，含 wsrep 段
• Master/Slave — 复制链路及其状态（OK、delay、stopped、error）
• ProxySQL — Hostgroups 及其状态（online、shunned、offline）
• MaxScale — 服务与后端
• InnoDB Cluster — Primary/Replica 及 group_replication_*
• VIP — 当前目标（实线）和前一个（虚线）

图例与颜色

颜色可在 dot3_legend 表中配置。颜色代码类型：

• NODE_* — 服务器状态（OK、KO、UNKNOWN）
• GALERA_* — Galera 状态（SYNCED、DONOR、DESYNCED、JOINER、DISCONNECTED）
• SEGMENT_* — wsrep 段（OK、KO、PARTIAL）
• REPLICATION_* — 复制（OK、DELAY、STOPPED、ERROR_SQL、ERROR_IO、BUG、BLACKOUT）
• PROXYSQL_* — ProxySQL（ONLINE、SHUNNED、OFFLINE_SOFT、OFFLINE_HARD、MIRRORING）
• MAXSCALE_* — MaxScale（RUNNING、DOWN、UNSYNC）