PmaControl logo PmaControl
Documentation › Topologie Dot3

Topologie Dot3

Présentation

Dot3 est le moteur de cartographie de PmaControl. Il génère automatiquement une carte SVG interactive de toute votre infrastructure MariaDB / MySQL via Graphviz.

  • Serveurs standalone, master/slave, Galera, InnoDB Cluster
  • Proxies : ProxySQL, MaxScale, HAProxy
  • Serveurs VIP avec historique de basculement
  • Arbitre Galera (garb) en nœud virtuel
  • Coloration sémantique configurable

Exécution

# 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 peut aussi être exécuté via l'interface web. La topologie est mise en cache (MD5 dans dot3_information) et regénérée uniquement si l'infrastructure a changé.

Groupes et sous-graphes

Dot3 organise les serveurs en groupes Graphviz :

  • Galera Cluster — Sous-graphe par cluster, avec segments wsrep
  • Master/Slave — Liens de réplication avec état (OK, delay, stopped, error)
  • ProxySQL — Hostgroups avec état (online, shunned, offline)
  • MaxScale — Services et backends
  • InnoDB Cluster — Primary/Replica avec group_replication_*
  • VIP — Destination courante (trait plein) et précédente (pointillés)

Légende et couleurs

Les couleurs sont configurables dans la table dot3_legend. Types de codes couleur :

  • NODE_* — État du serveur (OK, KO, UNKNOWN)
  • GALERA_* — État Galera (SYNCED, DONOR, DESYNCED, JOINER, DISCONNECTED)
  • SEGMENT_* — Segments wsrep (OK, KO, PARTIAL)
  • REPLICATION_* — Réplication (OK, DELAY, STOPPED, ERROR_SQL, ERROR_IO, BUG, BLACKOUT)
  • PROXYSQL_* — ProxySQL (ONLINE, SHUNNED, OFFLINE_SOFT, OFFLINE_HARD, MIRRORING)
  • MAXSCALE_* — MaxScale (RUNNING, DOWN, UNSYNC)