
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_perfn’exécute plus de commandeSET GLOBAL innodb_stats_on_metadatasilencieuse. 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 GLOBALexclut 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(de4 KiBà64 KiB), éliminant les biais sur les instances configurées hors du standard16 KiB. - Correction du faux positif
BIGINT UNSIGNED AUTO_INCREMENT(#1007) : Les tables utilisant des clés primairesBIGINT UNSIGNEDne 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 motifLIKE '%\_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 dequery_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_logdansperformance_schemaet utilisation exacte deobject_namedans 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.maxetmemory.swap.max(cgroup v2), puis se replie surmemory.limit_in_bytesetmemory.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(etMYSQLTUNER_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 etsystemd-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_openet seuilsunrpc: Ajustement des formules de recommandationfs.nr_openet 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
--noprocesset exclusion demariadbd/garbd: L’indicateur--noprocessest honoré sur toutes les branches, et les démonsmariadbdetgarbd(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
sysctlnon numériques, repli surlogical_cpu_cores, fermeture du descripteur exact et déduplication des requêtesSHOWavec retour complet deinfocmd_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 àsshpassvia la variable d’environnementSSHPASS(invisible dansps aux) ; respect de la précédencedebian.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--nocolorsur--outputfile, vérifie la taille du fichier téléchargé et valide le script téléchargé en zone de transit parperl -cavant 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 exportsmysqldumpetfragmented_tables, et remplacement deexit(256)— qui s’enroulait silencieusement à0modulo 256 sous POSIX, faisant croire à un succès CI lors d’une panne de connexion BDD ! — parexit(1). - Serveur MCP Fail-Closed et 9 Compétences IA (#78, #1010) :
build/mcp_server.pyadopte une posture fail-closed stricte sur erreur de requête BDD, appliquetarget_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 deisolated-test-guardetwindows-powershell-metrics. - Sécurité Supply Chain (#1016) : Remédiation des alertes Dependabot sur
fast-uri,brace-expansionetjs-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 enchroot/TemporaryDirectorysans 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é dansmysqltuner.pl,USAGE.mdet 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.