MySQLTuner v2.9.4 : 1 125 Indicateurs, Télémétrie Conteneurs Cgroup v2, Zéro Mutation en Production et Contrat JSON::PP

Architecture MySQLTuner v2.9.4 - Moteur Zéro-Mutation, Conteneurs Cgroup v2 et JSON::PP

Auditer une base de données transactionnelle en production exige deux garanties non négociables : ne jamais altérer l’état du serveur observé et mesurer les limites matérielles réelles de l’environnement d’exécution, qu’il s’agisse d’un nœud bare-metal Linux, d’un conteneur Kubernetes borné par cgroups ou d’une instance Windows Server.

Publiée le 16 novembre 2026 (36 commits sur 148 fichiers, 19 565 lignes de Perl pur sans dépendance CPAN externe), la version MySQLTuner v2.9.4 franchit un cap décisif sur la sûreté opérationnelle, la précision du diagnostic haute disponibilité et la portabilité stricte en environnement isolé (Air-Gapped).

Métrique de Couverture Valeur v2.9.4 Progression vs v2.9.3 Catégorie
Indicateurs Totaux 1 125 +33 Couverture globale
Vérifications d’Efficacité 165 +4 Ratios & journaux
Détections de Risques 322 +10 Sécurité, réplication & OS
Points d’Information 582 +10 Topologie & télémétrie
Recommandations Actionnables 56 +9 Réglages & remédiation

1. Sûreté Zéro-Mutation en Production, Calculs InnoDB & Auditeurs Connectés

En environnement critique, un outil d’audit ne doit jamais modifier silencieusement une variable globale sous le prétexte d’accélérer sa propre collecte, ni proposer des requêtes SET GLOBAL inapplicables en production.

A. Fin de la Mutation Silencieuse dans check_metadata_perf et Filtrage SET GLOBAL

  • Suppression de l’écriture implicite (#1022) : La sous-routine check_metadata_perf n’exécute plus de commande SET GLOBAL innodb_stats_on_metadata silencieuse. Lorsque le paramètre est actif (ON), MySQLTuner signale l’anomalie et pousse une recommandation en lecture seule (SET innodb_stats_on_metadata = OFF) dans @adjvars.
  • Garde-fous sur l’auto-remédiation (#1027, #78) : La génération dynamique de directives SET GLOBAL exclut désormais strictement les variables en lecture seule, les paramètres statiques exigeant un redémarrage et les clés à notation par point, tout en formatant correctement les valeurs SQL générées.
  • Validation stricte de --feature (#78) : L’option --feature <nom> vérifie désormais l’argument par rapport à une liste blanche de sous-routines autorisées et échoue explicitement en cas d’entrée invalide (Unknown or disallowed feature: $feature).

B. Dimensionnement InnoDB innodb_page_size, BIGINT UNSIGNED et Requêtes BASE TABLE

  • Calcul exact par taille de page InnoDB (#1026) : L’évaluation mémoire du Buffer Pool utilise désormais la valeur réelle de innodb_page_size (de 4 KiB à 64 KiB), éliminant les biais sur les instances configurées hors du standard 16 KiB.
  • Correction du faux positif BIGINT UNSIGNED AUTO_INCREMENT (#1007) : Les tables utilisant des clés primaires BIGINT UNSIGNED ne déclenchent plus d’alerte erronée de saturation imminente d’auto-incrément.
  • Précision du schéma et cache de requêtes (#1029, #1030, #1034, #1037, #78) :
  • Filtrage des contrôles structurels et de clés étrangères aux seules tables de base (TABLE_TYPE = 'BASE TABLE'), échappement strict du motif LIKE '%\_id', déduplication des comptages sur clés primaires composites et suppression d’une requête redondante de vérification des clés étrangères.
  • Correction d’un bug d’opérateur binaire | remplacé par l’opérateur logique || sur l’audit de query_cache_type.
  • Mise en cache des résultats Performance Schema et Galera GCache, préchargement des tables à colonnes virtuelles, correction du tri/sévérité sur error_log dans performance_schema et utilisation exacte de object_name dans l’analyse des attentes d’index.

C. Connexion des 4 Sous-Routines d’Audit dans le Flux Principal (#1038)

Les quatre moteurs spécialisés introduits dans le cycle 2.9.x sont désormais câblés et exécutés de bout en bout dans la chaîne d’audit :
1. audit_pfs_stage_profiling (profilage des stages SQL Performance Schema) ;
2. audit_innodb_ahi (efficacité et partitionnement de l’Adaptive Hash Index) ;
3. audit_tls_ciphers_protocols (protocoles TLS et suites cryptographiques) ;
4. audit_table_definition_cache (évictions et thrashing du cache de définitions).


2. Haute Disponibilité : Réplication NULL Lag & Contexte Galera %mystat

Une réplication en panne renvoie souvent Seconds_Behind_Source = NULL. Un parser qui confond NULL avec 0 masque un arrêt critique de synchronisation.

A. Détection Explicite des Threads IO / SQL Stoppés et du Retard Inconnu (#78)

MySQLTuner v2.9.4 distingue désormais un retard nul d’un retard indéterminé et valide séparément l’état des deux threads de réplication :

[!!] Replication lag analysis: IO thread is stopped or unhealthy ($replica_io_running). Check network or source availability.
[!!] Replication lag analysis: SQL thread is stopped or unhealthy ($replica_sql_running). Check replication errors.
[!!] Replication lag analysis: Replication lag is NULL/unknown. Check replica thread status.
[!!] This replication replica has unknown lag ($seconds_behind_replica).

De plus, le parsing de SHOW REPLICA HOSTS gère désormais proprement le format tabulé renvoyé par le client MySQL/MariaDB en mode batch.

B. Télémétrie Galera Cluster via %mystat (#1033)

La lecture de l’état Galera / Percona XtraDB Cluster s’appuie désormais directement sur les compteurs de statut %mystat, corrige la résolution de contexte wsrep et fiabilise l’identification des types d’index dans les métadonnées.


3. Conteneurs Cgroup v2/v1, Précision Linux Sysctl & Windows PowerShell CIM

Exécuter un audit MySQL à l’intérieur d’un conteneur Docker, Podman ou Kubernetes en lisant /proc/meminfo de l’hôte produit des recommandations catastrophiques : MySQLTuner préconiserait un Buffer Pool basé sur les 256 Go de l’hyperviseur pour un pod limité à 8 Go, provoquant un OOMKill immédiat.

A. Sonde Cgroup v2/v1 & Mode Conteneur Silencieux (#78)

  • Détection mémoire et swap cgroup v2 puis v1 : MySQLTuner interroge en priorité /sys/fs/cgroup/memory.max et memory.swap.max (cgroup v2), puis se replie sur memory.limit_in_bytes et memory.memsw.limit_in_bytes (cgroup v1), aussi bien en exécution locale qu’à travers un transport distant.
  • Isolation par variables d’environnement : Prise en charge de MYSQLTUNER_PROC_MEMINFO (et MYSQLTUNER_CGROUP_DIR) pour garantir des tests déterministes sans muter le système hôte.
  • Suppression du bruit système et détection des journaux cloud/systemd : En mode conteneur, les sondes réseau, processus hôtes, systèmes de fichiers (lsblk) et paramètres noyau inutiles sont court-circuitées (Skipping host network, process, filesystem, and kernel probes in container mode.), tandis que deux nouveaux indicateurs vérifient l’existence des journaux cloud et systemd-journald (Log from cloud $myvar{'log_error'} exists, Log journal $myvar{'log_error'} exists).

B. Fiabilisation des Sondes Linux OS, Sysctl & Mémoire Processus (#1024, #1031, #1032, #78)

  • Correction fs.nr_open et seuil sunrpc : Ajustement des formules de recommandation fs.nr_open et ajout d’une alerte spécifique lorsque les slots TCP RPC initiaux sont sous-dimensionnés (Initial TCP slot entries is < 100, please consider having a value greater than 100).
  • Respect strict de --noprocess et exclusion de mariadbd/garbd : L’indicateur --noprocess est honoré sur toutes les branches, et les démons mariadbd et garbd (arbitre Galera) sont correctement exclus du calcul de mémoire consommée par les processus tiers.
  • Garde-fous systèmes de fichiers : Ancrage strict des filtres de points de montage, protection contre les disques de taille nulle et les valeurs sysctl non numériques, repli sur logical_cpu_cores, fermeture du descripteur exact et déduplication des requêtes SHOW avec retour complet de infocmd_tab.

C. Modernisation Complète de la Télémétrie Windows (#992, #1025, #1028)

Microsoft ayant retiré wmic.exe des builds récents de Windows 11 et Windows Server, MySQLTuner v2.9.4 bascule vers PowerShell CIM (Get-CimInstance) sur Win32_Processor et Win32_ComputerSystem (avec repli automatique vers wmic), corrige la mise à l’échelle de FreeVirtualMemory vers les octets réels (avec gestion sûre d’un swap nul) et protège l’appel POSIX getpwuid dans setup_environment.


4. Portabilité Pure JSON::PP, Contrat --list-indicators & Sécurité MCP / SSH

A. Migration vers Core JSON::PP : Zéro Dépendance CPAN Même pour --comparefile (#78, #1046)

Jusqu’en v2.9.3, certaines branches d’export ou de comparaison historique pouvaient encore dépendre du module non-core JSON. La version v2.9.4 migre intégralement la sérialisation et la comparaison (--comparefile, avec alignement des clés historiques) vers le module standard JSON::PP, livré nativement avec Perl depuis Perl 5.14 :
* Si JSON::PP fait défaut dans une distribution minimale tronquée, un diagnostic explicite est levé (JSON::PP module required for comparison analysis.).
* La sentinelle de conformité (check_compliance.pl) bannit désormais tout import JSON non-core.
* L’option --agent-json combinée à --outputfile produit désormais un export JSON propre sans fuite vers la sortie standard.

B. Nouveau Contrat CLI Hors-Ligne : --list-indicators (#1046)

Sans établir aucune connexion à une base de données, les pipelines CI/CD et les orchestrateurs IA peuvent désormais extraire la totalité du catalogue de mysqltuner.pl (les 1 125 indicateurs, les options de %CLI_METADATA et la liste des sous-routines --feature) sous forme de JSON canonique :

perl mysqltuner.pl --list-indicators > mysqltuner_catalog_v294.json

C. Durcissement des Transports SSH, de l’Auto-Mise à Jour, des Exports & du Serveur MCP

  • Sécurité SSH et échappement (#1023, #78) : Échappement strict des métacaractères shell et SQL dans select_one, les options d’authentification, les arguments conteneur/SSH et les fichiers de configuration ; prise en charge autonome de --ssh-host ; passage du mot de passe à sshpass via la variable d’environnement SSHPASS (invisible dans ps aux) ; respect de la précédence debian.cnf ; et saut des vérifications locales lorsque la cible est distante.
  • Vérification syntaxique avant auto-mise à jour (#1035, #78) : La mise à jour (update_tuner_version) préserve --nocolor sur --outputfile, vérifie la taille du fichier téléchargé et valide le script téléchargé en zone de transit par perl -c avant tout remplacement.
  • Assainissement HTML / CSV et hygiène POSIX (#78) : Échappement des balises <script> dans les rapports HTML, échappement rigoureux des guillemets et fin de ligne garantie dans les exports CSV, isolation des exports mysqldump et fragmented_tables, et remplacement de exit(256) — qui s’enroulait silencieusement à 0 modulo 256 sous POSIX, faisant croire à un succès CI lors d’une panne de connexion BDD ! — par exit(1).
  • Serveur MCP Fail-Closed et 9 Compétences IA (#78, #1010) : build/mcp_server.py adopte une posture fail-closed stricte sur erreur de requête BDD, applique target_ram_percentage, verrouille ses écritures atomiques de cache et durcit la sanitisation SQL. Le catalogue .agent/skills/ compte désormais 9 compétences avec l’ajout de isolated-test-guard et windows-powershell-metrics.
  • Sécurité Supply Chain (#1016) : Remédiation des alertes Dependabot sur fast-uri, brace-expansion et js-yaml.

5. Matrice Moteurs 2026 (MySQL 26.10 & MariaDB 13.0), 238 Suites de Tests & Gouvernance

A. Gating is_mariadb et Support de MySQL 26.10 (#75, #78)

Avec la nouvelle numérotation calendaire de MySQL (26.10), toute comparaison numérique naïve du type version >= 10 risquait de confondre MySQL 26.10 avec une branche MariaDB 10.x+. La v2.9.4 introduit un verrouillage strict via is_mariadb dans toutes les conditions dépendantes du moteur et synchronise build/ci_matrix.json avec endoflife.date :

Moteur SGBD Branches LTS Supportées Court Terme (STS) Legacy Supporté
MySQL 8.4 LTS, 9.7 LTS 26.10 8.0
MariaDB 10.11 LTS, 11.4 LTS, 11.8 LTS, 12.3 LTS 13.0 —

B. 238 Suites de Tests Hermétiques, Lint Documentaire CI & Traductions Synchronisées

  • De 153 à 238 fichiers de tests automatisés : La couverture d’ingénierie passe à 189 fichiers de tests Perl (.t) et 49 suites Python (.py), intégrant des tests de non-régression pour chaque correctif d’audit, une isolation stricte des tests en chroot / TemporaryDirectory sans mutation de l’arbre source (#1010, #78), et des tests unitaires pour le harnais de laboratoire (parallel_test.sh / test_envs.sh).
  • Parité POD / CLI / Documentation en CI (doc-lint, #1039, #1044, #1042) : Un nouveau job CI vérifie automatiquement l’alignement entre %CLI_METADATA, le POD embarqué dans mysqltuner.pl, USAGE.md et les invariants SHA-256 des artefacts de release.
  • Harmonisation GPLv3 & Documentation 5 Langues (#1041, #1045, #1048) : Résolution des conflits de licence vers GPLv3, ajout de la traduction vietnamienne (README.vi.md) et synchronisation automatisée des 5 README (EN, FR, IT, RU, VI).

6. Installer ou Mettre à Jour vers MySQLTuner v2.9.4

Téléchargement direct et exécution immédiate sans aucune dépendance externe :

wget http://mysqltuner.pl/ -O mysqltuner.pl
chmod +x mysqltuner.pl
./mysqltuner.pl

Exemples d’exploitation en pipeline automatisé, conteneur et intégration IA :

# 1. Exporter le catalogue JSON des 1 125 indicateurs hors ligne
perl mysqltuner.pl --list-indicators > indicators_v294.json

# 2. Auditer un conteneur Docker/Podman avec détection automatique cgroup v2/v1
perl mysqltuner.pl --container mysql_prod_01

# 3. Générer un plan de remédiation JSON avec rollback SQL pour agent IA / MCP
perl mysqltuner.pl --agent-json --outputfile=audit_v294.json

# 4. Exécuter via l'image Docker officielle synchronisée v2.9.4
docker pull jmrenouard/mysqltuner:latest
  • Release officielle & sommes SHA-256 : github.com/major/MySQLTuner-perl/releases/tag/v2.9.4
  • Audit Flash DBRE & Sécurité CIS (LightPath) : Besoin d’un diagnostic complet de vos clusters MySQL/MariaDB/PostgreSQL avec scripts de rollback validés et réduction de facture Cloud sous 10 jours ouvrés ? Retrouvez notre approche sur lightpath.fr.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. Découvrez comment les données de vos commentaires sont traitées.