Documentation Home
MySQL 5.7 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 35.1Mb
PDF (A4) - 35.2Mb
Man Pages (TGZ) - 256.4Kb
Man Pages (Zip) - 361.2Kb
Info (Gzip) - 3.4Mb
Info (Zip) - 3.4Mb
Excerpts from this Manual

25.12.2.3 The setup_instruments Table

Thesetup_instruments table lists classes of instrumented objects for which events can be collected:

mysql> SELECT * 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   |...

Each instrument added to the source code provides a row for thesetup_instruments table, even when the instrumented code is not executed. When an instrument is enabled and executed, instrumented instances are created, which are visible in thexxx_instances tables, such asfile_instances orrwlock_instances.

Modifications to mostsetup_instruments rows affect monitoring immediately. For some instruments, modifications are effective only at server startup; changing them at runtime has no effect. This affects primarily mutexes, conditions, and rwlocks in the server, although there may be other instruments for which this is true.

For more information about the role of thesetup_instruments table in event filtering, seeSection 25.4.3, “Event Pre-Filtering”.

Thesetup_instruments table has these columns:

  • NAME

    The instrument name. Instrument names may have multiple parts and form a hierarchy, as discussed inSection 25.6, “Performance Schema Instrument Naming Conventions”. Events produced from execution of an instrument have anEVENT_NAME value that is taken from the instrumentNAME value. (Events do not really have aname, but this provides a way to associate events with instruments.)

  • ENABLED

    Whether the instrument is enabled. The value isYES orNO. A disabled instrument produces no events. This column can be modified, although settingENABLED has no effect for instruments that have already been created.

  • TIMED

    Whether the instrument is timed. The value isYES orNO. This column can be modified, although settingTIMED has no effect for instruments that have already been created.

    For memory instruments, theTIMED column insetup_instruments is ignored because memory operations are not timed.

    If an enabled instrument is not timed, the instrument code is enabled, but the timer is not. Events produced by the instrument haveNULL for theTIMER_START,TIMER_END, andTIMER_WAIT timer values. This in turn causes those values to be ignored when calculating the sum, minimum, maximum, and average time values in summary tables.

TRUNCATE TABLE is not permitted for thesetup_instruments table.