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)