29.4.4 Pre-Filtering by Instrument — MySQL 8.4

29.4.4 Предварительное фильтрация по инструменту

Таблица setup_instruments перечисляет доступные инструменты:

mysql> SELECT NAME, ENABLED, TIMED
       FROM performance_schema.setup_instruments;
+---------------------------------------------------+---------+-------+
| NAME                                              | ENABLED | TIMED |
+---------------------------------------------------+---------+-------+
...
| stage/sql/end                                     | NO      | NO    |
| stage/sql/executing                               | NO      | NO    |
| stage/sql/init                                    | NO      | NO    |
| stage/sql/insert                                  | NO      | NO    |
...
| statement/sql/load                                | YES     | YES   |
| statement/sql/grant                               | YES     | YES   |
| statement/sql/check                               | YES     | YES   |
| statement/sql/flush                               | YES     | YES   |
...
| wait/synch/mutex/sql/LOCK_global_read_lock        | YES     | YES   |
| wait/synch/mutex/sql/LOCK_global_system_variables | YES     | YES   |
| wait/synch/mutex/sql/LOCK_lock_db                 | YES     | YES   |
| wait/synch/mutex/sql/LOCK_manager                 | YES     | YES   |
...
| wait/synch/rwlock/sql/LOCK_grant                  | YES     | YES   |
| wait/synch/rwlock/sql/LOGGER::LOCK_logger         | YES     | YES   |
| wait/synch/rwlock/sql/LOCK_sys_init_connect       | YES     | YES   |
| wait/synch/rwlock/sql/LOCK_sys_init_slave         | YES     | YES   |
...
| wait/io/file/sql/binlog                           | YES     | YES   |
| wait/io/file/sql/binlog_index                     | YES     | YES   |
| wait/io/file/sql/casetest                         | YES     | YES   |
| wait/io/file/sql/dbopt                            | YES     | YES   |
...

Для управления включением инструмента установите значение его столбца ENABLED в YES или NO. Для настройки сбора временных данных для включённого инструмента установите его значение TIMED в YES или NO. Установка значения столбца TIMED влияет на содержимое таблиц Performance Schema, как описано в Разделе 29.4.1 «Временные метки событий Performance Schema».

Изменения в большинстве строк таблицы setup_instruments влияют на мониторинг немедленно. Для некоторых инструментов изменения вступают в силу только при запуске сервера; изменение их во время выполнения не имеет эффекта. Это главным образом касается мьютексов, условных переменных и rwlocks на сервере, хотя могут быть и другие инструменты, для которых это справедливо.

Таблица setup_instruments обеспечивает наиболее базовый контроль над производством событий. Для дальнейшей детализации производства событий на основе типа объекта или потока, которые отслеживаются, могут использоваться другие таблицы, как описано в Разделе 29.4.3 «Предварительное фильтрация событий».

Следующие примеры демонстрируют возможные операции с таблицей setup_instruments. Эти изменения, как и другие операции предварительной фильтрации, влияют на всех пользователей. Некоторые из этих запросов используют оператор LIKE и сопоставление по шаблону имён инструментов. Дополнительную информацию о задании шаблонов для выбора инструментов см. в Разделе 29.4.9 «Именование инструментов или потребителей для операций фильтрации».

Отключить все инструменты:
```
UPDATE performance_schema.setup_instruments
SET ENABLED = 'NO';
```
Сейчас никакие события не собираются.
Отключить все инструменты файлов, добавив их в текущий набор отключённых инструментов:
```
UPDATE performance_schema.setup_instruments
SET ENABLED = 'NO'
WHERE NAME LIKE 'wait/io/file/%';
```
Отключить только инструменты файлов, включить все остальные инструменты:
```
UPDATE performance_schema.setup_instruments
SET ENABLED = IF(NAME LIKE 'wait/io/file/%', 'NO', 'YES');
```

Включить все, кроме инструментов из библиотеки mysys:

UPDATE performance_schema.setup_instruments
SET ENABLED = CASE WHEN NAME LIKE '%/mysys/%' THEN 'YES' ELSE 'NO' END;

Отключить определённый инструмент:

UPDATE performance_schema.setup_instruments
SET ENABLED = 'NO'
WHERE NAME = 'wait/synch/mutex/mysys/TMPDIR_mutex';

Чтобы переключить состояние инструмента, “перевернуть” его значение ENABLED:

UPDATE performance_schema.setup_instruments
SET ENABLED = IF(ENABLED = 'YES', 'NO', 'YES')
WHERE NAME = 'wait/synch/mutex/mysys/TMPDIR_mutex';

Отключить временные метки для всех событий:
```
UPDATE performance_schema.setup_instruments
SET TIMED = 'NO';
```