登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  MySQL

MySQL performance_schema.setup_actors 怎样只采集指定账户的前台线程

来源:17golang原创

时间:2026-11-19 10:28:31 132浏览 收藏

如果 Performance Schema 只想观察某个应用账户,关键不是直接给 events_waits% 一类表加条件,而是先控制新连接线程的初始状态:把 setup_actors 的默认匹配改成关闭,再为目标用户和来源主机添加更具体的规则。

官方地址:https://dev.mysql.com/doc/refman/8.4/en/performance-schema-setup-actors-table.html

最小结论:setup_actors.ENABLED 决定新前台线程的 INSTRUMENTED 初始值,HISTORY 决定历史事件记录的初始值;它只影响修改后创建的新前台线程。

setup_actors 控制的是新前台线程的初始状态

setup_actors 不是事件明细表,而是线程过滤规则表。MySQL 为新的客户端连接创建前台线程时,会按 USER 和 HOST 匹配规则,并把最佳匹配行的两个开关写入 performance_schema.threads:

setup_actors 字段对应线程状态含义
ENABLEDINSTRUMENTED是否对该线程产生的事件做监控
HISTORYHISTORY是否把事件写入历史消费者
ROLE—当前用于主键,匹配时不参与实际筛选

默认表里通常有 HOST='%'、USER='%'、ENABLED='YES'、HISTORY='YES'。这行会匹配所有新前台连接,所以只添加一行目标账户并不能自然达到“只采集它”的效果。

setup_actors 账户匹配规则与新前台线程 INSTRUMENTED、HISTORY 初始状态的关系说明图
图1:线程初始化结构说明图,展示 setup_actors 规则与 threads 初始状态的静态关系;这是说明图,不是数据库截图或运行证据。

先把默认通配规则改为关闭

假设只想观察来自 app_user 的新连接,第一步是让通配行承担“其他账户的默认值”。下面的 SQL 是配置示例,注释说明每个动作的目的:

-- 先让所有未命中特殊规则的新前台线程默认不采集
UPDATE performance_schema.setup_actors
SET ENABLED = 'NO', HISTORY = 'NO'
WHERE HOST = '%' AND USER = '%';

-- 为目标账户增加更具体的匹配;这里示例允许来自 app.example.com
INSERT INTO performance_schema.setup_actors
    (HOST, USER, ROLE, ENABLED, HISTORY)
VALUES
    ('app.example.com', 'app_user', '%', 'YES', 'YES');

-- 只打开监控、不保留历史事件时,可以独立关闭 HISTORY
-- UPDATE performance_schema.setup_actors
-- SET HISTORY = 'NO'
-- WHERE HOST = 'app.example.com' AND USER = 'app_user' AND ROLE = '%';

匹配顺序会优先寻找更具体的用户和主机组合,然后才回退到通配规则。实践中建议把主机名、用户名和两个开关都写全,再用查询确认表中没有误留的同名主键行。

用更具体的账户规则收窄采集范围

如果同一用户可能从多个地址连接,可以按需求拆成多行。例如,允许本机连接同时保留历史,但来自其他主机的同名账户只做实时监控:

-- 查看当前规则,先确认默认行和账户行是否符合预期
SELECT HOST, USER, ROLE, ENABLED, HISTORY
FROM performance_schema.setup_actors
ORDER BY USER, HOST;

-- 同一用户的本机连接保留监控与历史
INSERT INTO performance_schema.setup_actors
    (HOST, USER, ROLE, ENABLED, HISTORY)
VALUES
    ('localhost', 'app_user', '%', 'YES', 'YES');

-- 其他来源主机只采集事件,不写入该线程的历史记录
INSERT INTO performance_schema.setup_actors
    (HOST, USER, ROLE, ENABLED, HISTORY)
VALUES
    ('%', 'app_user', '%', 'YES', 'NO');

这里的 HOST='localhost' 比 HOST='%' 更具体,因此本机连接会使用第一行。ENABLED 和 HISTORY 可以独立设置,不要把“实时监控”和“历史留存”误认为同一个开关。

已有线程、后台线程还要单独看

修改 setup_actors 只影响修改之后创建的前台线程。连接池里的旧连接不会因为规则改变而自动重新初始化;如果必须立即调整已有会话,应直接更新对应的 threads.INSTRUMENTED 和 threads.HISTORY,并谨慎限定线程范围。

后台线程没有关联用户,setup_actors 不参与匹配,它们默认保持各自的线程监控状态。另一方面,即使目标线程已经是 INSTRUMENTED='YES',还要同时满足 setup_consumers.thread_instrumentation='YES',并且相关 setup_instruments.ENABLED='YES',事件才会真正被采集。历史表还需要对应的 history consumer 开启。

默认通配规则、指定账户、新旧线程与 Performance Schema 消费者边界的结构说明图
图2:采集边界结构图,区分新线程匹配、已有线程修改和后台线程默认行为;连线表达静态关系,不表示执行时间线。

常见误区与速查

  • 只插入目标账户行:默认 %/% 行仍可能让其他新连接被采集。
  • 改完规则马上看旧连接:旧线程不会重新套用 setup_actors,需要单独处理 threads。
  • 只看 INSTRUMENTED:实时监控和历史记录还分别受 consumer、instrument 与 history consumer 影响。

可以把配置记成一句话:通配行负责默认值,具体账户行负责例外;setup_actors 管新前台线程,threads 管现有线程,后台线程则走另一套初始化规则。

相关问题

为什么 setup_actors 改了但历史表还是没有数据? 先看目标线程的 HISTORY,再检查对应 history consumer 与 instrument 是否开启;只打开账户匹配并不等于所有历史链路都打开。

能不能用 setup_actors 关闭后台线程监控? 不能按用户匹配后台线程;后台线程没有关联账户,应根据对应线程配置和当前监控目标单独处理。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>