12.9.2 collectHighLoadDiagnostics Utility — MySQL Shell 9.2

12.9.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

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

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

Например:

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

Важно

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