企业官网建设流程全解析

为 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`);

五、避坑指南

六、终极心法

“慢查询监控不是为了惩罚代码，
而是为了照亮性能的盲区——
每一次告警，
都是系统在向你低语：
‘这里，还有优化的空间。’”

• 当你忽略慢查询，
  你在积累技术债；
• 当你响应慢查询，
  你在加固系统的护城河。

真正的工程能力，
体现在对每一毫秒延迟的敬畏中。

结语

从今天起，为你的 PHP 项目添加慢查询监控：

1. 启用 MySQL 慢日志（或 Laravel 监听器）
2. 记录到结构化表（关联业务上下文）
3. 配置智能告警（避免噪音）
4. 生成修复建议（EXPLAIN + 索引推荐）

因为最好的性能优化，
始于对问题的精准捕获，
而非事后的亡羊补牢。