为 PHP 项目添加慢查询监控告警，是保障数据库性能与系统稳定性的核心防线。
一、慢查询检测：精准捕获问题
▶ 方案 1：MySQL 慢查询日志（推荐）
- 启用配置（
my.cnf）：slow_query_log = 1 slow_query_log_file = /var/log/mysql/slow.log long_query_time = 1 # 超过 1 秒记录 log_queries_not_using_indexes = 1 # 记录未用索引的查询 - 验证：
SHOWVARIABLESLIKE'slow_query%';
▶ 方案 2：Laravel Query Listener（应用层）
// app/Providers/AppServiceProvider.phppublicfunctionboot(){if(app()->environment('production')){DB::listen(function($query){// 记录超过 500ms 的查询if($query->time>500){Log::warning('Slow query detected',['sql'=>$query->sql,'bindings'=>$query->bindings,'time'=>$query->time,'url'=>request()->fullUrl()??'CLI','user_id'=>auth()->id()??'guest']);}});}}✅优势：
- 关联业务上下文（URL、用户 ID）
- 无需 DBA 权限
二、慢查询记录：结构化存储
▶ 存储到专用表（便于分析）
CREATETABLE`slow_queries`(`id`BIGINTAUTO_INCREMENTPRIMARYKEY,`sql`TEXTNOTNULL,`time_ms`INTNOTNULL,`url`VARCHAR(500),`user_id`BIGINT,`created_at`TIMESTAMPDEFAULTCURRENT_TIMESTAMP);▶ Laravel 写入逻辑
// 在 DB::listen 中DB::connection('monitoring')->table('slow_queries')->insert(['sql'=>$query->sql,'time_ms'=>$query->time,'url'=>request()->fullUrl()??'CLI','user_id'=>auth()->id()??null,]);⚠️注意：
使用独立数据库连接（monitoring），避免影响主业务
三、告警机制：实时通知
▶ 方案 1：Laravel 日志 + ELK 告警
- 配置 Logstash：
filter{if[message]=~"Slow query detected"{mutate{add_tag=>["slow_query"]}}} - Kibana 告警规则：
- 条件：
tags:slow_query且count > 5/5min - 动作：发送 Slack/邮件通知
- 条件：
▶ 方案 2：自定义告警服务（轻量级）
// app/Services/SlowQueryAlert.phpclassSlowQueryAlert{publicstaticfunctiontrigger($query){// 避免告警风暴if(Cache::has('slow_query_alert_sent')){return;}// 发送企业微信/钉钉Http::post(config('alert.webhook'),['msgtype'=>'text','text'=>['content'=>"🚨 慢查询告警\nSQL:{$query['sql']}\n耗时:{$query['time']}ms\nURL:{$query['url']}"]]);// 5 分钟内不再告警Cache::put('slow_query_alert_sent',true,300);}}// 在 DB::listen 中调用if($query->time>1000){// 超过 1 秒才告警SlowQueryAlert::trigger($query);}▶ 方案 3：Prometheus + Grafana（高级）
- Exporter：
使用mysqld_exporter采集slow_queries指标 - Grafana 面板：
- 展示慢查询趋势
- 设置告警规则：
rate(mysql_slow_queries[5m]) > 0.1
四、自动化修复建议
▶ 自动生成 EXPLAIN 分析
// 在记录慢查询时$explain=DB::select("EXPLAIN{$query->sql}",$query->bindings);Log::info('Slow query EXPLAIN',['plan'=>$explain]);- 输出示例：
[{"type":"ALL","possible_keys":null,"key":null,"rows":100000,"Extra":"Using where"}] - 解读：
"type": "ALL"表示全表扫描 →急需添加索引
▶ 集成索引建议工具
- 使用
pt-index-usage（Percona Toolkit）：pt-index-usage /var/log/mysql/slow.log --host=localhost - 输出：
ALTER TABLE `orders` ADD INDEX `idx_user_id` (`user_id`);
五、避坑指南
| 陷阱 | 解决方案 |
|---|---|
| 日志爆炸 | 设置long_query_time=1（非 0.1 秒） |
| 生产环境性能影响 | 应用层监听仅记录 >500ms 查询 |
| 敏感信息泄露 | 过滤 SQL 中的密码/手机号：str_replace($bindings, '***', $sql) |
| 告警疲劳 | 实现告警抑制（5 分钟内相同 SQL 不重复告警） |
六、终极心法
“慢查询监控不是为了惩罚代码，
而是为了照亮性能的盲区——
每一次告警，
都是系统在向你低语：
‘这里，还有优化的空间。’”
- 当你忽略慢查询，
你在积累技术债；- 当你响应慢查询，
你在加固系统的护城河。真正的工程能力，
体现在对每一毫秒延迟的敬畏中。
结语
从今天起，为你的 PHP 项目添加慢查询监控：
- 启用 MySQL 慢日志（或 Laravel 监听器）
- 记录到结构化表（关联业务上下文）
- 配置智能告警（避免噪音）
- 生成修复建议（EXPLAIN + 索引推荐）
因为最好的性能优化，
始于对问题的精准捕获，
而非事后的亡羊补牢。
