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 字段 | 对应线程状态 | 含义 |
|---|---|---|
ENABLED | INSTRUMENTED | 是否对该线程产生的事件做监控 |
HISTORY | HISTORY | 是否把事件写入历史消费者 |
ROLE | — | 当前用于主键,匹配时不参与实际筛选 |
默认表里通常有 HOST='%'、USER='%'、ENABLED='YES'、HISTORY='YES'。这行会匹配所有新前台连接,所以只添加一行目标账户并不能自然达到“只采集它”的效果。

先把默认通配规则改为关闭
假设只想观察来自 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 开启。

常见误区与速查
- 只插入目标账户行:默认
%/%行仍可能让其他新连接被采集。 - 改完规则马上看旧连接:旧线程不会重新套用 setup_actors,需要单独处理
threads。 - 只看
INSTRUMENTED:实时监控和历史记录还分别受 consumer、instrument 与 history consumer 影响。
可以把配置记成一句话:通配行负责默认值,具体账户行负责例外;setup_actors 管新前台线程,threads 管现有线程,后台线程则走另一套初始化规则。
相关问题
为什么 setup_actors 改了但历史表还是没有数据? 先看目标线程的 HISTORY,再检查对应 history consumer 与 instrument 是否开启;只打开账户匹配并不等于所有历史链路都打开。
能不能用 setup_actors 关闭后台线程监控? 不能按用户匹配后台线程;后台线程没有关联账户,应根据对应线程配置和当前监控目标单独处理。
-
374 收藏
-
499 收藏
-
384 收藏
-
184 收藏
-
265 收藏
-
244 收藏
-
315 收藏
-
数据库 · MySQL | 42分钟前 | MySQL · 慢查询 · 数据库运维 · mysql Performance Schema events_statements_summary_by_digest DIGEST_TEXT SQL性能统计198 收藏
-
152 收藏
-
429 收藏
-
476 收藏
-
121 收藏
-
266 收藏
-
230 收藏
-
366 收藏
-
数据库 · MySQL | 1小时前 | MySQL · 压缩 · 数据存储 · mysql compress VARBINARY UNCOMPRESSED_LENGTH UNCOMPRESS 短字符串压缩338 收藏
-
214 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习