当前位置:首页 > 文章列表 > 数据库 > MySQL > MySQL performance_schema.setup_actors 怎样只采集指定账户的前台线程

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

来源:17golang原创 2026-11-19 10:28:31 0浏览 收藏

如果 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删除
Redis XAUTOCLAIM 怎样接管超时的 Stream 消息Redis XAUTOCLAIM 怎样接管超时的 Stream 消息
上一篇
Redis XAUTOCLAIM 怎样接管超时的 Stream 消息
Redis GETBIT 的偏移零为什么对应字节最高位
下一篇
Redis GETBIT 的偏移零为什么对应字节最高位
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1112次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1103次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1273次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1216次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1062次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码