11.8.2 collectHighLoadDiagnostics Utility — MySQL Shell 8.4

11.8.2 Утилита collectHighLoadDiagnostics

О утилите

util.debug.collectHighLoadDiagnostics() выполняет несколько итераций отчётности о диагностике вашего сервера MySQL, позволяя вам анализировать множество аспектов сервера при высокой нагрузке.

Отчёт диагностики высокой нагрузки генерируется в виде zip-архива в локальном каталоге или в указанном пути.

Утилита генерирует файлы в формате TSV и YAML.

Требования и ограничения

Следующие требования применяются к экспорту с помощью утилиты сбора диагностики:

Требуется MySQL 5.7 или более поздней версии.
Утилита должна запускаться от имени root.

Запуск утилиты

Утилита диагностики имеет следующую сигнатуру:

  util.debug.collectHighLoadDiagnostics(path, {options})

Следующий пример записывает zip-файл в временную директорию пользователя, выполняет 5 итераций сбора и включает все инструменты и потребители Performance Schema:

      util.debug.collectHighLoadDiagnostics("/home/userName/temp/highLoad.zip", {iterations: 5, pfsInstrumentation: "full"})

Примечание

Возвращаемые данные этой утилиты также включают данные, собранные util.debug.collectDiagnostics().

Параметры для сбора диагностики высокой нагрузки

iterations: число

Значение по умолчанию — 2. Количество итераций сбора данных диагностики высокой нагрузки.

delay: число

Значение по умолчанию — 300 секунд. Количество секунд между итерациями сбора данных диагностики высокой нагрузки.

innodbMutex: [true | false]

Значение по умолчанию — false. Если установлено в значение true, то собирается вывод SHOW ENGINE INNODB MUTEX.

Примечание

Этот параметр может повлиять на производительность.

pfsInstrumentation: [current | medium | full]

Значение по умолчанию — current. Определяет, какие инструменты и потребители Performance Schema используются. Возможные значения:

current: Текущие включенные инструменты и потребители Performance Schema. Конфигурация вашего сервера не изменяется.
medium: Включает всех потребителей, кроме %history и %history_long, и все инструменты, кроме wait/synch/%.
full: Включает всех потребителей и все инструменты.

customSql: array

Одна или несколько SQL-команд для выполнения. Вы можете управлять временем выполнения команд с помощью следующих префиксов:

PRE: По умолчанию. Команда выполняется один раз перед началом итераций сбора метрик.
POST: Команда выполняется один раз после завершения итераций сбора метрик.
ITER: Команда выполняется один раз для каждой итерации сбора метрик.

Например:

            {"customSql": ["statement1", "statement2", "statement3"]}

customShell array

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

BEFORE: По умолчанию. Команда выполняется один раз перед началом итераций сбора метрик.
DURING: Команда выполняется один раз для каждой итерации сбора метрик.
AFTER: Команда выполняется один раз после завершения итераций сбора метрик.

Например:

            {"customShell": ["command1", "command2", "command3"]}

Важно

Эти команды выполняются с правами пользователя, запускающего MySQL Shell, и должны использоваться с осторожностью.