major / major/MySQLTuner-perl

feat(galera): add network queue, PK certification, and split-brain quorum diagnostics

Open
#975 2 comments 0 reactions 1 assignee View on GitHub

@jmrenouard is already working on this.

Since Aug 7, 2026.

enhancement
Dominant language
Perl
Stars
9.5k
Forks
1.3k
Avg merge
9h 4m
Merged PRs (30d)
8

Description

Summary of Changes

Add new Galera Cluster diagnostic checks to mysqltuner.pl and comprehensive unit test coverage:

  1. Galera Local Send & Recv Queue Monitoring:

    • Detects elevated network queue averages (wsrep_local_send_queue_avg > 0.05 or wsrep_local_recv_queue_avg > 0.05).
    • Recommends checking network bandwidth and storage latency on slower nodes.
  2. Galera Primary Key Certification Enforcement Check:

    • Detects when wsrep_certify_non_pk is set to OFF.
    • Recommends enabling wsrep_certify_non_pk = ON to prevent replication inconsistencies and full cluster locks.
  3. Galera Split-Brain Quorum Check:

    • Warns when wsrep_cluster_size is an even number (e.g. 2 or 4 nodes) without an arbitrator.
    • Recommends an odd node count (3, 5) or deploying Galera Arbitrator (garbd) to prevent split-brain quorums.
Verification & Unit Tests
  • New dedicated unit test file: tests/unit_galera_enhanced.t (3/3 subtests passing).
  • Validated via full test suite execution (113 files, 570 subtests passing 100%).
  • Validated E2E against a live 3-node MariaDB 11.8.6 Galera Cluster topology.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.