NAME

Имя инструмента. Имена инструментов могут иметь несколько частей и образовывать иерархию, как описано в разделе 29.6, «Конвенции именования инструментов Performance Schema». События, сгенерированные в результате выполнения инструмента, имеют значение EVENT_NAME, которое взято из значения инструмента NAME. (События фактически не имеют «имени», но это предоставляет способ сопоставления событий с инструментами.)

ENABLED

Включен ли инструмент. Значение равно YES или NO. Выключенный инструмент не генерирует событий. Этот столбец можно изменять, хотя установка ENABLED не имеет эффекта для инструментов, которые уже были созданы.

TIMED

Отслеживается ли время работы инструмента. Значение равно YES, NO или NULL. Этот столбец можно изменять, хотя установка TIMED не имеет эффекта для инструментов, которые уже были созданы.

Значение TIMED, равное NULL, указывает, что инструмент не поддерживает измерение времени. Например, операции с памятью не отслеживаются по времени, поэтому их столбец TIMED имеет значение NULL.

Установка TIMED в NULL для инструмента, поддерживающего измерение времени, не имеет эффекта, как и установка TIMED в не-NULL для инструмента, не поддерживающего измерение времени.

Если включенный инструмент не отслеживает время, код инструмента включен, но таймер не включен. События, созданные инструментом, имеют NULL для значений таймера TIMER_START, TIMER_END и TIMER_WAIT. Это, в свою очередь, приводит к игнорированию этих значений при вычислении суммарных, минимальных, максимальных и средних значений времени в сводных таблицах.

PROPERTIES

Свойства инструмента. Этот столбец использует тип данных SET, поэтому для каждого инструмента можно установить несколько флагов из следующего списка:

FLAGS

Управляется ли память инструмента.

Этот флаг поддерживается только для инструментов памяти, не относящихся к глобальным, и может быть установлен или сброшен. Например:

              SQL> UPDATE PERFORMANCE_SCHEMA.SETUP_INTRUMENTS SET FLAGS="controlled" WHERE NAME='memory/sql/NET::buff';
            

VOLATILITY

Изменчивость инструмента. Значения изменчивости варьируются от низких до высоких. Значения соответствуют константам PSI_VOLATILITY_xxx, определённым в заголовочном файле mysql/psi/psi_base.h:

#define PSI_VOLATILITY_UNKNOWN 0
#define PSI_VOLATILITY_PERMANENT 1
#define PSI_VOLATILITY_PROVISIONING 2
#define PSI_VOLATILITY_DDL 3
#define PSI_VOLATILITY_CACHE 4
#define PSI_VOLATILITY_SESSION 5
#define PSI_VOLATILITY_TRANSACTION 6
#define PSI_VOLATILITY_QUERY 7
#define PSI_VOLATILITY_INTRA_QUERY 8

Столбец VOLATILITY является чисто информативным, чтобы предоставить пользователям (и коду Performance Schema) некоторое представление о поведении инструмента во время выполнения.

Инструменты с низким индексом изменчивости (PERMANENT = 1) создаются один раз при запуске сервера и никогда не уничтожаются или не пересоздаются во время обычной работы сервера. Они уничтожаются только во время завершения работы сервера.

Например, мьютекс wait/synch/mutex/pfs/LOCK_pfs_share_list определён с изменчивостью 1, что означает, что он создаётся один раз. Возможные накладные расходы от самого инструментирования (а именно, инициализация мьютекса) для этого инструмента не влияют. Накладные расходы во время выполнения возникают только при блокировке или разблокировке мьютекса.

Инструменты с более высоким индексом изменчивости (например, SESSION = 5) создаются и уничтожаются для каждой сессии пользователя. Например, мьютекс wait/synch/mutex/sql/THD::LOCK_query_plan создаётся каждый раз, когда подключается сессия, и уничтожается, когда сессия отключается.

Этот мьютекс более чувствителен к накладным расходам Performance Schema, потому что накладные расходы возникают не только от инструментирования блокировки и разблокировки, но также от инструментирования создания и уничтожения мьютекса, которые выполняются чаще.

Другой аспект изменчивости касается того, действительно ли и когда обновление столбца ENABLED оказывает какое-либо влияние:

Например, эта команда не влияет на мьютекс LOCK_query_plan для существующих сессий, но оказывает влияние на новые сессии, созданные после обновления:

UPDATE performance_schema.setup_instruments
SET ENABLED=value
WHERE NAME = 'wait/synch/mutex/sql/THD::LOCK_query_plan';

Эта команда фактически не оказывает никакого влияния:

UPDATE performance_schema.setup_instruments
SET ENABLED=value
WHERE NAME = 'wait/synch/mutex/pfs/LOCK_pfs_share_list';

Этот мьютекс постоянный и был создан до выполнения обновления. Мьютекс никогда не создаётся снова, поэтому значение ENABLED в setup_instruments никогда не используется. Чтобы включить или отключить этот мьютекс, используйте таблицу mutex_instances вместо этого.

DOCUMENTATION

Строка, описывающая назначение инструмента. Значение равно NULL, если описание недоступно.

Основной ключ по (NAME)