当前位置：首页 > news >正文

PHP添加慢查询监控告警的庖丁解牛

news 2026/8/12 3:38:13

为 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 不重复告警）