major /MySQLTuner-perl

MySQLTuner is a script written in Perl that will assist you with your MySQL configuration and make recommendations for increased performance and stability.

★ 9,476⑂ 1,282👁 307⑃ 475● 572▤ 23
PerlGPL-3.0Created 2009-05-29
下载:v2.9.3v2.9.3 ↓2.9.32026-10-21
+0
日增长
9,476
stars
1,282
forks
307
watchers
475
prs
572
issues
23
releases

README

!MySQLTuner-perl










MySQLTuner is a script written in Perl that allows you to review a MySQL installation quickly and make adjustments to increase performance and stability. The current configuration variables and status data is retrieved and presented in a brief format along with some basic performance suggestions.

MySQLTuner supports ~900+ indicators, KPIs, and recommendations (including Weighted Health Score, Predictive Capacity Planning, and SSL/TLS Audit) for MySQL/MariaDB/Percona Server in this latest version.

MySQLTuner is actively maintained supporting many configurations such as Galera Cluster, TokuDB, Performance schema, Linux OS metrics, InnoDB, MyISAM, Aria, ...

You can find more details on these indicators here:
Indicators description.

!MysqlTuner

Useful Links
==

 Active Development: https://github.com/major/MySQLTuner-perl
 Releases/Tags: https://github.com/major/MySQLTuner-perl/tags
 Changelog: https://github.com/major/MySQLTuner-perl/blob/master/Changelog
 Docker Images: https://hub.docker.com/repository/docker/jmrenouard/mysqltuner/tags
 Useful References: Documentation/References
 AI Agent & MCP Server Integration Guide: Documentation/AI MCP Server Guide | Guide Serveur MCP (FR) | AGENT.md
 Interactive HTML Reports (v2.9.0+):
   MariaDB 11.4 E2E HTML Report Example
   MySQL 8.4 E2E HTML Report Example
   Percona 8.0 E2E HTML Report Example

MySQLTuner needs you
===

MySQLTuner needs contributors for documentation, code and feedback:

 Please join us on our issue tracker at GitHub tracker.
 Contribution guide is available following MySQLTuner contributing guide
 Star MySQLTuner project at MySQLTuner Git Hub Project
 Paid support for LightPath here: [email protected]
 Paid support for Releem available here: Releem App

 Sponsors

Active development is sponsored by:


  
    
  


Thanks to LightPath for providing resources (dev servers, AI subscriptions, staging & features).

!jmrenouard's GitHub stats



 Star History



Compatibility
====

Test result are available here for LTS only:

 MySQL (full support)
 Percona Server (full support)
 MariaDB (full support)
 Galera replication (full support)
 Percona XtraDB cluster (full support)
 MySQL Replication (partial support, no test environment)

Thanks to endoflife.date

 Refer to MariaDB Supported versions.
 Refer to MySQL Supported versions.

Windows Support is partial

 Windows is now supported at this time
 Successfully run MySQLtuner across WSL2 (Windows Subsystem Linux)
 https://docs.microsoft.com/en-us/windows/wsl/

UNSUPPORTED ENVIRONMENTS - NEED HELP WITH THAT

Advanced Intelligence & Ecosystem

 Weighted Health Score KPI: Overall database health assessment (0-100) based on Performance (40pts), Security (30pts), and Resilience (30pts).
 Smart Migration LTS Advisor: Identification of risks when migrating to modern LTS versions (MySQL 8.4/9.0+, MariaDB 11.x), including removed variables and deprecated authentication methods.
 Predictive Capacity Planning: Me

Top issues

Latest release

v2.9.3 v2.9.3 2026-10-21
Release Notes - v2.9.3

Date: 2026-10-21

 📝 Executive Summary

text
2.9.3 2026-10-21

- chore(build): consolidate EOL and CVE scripts in pure Perl and add get_version.sh (1024)
- chore(build): standardize metadata headers across all build scripts (1029)
- feat(build): migrate release_gen.py and genFeatures.sh to pure Perl (1023)
- feat(ci): implement validate_roadmap.pl for schema and link integrity (1025)
- feat(ci): implement ci_matrix.json for centralized supported versions matrix (1027)
- feat(ci): implement validate_release.pl for unified pre-publish validation (1028)
- feat(ci): impleme

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON