Documentation Home

27.4.6 按线程预过滤

threads表包含每个服务器线程的一行。每行包含有关线程的信息,并指示是否为其启用监控。对于监视线程的性能模式,这些事情必须是真实的:

  • 表中的thread_instrumentation消费者setup_consumers必须是YES

  • threads.INSTRUMENTED列必须是 YES.

  • 仅对表中启用的工具生成的那些线程事件进行监视 setup_instruments

threads表还指示每个服务器线程是否执行历史事件记录。这包括等待、阶段、语句和事务事件,并影响到这些表的日志记录:

events_waits_history
events_waits_history_long
events_stages_history
events_stages_history_long
events_statements_history
events_statements_history_long
events_transactions_history
events_transactions_history_long

要进行历史事件记录,必须满足以下条件:

对于前台线程(由客户端连接产生),表行中的INSTRUMENTEDHISTORY列 的初始值threads取决于与线程关联的用户帐户是否与表中的任何行匹配setup_actors。这些值来自匹配 表行 的ENABLED和 列。HISTORYsetup_actors

对于后台线程,没有关联的用户。 INSTRUMENTED并且默认情况下 HISTORY 不被咨询。 YESsetup_actors

初始setup_actors内容如下所示:

mysql> SELECT * FROM performance_schema.setup_actors;
+------+------+------+---------+---------+
| HOST | USER | ROLE | ENABLED | HISTORY |
+------+------+------+---------+---------+
| %    | %    | %    | YES     | YES     |
+------+------+------+---------+---------+

和列应包含文字主机名或用户名,或 HOST匹配任何名称。 USER'%'

和 列指示是否为匹配的线程启用检测和历史事件日志记录,取决于前面描述的其他条件 ENABLEDHISTORY

当 Performance Schema 检查每个新前台线程的匹配项时setup_actors,它会尝试首先使用 USERHOST列(ROLE未使用)找到更具体的匹配项:

  • 行 与 。 USER='literal'HOST='literal'

  • 行 与。 USER='literal'HOST='%'

  • USER='%'与 。 HOST='literal'

  • USER='%'HOST='%'

匹配发生的顺序很重要,因为不同的匹配setup_actors行可以有不同USERHOST 值。这使得检测和历史事件日志记录能够根据ENABLEDHISTORY列值有选择地应用于每个主机、用户或帐户(用户和主机组合):

  • 当最匹配的行是 时 ,线程 ENABLED=YES的 值变为。当最匹配的行是 时 ,线程 的 值变为。 INSTRUMENTEDYESHISTORY=YESHISTORYYES

  • 当最匹配的行是 时 ,线程 ENABLED=NO的 值变为。当最匹配的行是 时 ,线程 的 值变为。 INSTRUMENTEDNOHISTORY=NOHISTORYNO

  • 当找不到匹配项时,线程的INSTRUMENTEDHISTORY值变为 NO

行中的ENABLEDHISTORYsetup_actors可以相互设置YESNO 相互独立。这意味着您可以独立于是否收集历史事件来启用检测。

默认情况下,会为所有新的前台线程启用监视和历史事件收集,因为该 setup_actors表最初包含一个包含'%'HOST的行USER。要执行更有限的匹配,例如仅对某些前台线程启用监视,您必须更改此行,因为它匹配任何连接,并为更具体的 HOST/USER组合添加行。

假设你修改 setup_actors如下:

UPDATE performance_schema.setup_actors
SET ENABLED = 'NO', HISTORY = 'NO'
WHERE HOST = '%' AND USER = '%';
INSERT INTO performance_schema.setup_actors
(HOST,USER,ROLE,ENABLED,HISTORY)
VALUES('localhost','joe','%','YES','YES');
INSERT INTO performance_schema.setup_actors
(HOST,USER,ROLE,ENABLED,HISTORY)
VALUES('hosta.example.com','joe','%','YES','NO');
INSERT INTO performance_schema.setup_actors
(HOST,USER,ROLE,ENABLED,HISTORY)
VALUES('%','sam','%','NO','YES');

UPDATE语句更改默认匹配以禁用检测和历史事件收集。这些INSERT语句为更具体的匹配项添加行。

现在 Performance Schema 确定如何为新连接线程设置 INSTRUMENTEDHISTORY 值,如下所示:

  • 如果joe从本地主机连接,连接匹配第一个插入的行。线程的 INSTRUMENTEDHISTORY值变为 YES

  • 如果joe从 连接 hosta.example.com,则连接匹配第二个插入的行。INSTRUMENTED 线程的值变为值 变为 YESHISTORYNO

  • 如果joe从任何其他主机连接,则没有匹配项。线程的INSTRUMENTEDHISTORY值变为 NO

  • 如果sam从任何主机连接,连接匹配第三个插入的行。INSTRUMENTED线程 的 值变为值 变为NOHISTORYYES

  • 对于任何其他连接,具有 HOSTUSER设置为 '%'匹配的行。该行现在已 设置为,因此线程的 和 ENABLED值变为 。 HISTORYNOINSTRUMENTEDHISTORYNO

setup_actors 表的修改仅影响修改后创建的前台线程,而不影响现有线程。要影响现有线程,请修改表行的INSTRUMENTEDHISTORYthreads