mariadb-report
Начиная с MariaDB 10.4.6, mariadb-report является символической ссылкой на mysqlreport, двоичный файл для отображения значения важных переменных состояния.
Начиная с MariaDB 10.5.2, mariadb-report — имя двоичного файла, а mysqlreport — символическая ссылка.
mariadb-report генерирует удобный отчёт о важных значениях состояния MariaDB. В действительности, он генерирует удобный отчёт практически обо всех значениях состояния из SHOW STATUS. В отличие от SHOW STATUS, который просто выводит более 100 значений на экран в одном длинном списке, mariadb-report интерпретирует и форматирует значения, представляя основные и многие другие выведенные значения в удобочитаемом формате. Многочисленные примеры отчётов доступны в архиве старого сайта hackmysql.com/mysqlreport, архивированы здесь.
Преимущество mariadb-report заключается в том, что оно позволяет очень быстро увидеть широкий спектр показателей производительности вашего сервера MariaDB, которые в противном случае необходимо было бы рассчитывать вручную из различных значений SHOW STATUS. Например, коэффициент чтения индексов является важным значением, но он отсутствует в SHOW STATUS; это вычисленное значение (отношение Key_reads к Key_read_requests).
В этом руководстве описаны все параметры командной строки в mariadb-report, большинство из которых управляют тем, какие отчёты будут выведены. В этом документе не рассматривается, как интерпретировать эти отчёты; эта тема рассматривается в документе «Руководство по пониманию mysqlreport», архивирован здесь.
Использование
mariadb-report [options]
Параметры mariadb-report
Технически, параметры командной строки имеют вид --option, но -option также работают. Все параметры могут быть сокращены, если сокращение уникально. Например, параметр --host можно сократить до --ho, но не до --h, потому что --h является неоднозначным: он может означать --host или --help.
| Параметр | Описание |
|---|---|
--all |
Эквивалентно --dtq --dms --com 3 --sas --qcache. (Обратите внимание, что --tab не вызывается --all.) |
--com N |
Выводит N самых важных значений статуса Com_ (кроме DMS) в порядке убывания (после отчёта DMS в отчёте Questions). Если N не указано, значение по умолчанию равно 3. Такие значения Com_, помимо DMS, включают Com_change_db, Com_show_tables, Com_rollback и т. д. |
--dms |
Выводит отчёт о операторах управления данными (DMS) (в отчёте Questions под DMS). DMS — это операторы из раздела Обработки данных. mariadb-report учитывает только SELECT, INSERT, REPLACE, UPDATE и DELETE. Каждый DMS перечислен в порядке убывания количества. |
--dtq |
Выводит отчёт о распределении общих запросов (DTQ) (в отчёте Questions под Общее). Запросы (или Вопросы) могут быть разделены на четыре основные области: DMS (см. --dms), Com_ (см. --com ), COM_QUIT (см. COM_QUIT и Вопросы, архивировано здесь), и Неизвестные. --dtq перечисляет количество запросов в каждой из этих областей в порядке убывания. |
--email ADDRESS |
После вывода отчёта на экран отправляет отчёт по электронной почте на адрес ADDRESS. Этот параметр требует наличия sendmail в каталоге /usr/sbin/, поэтому он не работает в Windows. /usr/sbin/sendmail может быть символьным именем qmail, например, или любой MTA, эмулирующей параметр командной строки -t и работу sendmail. Поле FROM: — "mariadb-report", тема: "Отчёт о состоянии MySQL". |
--flush-status |
Выполняет FLUSH STATUS после генерации отчётов. Если у вас нет прав в MariaDB для этого, будет выведено сообщение об ошибке от DBD::mysql::st после отчётов. |
--help |
Выводит справку и завершает работу. |
--host ADDRESS |
Адрес хоста. |
--infile FILE |
Вместо получения значений SHOW STATUS из MariaDB, считывает значения из файла FILE. FILE часто является копией вывода SHOW STATUS, включая символы форматирования (+, -). mariadb-report ожидает, что файл FILE будет иметь формат "значение число", где значение содержит только символы латинского алфавита и подчеркивания (A-Z и _) и число — положительное целое число. Все, что находится перед, между или после значения и числа, игнорируется. mariadb-report также нуждается в следующих переменных сервера MariaDB: version, table_cache, max_connections, key_buffer_size, query_cache_size. Эти значения могут быть указаны в INFILE в формате "имя = значение", где имя — одна из перечисленных переменных сервера, а значение — положительное целое число с или без последующего M и возможными точками (для версии). Например, чтобы указать 18M key_buffer_size: key_buffer_size = 18M. Или 256 table_cache: table_cache = 256. M означает мегабайты, а не миллион, поэтому 18M означает 18 874 368, а не 18 000 000. Если эти переменные сервера не указаны, используются следующие значения по умолчанию (соответственно), что может привести к странным значениям отчёта: 0.0.0, 64, 100, 8M, 0. |
--no-mycnf |
Заставляет mariadb-report не читать /.my.cnf, что он делает по умолчанию. --user и --password всегда переопределяют значения из /.my.cnf. |
--outfile FILE |
После вывода отчёта на экран также выводит отчёт в файл FILE. Внутренне mariadb-report всегда сначала записывает отчёт во временный файл: /tmp/mysqlreport.PID в *nix, c:sqlreport.PID в Windows (PID — идентификатор процесса скрипта). Затем он выводит временный файл на экран. Затем, если указано --outfile, временный файл копируется в OUTFILE. После --email (выше), временный файл удаляется. |
--password |
Начиная с версии 2.3 --password может принимать пароль в командной строке, например, --password FOO. Использование --password без указания пароля в командной строке заставляет mariadb-report запросить пароль. |
--port PORT |
Номер порта. |
--qcache |
Выводит отчёт для кэша запросов. |
--sas |
Выводит отчёт для значений Select_ и Sort_ статуса (после отчёта Questions). См. Переменные статуса MySQL Select и Sort, архив здесь. |
--socket SOCKET |
Для подключений к localhost, используемый файл сокета Unix или, в Windows, имя именованной трубы. |
--tab |
Выводит отчёты о потоках, прерванных потоках и байтах (после отчёта о созданных временных файлах). Отчёт о потоках сообщает обо всех значениях статуса Threads_. |
--user USERNAME |
Имя пользователя. |
© 2023 MariaDB
Licensed under the Creative Commons Attribution 3.0 Unported License and the GNU Free Documentation License.
https://mariadb.com/kb/en/mariadb-report/
