{"id":15037270,"url":"https://github.com/major/mysqltuner-perl","last_synced_at":"2025-05-16T12:01:51.122Z","repository":{"id":580414,"uuid":"213417","full_name":"major/MySQLTuner-perl","owner":"major","description":"MySQLTuner is a script written in Perl that will assist you with your MySQL configuration and make recommendations for increased performance and stability.","archived":false,"fork":false,"pushed_at":"2025-04-12T12:38:59.000Z","size":34153,"stargazers_count":9174,"open_issues_count":40,"forks_count":1293,"subscribers_count":331,"default_branch":"master","last_synced_at":"2025-04-22T20:25:26.918Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"robyoung/go-whisper","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/major.png","metadata":{"files":{"readme":"README.fr.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2009-05-29T14:10:26.000Z","updated_at":"2025-04-22T09:10:12.000Z","dependencies_parsed_at":"2023-09-27T01:12:27.262Z","dependency_job_id":"c870bfed-3897-4a16-b427-7182e0ca0971","html_url":"https://github.com/major/MySQLTuner-perl","commit_stats":{"total_commits":1202,"total_committers":155,"mean_commits":7.754838709677419,"dds":"0.39767054908485855","last_synced_commit":"a76ec6a051a1b1e0a13d52d824bb219eb7885564"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2FMySQLTuner-perl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2FMySQLTuner-perl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2FMySQLTuner-perl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/major%2FMySQLTuner-perl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/major","download_url":"https://codeload.github.com/major/MySQLTuner-perl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252962504,"owners_count":21832313,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T20:34:04.763Z","updated_at":"2025-05-07T22:20:12.674Z","avatar_url":"https://github.com/major.png","language":"Perl","funding_links":["https://www.buymeacoffee.com/jmrenouard"],"categories":[],"sub_categories":[],"readme":"![MySQLTuner-perl](https://github.com/major/MySQLTuner-perl/blob/master/mtlogo.png)\n\n[![\"Buy Us A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/jmrenouard)\n\n[![Project Status](http://opensource.box.com/badges/active.svg)](http://opensource.box.com/badges)\n[![Project Status](http://opensource.box.com/badges/maintenance.svg)](http://opensource.box.com/badges)\n[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/major/MySQLTuner-perl.svg)](http://isitmaintained.com/project/major/MySQLTuner-perl \"Average time to resolve an issue\")\n[![Percentage of open issues](http://isitmaintained.com/badge/open/major/MySQLTuner-perl.svg)](http://isitmaintained.com/project/major/MySQLTuner-perl \"Percentage of issues still open\")\n[![GPL License](https://badges.frapsoft.com/os/gpl/gpl.png?v=103)](https://opensource.org/licenses/GPL-3.0/)\n\n**MySQLTuner** est un script écrit en Perl qui permet d'effectuer une revue de configuration pour MySQL/MAriaDB/PerconaDB rapidement et propose des ajustements pour améliorer la performance et la stabilité du serveur. L'état des variables et statuts est analysé et présenté de manière synthétique et structurée ainsi que plusieurs suggestions basiques concernant  la performance.\n\n**MySQLTuner** supporte dans a dernière version plus de ~300 indicators pour MySQL/MariaDB/Percona Server. \n\n**MySQLTuner** is maintained and indicator collect is increasing week after week supporting a lot of configuration sush as ![Galera Cluster](http://galeracluster.com/), ![TokuDB](https://www.percona.com/software/mysql-database/percona-tokudb), ![                                                                                                                         Performance schema](https://github.com/mysql/mysql-sys), Linux OS metrics, ![InnoDB](http://dev.mysql.com/doc/refman/5.7/en/innodb-storage-engine.html), ![MyISAM](http://dev.mysql.com/doc/refman/5.7/en/myisam-storage-engine.html), ![Aria](https://mariadb.com/kb/en/mariadb/aria/), ... \n\nYou can found more details on this indicators \n![Indicators description](https://github.com/major/MySQLTuner-perl/blob/master/INTERNALS.md).\n\n\n![MysqlTuner](https://github.com/major/MySQLTuner-perl/blob/master/mysqltuner.png)\n\nMySQLTuner needs you:\n===\n\n**MySQLTuner** needs contributors for documentation, code and feedbacks..\n\n* Please join us on issue track at [GitHub tracker](https://github.com/major/MySQLTuner-perl/issues)\u003c/a\u003e.\n* Contribution guide is avalaible following [MySQLTuner contributing guide](https://github.com/major/MySQLTuner-perl/blob/master/CONTRIBUTING.md)\n* Star **MySQLTuner project** at [MySQLTuner Git Hub Project](https://github.com/major/MySQLTuner-perl)\n          \nCompatibility:\n====\n\n* MySQL 5.7 (full support)\n* MySQL 5.6 (full support)\n* MySQL 5.5 (full support)\n* MariaDB 10.1 (full support)\n* MariaDB 10.0 (full support)\n* Percona Server 5.6 (full support)\n* Percona XtraDB cluster (full support)\n* MySQL 3.23, 4.0, 4.1, 5.0, 5.1 (partial support - deprecated version)\n* Perl 5.6 or later (with [perl-doc](http://search.cpan.org/~dapm/perl-5.14.4/pod/perldoc.pod) package)\n* Unix/Linux based operating system (tested on Linux, BSD variants, and Solaris variants)\n* Windows is not supported at this time (Help wanted !!!!!)\n* Unrestricted read access to the MySQL server (OS root access recommended for MySQL \u003c 5.1)\n* CVE vulnerabilites detection support from [https://cve.mitre.org](https://cve.mitre.org)\n\n***WARNING***\n--\nIt is **extremely important** for you to fully understand each change \nyou make to a MySQL database server.  If you don't understand portions \nof the script's output, or if you don't understand the recommendations, \n**you should consult** a knowledgeable DBA or system administrator \nthat you trust.  **Always** test your changes on staging environments, and \nalways keep in mind that improvements in one area can **negatively affect** \nMySQL in other areas.\n\n**Seriously - please review the FAQ section below.**\n\nWhat MySQLTuner is checking exactly ? \n--\nAll checks done by **MySQLTuner** are documented in [MySQLTuner Internals](https://github.com/major/MySQLTuner-perl/blob/master/INTERNALS.md) documentation.\n\nDownload/Installation\n--\n\nYou can download the entire repository by using 'git clone' followed by the cloning URL above. The simplest and shortest method is:\n\n\twget http://mysqltuner.pl/ -O mysqltuner.pl\n\twget https://raw.githubusercontent.com/major/MySQLTuner-perl/master/basic_passwords.txt -O basic_passwords.txt\n\twget https://raw.githubusercontent.com/major/MySQLTuner-perl/master/vulnerabilities.csv -O vulnerabilities.csv\n\tperl mysqltuner.pl\n\t\nOf course, you can add the execute bit (`chmod +x mysqltuner.pl`) so you can execute it without calling perl directly.\n\nSpecific usage\n--\n\n__Usage:__ Minimal usage locally\n\n\tperl mysqltuner.pl \n\n__Usage:__ Minimal usage remotely\n\n\tperl mysqltuner.pl --host targetDNS_IP --user admin_user --pass admin_password\n\n__Usage:__ Enable maximum output information around MySQL/MariaDb without debugging \n\n\tperl mysqltuner.pl --verbose\n\tperl mysqltuner.pl --buffers --dbstat --idxstat --sysstat --pfstat\n\t\n\n__Usage:__ Enable CVE vulnerabilities check for your MariaDB or MySQL version\n\n\tperl mysqltuner.pl --cvefile=vulnerabilities.csv\n\n__Usage:__ Write your result in a file with information displayed  \n\n\tperl mysqltuner.pl --outputfile /tmp/result_mysqltuner.txt\n\n__Usage:__ Write your result in a file **without outputting information** \n\n\tperl mysqltuner.pl --silent --outputfile /tmp/result_mysqltuner.txt\n\n__Usage:__ Using template model to customize your reporting file based on [Text::Template](https://metacpan.org/pod/Text::Template) syntax.\n\n \tperl mysqltuner.pl --silent --reportfile /tmp/result_mysqltuner.txt --template=/tmp/mymodel.tmpl\n\n__Usage:__ Enable debugging information \n\n\tperl mysqltuner.pl --debug\n\nFAQ\n--\n\n**Question: Will MySQLTuner fix my slow MySQL server?**\n\n**No.**  MySQLTuner is a read only script.  It won't write to any configuration files, change the status of any daemons, or call your mother to wish her a happy birthday.  It will give you an overview of your server's performance and make some basic recommendations about improvements that you can make after it completes.  *Make sure you read the warning above prior to following any recommendations.*\n\n**Question: Can I fire my DBA now?**\n\n**MySQLTuner will not replace your DBA in any form or fashion.**  If your DBA constantly takes your parking spot and steals your lunch from the fridge, then you may want to consider it - but that's your call.\n\n**Question: Why does MySQLTuner keep asking me the login credentials for MySQL over and over?**\n\nThe script will try its best to log in via any means possible.  It will check for ~/.my.cnf files, Plesk password files, and empty password root logins.  If none of those are available, then you'll be prompted for a password.  If you'd like the script to run in an automated fashion without user intervention, then create a .my.cnf file in your home directory which contains:\n\n\t[client]\n\tuser=someusername\n\tpass=thatuserspassword\n\t\nOnce you create it, make sure it's owned by your user and the mode on the file is 0600.  This should prevent the prying eyes from getting your database login credentials under normal conditions.  If a [T-1000 shows up in a LAPD uniform](https://en.wikipedia.org/wiki/T-1000) and demands your database credentials, you won't have much of an option.\n\n**Question: Is there another way to secure credentials on latest MySQL and MariaDB distributions ?**\n\nYou could use mysql_config_editor utilities.\n\n\t$ mysql_config_editor set --login-path=client --user=someusername --password --host=localhost\n\tEnter passord: ********\n\t$\n\nAt this time, ~/.mylogin.cnf has been written with appropriated rigth access.\n\nTo get information about stored credentials, use the following command:\n\n\t$mysql_config_editor print\n\t[client]\n\tuser = someusername\n\tpassword = *****\n\thost = localhost\n\n**Question: What's minimum privileges needed by a specific mysqltuner user in database ?**\n\n        mysql\u003eGRANT SELECT, PROCESS,EXECUTE, REPLICATION CLIENT,SHOW DATABASES,SHOW VIEW ON *.* FOR 'mysqltuner'@'localhost' identified by pwd1234;\n\n**Question: It's not working on my OS! What gives?!**\n\nThese kinds of things are bound to happen.  Here are the details I need from you in order to research the problem thoroughly:\n\n* OS and OS version\n* Architecture (x86, x86_64, IA64, Commodore 64)\n* Exact MySQL version\n* Where you obtained your MySQL version (OS package, source, etc)\n* The full text of the error\n* A copy of SHOW VARIABLES and SHOW GLOBAL STATUS output (if possible)\n\n**Question: How to perform a CVE vulneralibity checks ?**\n\n* Download vulnerabilities.csv from this repository.\n* use option --cvefile to perform CVE checks\n\n**Question: How to use mysqltuner from remote host ?**\nThanks to  [@rolandomysqldba](http://dba.stackexchange.com/users/877/rolandomysqldba)\n\n* You will still have to connect like a mysql client:\n\nConnection and Authentication\n\n\t--host \u003chostname\u003e Connect to a remote host to perform tests (default: localhost)\n\t--socket \u003csocket\u003e Use a different socket for a local connection\n\t--port \u003cport\u003e     Port to use for connection (default: 3306)\n\t--user \u003cusername\u003e Username to use for authentication\t\n\t--pass \u003cpassword\u003e Password to use for authentication\n\t--defaults-file \u003cpath\u003e defaulfs file for credentials\n\nSince you are using a remote host, use parameters to supply values from the OS\n\n\t--forcemem \u003csize\u003e  Amount of RAM installed in megabytes\n\t--forceswap \u003csize\u003e Amount of swap memory configured in megabytes\n\n* You may have to contact your remote SysAdmin to ask how much RAM and swap you have\n\nIf the database has too many tables, or very large table, use this:\n\n\t--skipsize           Don't enumerate tables and their types/sizes (default: on)\n\t                     (Recommended for servers with many tables)\n\nMySQLTuner and Vagrant\n--\n**MySQLTuner** contains following Vagrant configurations:\n* Fedora Core 23 / MariaDB 10.0\n* Fedora Core 23 / MariaDB 10.1\n* Fedora Core 23 / MySQL 5.6\n* Fedora Core 23 / MySQL 5.7\n       \n**Vagrant File** are stored in Vagrant subdirectory. \n* Follow this 2 steps after vagrant installation:\n* Rename VagrantFile_for_Mxxx into Vagrantfile\n* vagrant up\n\n**MySQLTuner** contains a Vagrant configurations for test purpose and development\n* Install VirtualBox and Vagrant\n\t* https://www.virtualbox.org/wiki/Downloads\n\t* https://www.vagrantup.com/downloads.html\n* Clone repository\n \t* git clone https://github.com/major/MySQLTuner-perl.git\n* Install Vagrant plugins vagrant-hostmanager and  vagrant-vbguest\n\t* vagrant plugin install vagrant-hostmanager\n\t* vagrant plugin install vagrant-vbguest\n* Add Fedora Core 23 box for official Fedora Download Website\n\t* vagrant box add --name fc23 https://download.fedoraproject.org/pub/fedora/linux/releases/23/Cloud/x86_64/Images/Fedora-Cloud-Base-Vagrant-23-20151030.x86_64.vagrant-virtualbox.box\n* Create a data directory\n\t* mkdir data\n* Rename Vagrantfile_MariaDB10.0 into Vagrantfile\n\t* cp MySQLTuner-perl/Vagrant/Vagrantfile_for_MariaDB10.0 Vagrantfile\n* Start vagrant\n\t* vagrant up\n\nMySQLTuner a besoin de vous\n--\n**MySQLTuner** a besoin de contributeurs pour la documentation, le code, des tests et des retours d'expérience.\n\n* Rejoignez-nous sur le suivi de ticket à [GitHub tracker](https://github.com/major/MySQLTuner-perl/issues)\u003c/a\u003e.\n* Le guide de contribution en anglais est disponible ici [MySQLTuner contributing guide](https://github.com/major/MySQLTuner-perl/blob/master/CONTRIBUTING.md)\n* Ajouter une étoile à **MySQLTuner project** ici [MySQLTuner Git Hub Project](https://github.com/major/MySQLTuner-perl)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmajor%2Fmysqltuner-perl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmajor%2Fmysqltuner-perl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmajor%2Fmysqltuner-perl/lists"}