Skip to content

README.ru.md

Latest commit

 

History

History
658 lines (451 loc) · 39 KB

README.ru.md

File metadata and controls

658 lines (451 loc) · 39 KB

MySQLTuner-perl

"Купите нам кофе"

Статус проекта Статус тестов Среднее время решения проблемы Процент открытых проблем Лицензия GPL

MySQLTuner — это скрипт, написанный на Perl, который позволяет быстро просмотреть установку MySQL и внести коррективы для повышения производительности и стабильности. Текущие переменные конфигурации и данные о состоянии извлекаются и представляются в кратком формате вместе с некоторыми основными предложениями по производительности.

MySQLTuner поддерживает около 300 индикаторов и KPI (включая средневзвешенный показатель здоровья) для MySQL/MariaDB/Percona Server в этой последней версии.

MySQLTuner активно поддерживается и поддерживает множество конфигураций, таких как кластер Galera, TokuDB, схема производительности, метрики ОС Linux, InnoDB, MyISAM, Aria, ...

Более подробную информацию об этих индикаторах можно найти здесь: Описание индикаторов.

MysqlTuner

Полезные ссылки

MySQLTuner нуждается в вас

MySQLTuner нуждается в участниках для документации, кода и обратной связи:

Статистика GitHub Анурага

Звездочеты с течением времени

Звездочеты с течением времени

Совместимость

Результаты тестов доступны здесь только для LTS:

  • MySQL (полная поддержка)
  • Percona Server (полная поддержка)
  • MariaDB (полная поддержка)
  • Репликация Galera (полная поддержка)
  • Кластер Percona XtraDB (полная поддержка)
  • Репликация MySQL (частичная поддержка, нет тестовой среды)

Спасибо endoflife.date

Поддержка Windows частична

НЕПОДДЕРЖИВАЕМЫЕ СРЕДЫ - НУЖНА ПОМОЩЬ

Расширенная аналитика и экосистема

  • KPI средневзвешенного показателя здоровья: общая оценка состояния базы данных на основе производительности, безопасности и отказоустойчивости.
  • Советник по интеллектуальной миграции LTS: выявление рисков при миграции на современные версии LTS (MySQL 8.4/9.0+, MariaDB 11.x).
  • Прогнозное планирование мощностей: анализ запаса памяти и прогнозирование роста дискового пространства.
  • Облачное обнаружение: нативная поддержка AWS RDS/Aurora, GCP Cloud SQL, Azure (Flexible/Managed) и DigitalOcean.

Неподдерживаемые механизмы хранения: приветствуются PR

  • NDB не поддерживается, не стесняйтесь создавать запрос на включение
  • Архив
  • Паук
  • ColummStore
  • Подключить

Неподдерживаемые вещи из MySQL или MariaDB

  • MyISAM слишком стар и больше не активен

  • RockDB больше не поддерживается

  • TokuDB больше не поддерживается

  • XtraDB больше не поддерживается

  • Поддержка обнаружения уязвимостей CVE от https://cve.mitre.org

МИНИМАЛЬНЫЕ ТРЕБОВАНИЯ

  • Perl 5.6 или новее (с пакетом perl-doc)
  • Операционная система на базе Unix/Linux (протестировано на Linux, вариантах BSD и вариантах Solaris)
  • Неограниченный доступ на чтение к серверу MySQL (см. Привилегии ниже)

ПРИВИЛЕГИИ

Для запуска MySQLTuner со всеми функциями требуются следующие привилегии:

MySQL 8.0+:

GRANT SELECT, PROCESS, SHOW DATABASES, EXECUTE, REPLICATION SLAVE, REPLICATION CLIENT, SHOW VIEW ON *.* TO 'mysqltuner'@'localhost';

MariaDB 10.5+:

GRANT SELECT, PROCESS, SHOW DATABASES, EXECUTE, BINLOG MONITOR, SHOW VIEW, REPLICATION MASTER ADMIN, SLAVE MONITOR ON *.* TO 'mysqltuner'@'localhost';

Старые версии:

GRANT SELECT, PROCESS, EXECUTE, REPLICATION CLIENT, SHOW DATABASES, SHOW VIEW ON *.* TO 'mysqltuner'@'localhost';

Рекомендуется доступ root к ОС для MySQL < 5.1

ПРЕДУПРЕЖДЕНИЕ

Важно, чтобы вы полностью понимали каждое изменение , которое вы вносите в сервер базы данных MySQL. Если вы не понимаете части выходных данных скрипта или если вы не понимаете рекомендации, вам следует проконсультироваться с осведомленным администратором баз данных или системным администратором , которому вы доверяете. Всегда тестируйте свои изменения в промежуточных средах и всегда помните, что улучшения в одной области могут неблагоприятно повлиять на MySQL в других областях.

Также важно подождать не менее 24 часов безотказной работы, чтобы получить точные результаты. Фактически, запуск mysqltuner на только что перезапущенном сервере совершенно бесполезен.

Также ознакомьтесь с разделом часто задаваемых вопросов ниже.

Рекомендации по безопасности

Привет, пользователь directadmin! Мы обнаружили, что вы запускаете mysqltuner с учетными данными da_admin, взятыми из /usr/local/directadmin/conf/my.cnf, что может привести к раскрытию пароля! Подробнее читайте по ссылке Проблема №289.

Что именно проверяет MySQLTuner?

Все проверки, выполняемые MySQLTuner, задокументированы в документации MySQLTuner Internals.

Скачивание/установка

Выберите один из этих методов:

  1. Прямая загрузка скрипта (самый простой и короткий метод):
wget http://mysqltuner.pl/ -O mysqltuner.pl
wget https://raw.githubusercontent.com/jmrenouard/MySQLTuner-perl/master/basic_passwords.txt -O basic_passwords.txt
wget https://raw.githubusercontent.com/jmrenouard/MySQLTuner-perl/master/vulnerabilities.csv -O vulnerabilities.csv
  1. Вы можете загрузить весь репозиторий, используя git clone или git clone --depth 1 -b master, за которым следует URL-адрес клонирования выше.

Необязательная установка Sysschema для MySQL 5.6

Sysschema устанавливается по умолчанию в MySQL 5.7 и MySQL 8 от Oracle. По умолчанию в MySQL 5.6/5.7/8 схема производительности включена. Для предыдущей версии MySQL 5.6 вы можете выполнить следующую команду, чтобы создать новую базу данных sys, содержащую очень полезное представление о схеме производительности:

Sysschema для старой версии MySQL

curl "https://codeload.github.com/mysql/mysql-sys/zip/master" > sysschema.zip
# проверьте zip-файл
unzip -l sysschema.zip
unzip sysschema.zip
cd mysql-sys-master
mysql -uroot -p < sys_56.sql

Sysschema для старой версии MariaDB

curl "https://github.com/FromDual/mariadb-sys/archive/refs/heads/master.zip" > sysschema.zip
# проверьте zip-файл
unzip -l sysschema.zip
unzip sysschema.zip
cd mariadb-sys-master
mysql -u root -p < ./sys_10.sql

Настройка схемы производительности

По умолчанию performance_schema включен, а sysschema установлен в последней версии.

По умолчанию в MariaDB схема производительности отключена (MariaDB<10.6).

Рассмотрите возможность активации схемы производительности в вашем файле конфигурации my.cnf:

[mysqld]
performance_schema = on
performance-schema-consumer-events-statements-history-long = ON
performance-schema-consumer-events-statements-history = ON
performance-schema-consumer-events-statements-current = ON
performance-schema-consumer-events-stages-current=ON
performance-schema-consumer-events-stages-history=ON
performance-schema-consumer-events-stages-history-long=ON
performance-schema-consumer-events-transactions-current=ON
performance-schema-consumer-events-transactions-history=ON
performance-schema-consumer-events-transactions-history-long=ON
performance-schema-consumer-events-waits-current=ON
performance-schema-consumer-events-waits-history=ON
performance-schema-consumer-events-waits-history-long=ON
performance-schema-instrument='%=ON'
max-digest-length=2048
performance-schema-max-digest-length=2018

Установка Sysschema для MariaDB < 10.6

Sysschema не устанавливается по умолчанию в MariaDB до версии 10.6 MariaDB sys

Вы можете выполнить следующую команду, чтобы создать новую базу данных sys, содержащую полезное представление о схеме производительности:

curl "https://codeload.github.com/FromDual/mariadb-sys/zip/master" > mariadb-sys.zip
# проверьте zip-файл
unzip -l mariadb-sys.zip
unzip mariadb-sys.zip
cd mariadb-sys-master/
mysql -u root -p < ./sys_10.sql

Ошибки и решения для установки схемы производительности

ОШИБКА 1054 (42S22) в строке 78 в файле: './views/p_s/metrics_56.sql': неизвестный столбец 'STATUS' в списке полей

Эту ошибку можно смело игнорировать Рассмотрите возможность использования последней версии MySQL/MariaDB, чтобы избежать подобных проблем во время установки sysschema

В последних версиях sysschema устанавливается и интегрируется по умолчанию как схема sys (SHOW DATABASES)

ОШИБКА в строке 21: не удалось открыть файл './tables/sys_config_data_10.sql -- ported', ошибка: 2 Посмотрите на решение #452, предложенное @ericx

Исправление конфигурации sysctl (/etc/sysctl.conf)

-- Это общесистемная настройка, а не настройка базы данных: Настройки ядра FS Linux

Вы можете проверить его значения с помощью:

$ cat /proc/sys/fs/aio-*
65536
2305

Например, чтобы установить значение aio-max-nr, добавьте следующую строку в файл /etc/sysctl.conf:

fs.aio-max-nr = 1048576

Чтобы активировать новую настройку:

sysctl -p /etc/sysctl.conf

Специфическое использование

Использование: минимальное использование локально

perl mysqltuner.pl --host 127.0.0.1

Конечно, вы можете добавить бит выполнения (chmod +x mysqltuner.pl), чтобы вы могли выполнять его, не вызывая Perl напрямую.

Использование: минимальное использование удаленно

В предыдущей версии --forcemem следовало устанавливать вручную, чтобы иметь возможность запускать анализ MySQLTuner

Начиная с версии 2.1.10, память и подкачка по умолчанию определены как 1 Гб.

Если вы хотите получить более точное значение в соответствии с вашим удаленным сервером, не стесняйтесь устанавливать --forcemem и --forceswap в реальное значение ОЗУ

perl mysqltuner.pl --host targetDNS_IP --user admin_user --pass admin_password

Использование: включить максимальный вывод информации о MySQL/MariaDb без отладки

perl mysqltuner.pl --verbose
perl mysqltuner.pl --buffers --dbstat --idxstat --sysstat --pfstat --tbstat

Использование: включить проверку уязвимостей CVE для вашей версии MariaDB или MySQL

perl mysqltuner.pl --cvefile=vulnerabilities.csv

Использование: записать результат в файл с отображаемой информацией

perl mysqltuner.pl --outputfile /tmp/result_mysqltuner.txt

Использование: записать результат в файл без вывода информации

perl mysqltuner.pl --silent --outputfile /tmp/result_mysqltuner.txt

Использование: использование шаблона для настройки файла отчета на основе синтаксиса Text::Template.

perl mysqltuner.pl --silent --reportfile /tmp/result_mysqltuner.txt --template=/tmp/mymodel.tmpl

Важно: модуль Text::Template является обязательным для опций --reportfile и/или --template, поскольку этот модуль необходим для создания соответствующего вывода на основе текстового шаблона.

Использование: выгрузка всех представлений information_schema и sysschema в виде файла csv в подкаталог results

perl mysqltuner.pl --verbose --dumpdir=./result

Использование: включить отладочную информацию

perl mysqltuner.pl --debug

Использование: обновить MySQLTuner и файлы данных (пароль и cve) при необходимости

perl mysqltuner.pl --checkversion --updateversion

Поддержка облака

MySQLTuner теперь имеет экспериментальную поддержку облачных сервисов MySQL.

  • --cloud: включить облачный режим. Это общий флаг для любого облачного провайдера.
  • --azure: включить специальную поддержку Azure.
  • --ssh-host <hostname>: хост SSH для облачных подключений.
  • --ssh-user <username>: пользователь SSH для облачных подключений.
  • --ssh-password <password>: пароль SSH для облачных подключений.
  • --ssh-identity-file <path>: путь к файлу идентификации SSH для облачных подключений.

Отчеты в формате HTML на основе Python Jinja2

Генерация HTML основана на Python/Jinja2

Процедура генерации HTML

  • Сгенерируйте отчет mysqltuner.pl в формате JSON (--json)
  • Сгенерируйте отчет в формате HTML с помощью инструментов Python j2

Шаблоны Jinja2 находятся в подкаталоге templates

Базовый пример называется basic.html.j2

Установка Python j2

python -mvenv j2
source ./j2/bin/activate
(j2) pip install j2

Использование генерации отчетов в формате HTML

perl mysqltuner.pl --verbose --json > reports.json
cat reports.json  j2 -f json MySQLTuner-perl/templates/basic.html.j2 > variables.html

или

perl mysqltuner.pl --verbose --json | j2 -f json MySQLTuner-perl/templates/basic.html.j2 > variables.html

Отчеты в формате HTML на основе AHA

Генерация HTML основана на AHA

Процедура генерации HTML

  • Сгенерируйте отчет mysqltuner.pl, используя стандартные текстовые отчеты
  • Сгенерируйте отчет в формате HTML с помощью aha

Установка Aha

Следуйте инструкциям из репозитория Github

Основной репозиторий GitHub AHA

Использование генерации отчетов в формате HTML AHA

perl mysqltuner.pl --verbose --color > reports.txt aha --black --title "MySQLTuner" -f "reports.txt" > "reports.html"

или

perl mysqltuner.pl --verbose --color | aha --black --title "MySQLTuner" > reports.html

Часто задаваемые вопросы

Вопрос: каковы предварительные условия для запуска MySQL tuner?

Перед запуском MySQL tuner у вас должно быть следующее:

  • Установка сервера MySQL
  • Perl, установленный в вашей системе
  • Административный доступ к вашему серверу MySQL

Вопрос: может ли MySQL tuner автоматически вносить изменения в мою конфигурацию?

Нет., MySQL tuner предоставляет только рекомендации. Он не вносит никаких изменений в ваши файлы конфигурации автоматически. Пользователь должен просмотреть предложения и реализовать их по мере необходимости.

Вопрос: как часто я должен запускать MySQL tuner?

Рекомендуется периодически запускать MySQL tuner, особенно после значительных изменений на вашем сервере MySQL или его рабочей нагрузки.

Для получения оптимальных результатов запускайте скрипт после того, как ваш сервер проработает не менее 24 часов, чтобы собрать достаточные данные о производительности.

Вопрос: как мне интерпретировать результаты MySQL tuner?

MySQL tuner предоставляет вывод в виде предложений и предупреждений.

Просмотрите каждую рекомендацию и рассмотрите возможность внесения изменений в свой файл конфигурации MySQL (обычно "my.cnf" или "my.ini").

Будьте осторожны при внесении изменений и всегда создавайте резервную копию файла конфигурации перед внесением каких-либо изменений.

Вопрос: может ли MySQL tuner нанести вред моей базе данных или серверу?

Хотя сам MySQL tuner не будет вносить никаких изменений в ваш сервер, слепое выполнение его рекомендаций без понимания последствий может вызвать проблемы.

Всегда убедитесь, что вы понимаете последствия каждого предложения, прежде чем применять его к своему серверу.

Вопрос: поддерживает ли MySQL tuner MariaDB и Percona Server?

Да, MySQL tuner поддерживает MariaDB и Percona Server, поскольку они являются производными от MySQL и имеют схожую архитектуру. Скрипт может анализировать и предоставлять рекомендации и для этих систем.

Вопрос: что мне делать, если мне нужна помощь с MySQL tuner или у меня есть вопросы по поводу рекомендаций?

Если вам нужна помощь с MySQL tuner или у вас есть вопросы по поводу рекомендаций, предоставленных скриптом, вы можете обратиться к документации MySQL tuner, попросить совета на онлайн-форумах или проконсультироваться с экспертом по MySQL.

Будьте осторожны при внесении изменений, чтобы обеспечить стабильность и производительность вашего сервера.

Вопрос: исправит ли MySQLTuner мой медленный сервер MySQL?

Нет. MySQLTuner — это скрипт только для чтения. Он не будет записывать какие-либо файлы конфигурации, изменять статус каких-либо демонов. Он предоставит вам обзор производительности вашего сервера и даст несколько основных рекомендаций по улучшениям, которые вы можете внести после его завершения.

Вопрос: могу ли я теперь уволить своего администратора баз данных?

MySQLTuner ни в какой форме не заменит вашего администратора баз данных.

Если ваш администратор баз данных постоянно занимает ваше парковочное место и крадет ваш обед из холодильника, то вы можете рассмотреть этот вариант, но это ваше решение.

После того, как вы его создадите, убедитесь, что он принадлежит вашему пользователю, а режим файла — 0600. Это должно предотвратить подглядывание за вашими учетными данными для входа в базу данных в обычных условиях.

Вопрос: Я получаю «ERROR 1524 (HY000): Plugin 'unix_socket' is not loaded» даже при unix_socket=OFF. Как это исправить?

Это происходит потому, что клиент MariaDB по умолчанию пытается использовать плагин unix_socket, если не указаны имя пользователя или пароль.

  • Решение 1 (рекомендуется): Используйте файл ~/.my.cnf, как описано выше, для предоставления явных учетных данных.
  • Решение 2: Передайте учетные данные напрямую: perl mysqltuner.pl --user root --pass ваш_пароль.

Вопрос: Как безопасно снова включить аутентификацию unix_socket?

Если вы решите использовать unix_socket (который позволяет пользователю ОС root входить в MariaDB root без пароля), выполните следующие действия:

  1. Убедитесь, что плагин включен в /etc/my.cnf: unix_socket=ON (или удалите OFF).

  2. В MariaDB установите плагин аутентификации для пользователя root:

    ALTER USER 'root'@'localhost' IDENTIFIED VIA unix_socket;

  3. Убедитесь, что плагин auth_socket или unix_socket имеет статус ACTIVE в SHOW PLUGINS.

Вопрос: есть ли другой способ защитить учетные данные в последних дистрибутивах MySQL и MariaDB?

Вы можете использовать утилиты mysql_config_editor.

 $ mysql_config_editor set --login-path=client --user=someusername --password --host=localhost
 Введите пароль: ********

После чего будет создан ~/.mylogin.cnf с соответствующим доступом.

Чтобы получить информацию о сохраненных учетных данных, используйте следующую команду:

$mysql_config_editor print
[client]
user = someusername
password = *****
host = localhost

Вопрос: это не работает в моей ОС! В чем дело?!

Такие вещи обязательно случаются. Вот подробности, которые мне нужны от вас для расследования проблемы:

  • ОС и версия ОС
  • Архитектура (x86, x86_64, IA64, Commodore 64)
  • Точная версия MySQL
  • Откуда вы получили свою версию MySQL (пакет ОС, исходный код и т. д.)
  • Полный текст ошибки
  • Копия вывода SHOW VARIABLES и SHOW GLOBAL STATUS (если возможно)

Вопрос: как выполнять проверки уязвимостей CVE?

  • Загрузите vulnerabilities.csv из этого репозитория.
  • используйте опцию --cvefile для выполнения проверок CVE

Вопрос: как использовать mysqltuner с удаленного хоста? Спасибо @rolandomysqldba

  • Вам все равно придется подключаться как клиент mysql:

Подключение и аутентификация

--host Подключиться к удаленному хосту для выполнения тестов (по умолчанию: localhost) --socket Использовать другой сокет для локального подключения --port Порт для подключения (по умолчанию: 3306) --user Имя пользователя для аутентификации --pass Пароль для аутентификации --defaults-file файл по умолчанию для учетных данных

Поскольку вы используете удаленный хост, используйте параметры для предоставления значений из ОС

--forcemem Объем установленной оперативной памяти в мегабайтах --forceswap Объем настроенной памяти подкачки в мегабайтах

  • Возможно, вам придется связаться с вашим удаленным системным администратором, чтобы спросить, сколько у вас ОЗУ и подкачки

Если в базе данных слишком много таблиц или очень большие таблицы, используйте это:

--skipsize Не перечислять таблицы и их типы/размеры (по умолчанию: вкл.) (Рекомендуется для серверов с большим количеством таблиц)

Вопрос: могу ли я установить этот проект с помощью homebrew на Apple Macintosh?

Да! brew install mysqltuner можно использовать для установки этого приложения с помощью homebrew на Apple Macintosh.

MySQLTuner и Vagrant

MySQLTuner содержит следующие конфигурации Vagrant:

  • Fedora Core 30 / Docker

Файл Vagrant хранится в подкаталоге Vagrant.

  • Выполните следующие действия после установки Vagrant: $ vagrant up

MySQLTuner содержит конфигурации Vagrant для целей тестирования и разработки

настроить тестовые среды

$ sh build/createTestEnvs.sh

$ source build/bashrc
$ mysql_percona80 sakila
sakila> ...

$ docker images
mariadb                  10.1                fc612450e1f1        12 days ago         352MB
mariadb                  10.2                027b7c57b8c6        12 days ago         340MB
mariadb                  10.3                47dff68107c4        12 days ago         343MB
mariadb                  10.4                92495405fc36        12 days ago         356MB
mysql                    5.6                 95e0fc47b096        2 weeks ago         257MB
mysql                    5.7                 383867b75fd2        2 weeks ago         373MB
mysql                    8.0                 b8fd9553f1f0        2 weeks ago         445MB
percona/percona-server   5.7                 ddd245ed3496        5 weeks ago         585MB
percona/percona-server   5.6                 ed0a36e0cf1b        6 weeks ago         421MB
percona/percona-server   8.0                 390ae97d57c6        6 weeks ago         697MB
mariadb                  5.5                 c7bf316a4325        4 months ago        352MB
mariadb                  10.0                d1bde56970c6        4 months ago        353MB
mysql                    5.5                 d404d78aa797        4 months ago        205MB

$ docker ps
CONTAINER ID        IMAGE                        COMMAND                  CREATED             STATUS              PORTS                               NAMES
da2be9b050c9        mariadb:5.5                  "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:5311->3306/tcp              mariadb55
5deca25d5ac8        mariadb:10.0                 "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:5310->3306/tcp              mariadb100
73aaeb37e2c2        mariadb:10.1                 "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:5309->3306/tcp              mariadb101
72ffa77e01ec        mariadb:10.2                 "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:5308->3306/tcp              mariadb102
f5996f2041df        mariadb:10.3                 "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:5307->3306/tcp              mariadb103
4890c52372bb        mariadb:10.4                 "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:5306->3306/tcp              mariadb104
6b9dc078e921        percona/percona-server:5.6   "/docker-entrypoint.…"   7 hours ago         Up 7 hours          0.0.0.0:4308->3306/tcp              percona56
3a4c7c826d4c        percona/percona-server:5.7   "/docker-entrypoint.…"   7 hours ago         Up 7 hours          0.0.0.0:4307->3306/tcp              percona57
3dda408c91b0        percona/percona-server:8.0   "/docker-entrypoint.…"   7 hours ago         Up 7 hours          33060/tcp, 0.0.0.0:4306->3306/tcp   percona80
600a4e7e9dcd        mysql:5.5                    "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:3309->3306/tcp              mysql55
4bbe54342e5d        mysql:5.6                    "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:3308->3306/tcp              mysql56
a49783249a11        mysql:5.7                    "docker-entrypoint.s…"   7 hours ago         Up 7 hours          33060/tcp, 0.0.0.0:3307->3306/tcp   mysql57
d985820667c2        mysql:8.0                    "docker-entrypoint.s…"   7 hours ago         Up 7 hours          0.0.0.0:3306->3306/tcp, 33060/tcp   mysql 8    0

Приветствуются вклады

Как внести свой вклад с помощью запроса на включение? Следуйте этому руководству: Создание запроса на включение

Простые шаги для создания запроса на включение

  • Сделайте форк этого проекта Github
  • Клонируйте его в свою локальную систему
  • Создайте новую ветку
  • Внесите свои изменения
  • Отправьте его обратно в свой репозиторий
  • Нажмите кнопку Сравнить и запрос на включение
  • Нажмите Создать запрос на включение, чтобы открыть новый запрос на включение