Linux下ThinkPHP性能监控

作者：袖梨 2026-06-11

Linux环境下ThinkPHP性能监控方案

一、基础监控手段：日志与中间件

1. 日志记录（内置功能）

ThinkPHP提供内置日志模块，可记录请求、错误及性能相关信息，是基础监控手段。

配置日志：修改application/config.php，设置日志类型为file（存储到runtime/log目录）、日志级别（info/debug/warn/error）：
```
'log' => ['type'=> 'file','var_log_path' => './runtime/log','level' => ['info', 'debug', 'warn', 'error'],],
```

记录日志：通过Log门面记录关键信息，如请求开始/结束、错误堆栈：

thinkfacadeLog::info('请求开始：' . request()->url());thinkfacadeLog::error('数据库查询失败：' . $e->getMessage());

2. 自定义中间件（性能统计）

通过中间件捕获请求耗时、内存使用等指标，扩展基础日志功能。

创建中间件：在app/middleware目录下新建PerformanceMiddleware.php，记录请求耗时：

namespace appmiddleware;use thinkfacadeLog;use thinkmiddlewareBaseMiddleware;class PerformanceMiddleware extends BaseMiddleware{public function handle($request, Closure $next){$start_time = microtime(true);$response = $next($request);$cost_time = microtime(true) - $start_time;Log::info("请求【{$request->url()}】耗时：{$cost_time}秒，内存：".memory_get_peak_usage()/1024/1024."MB");return $response;}}

注册中间件：在application/middleware.php中添加中间件，全局生效：
```
return ['appmiddlewarePerformanceMiddleware'];
```

二、第三方专业监控工具

1. Prometheus + Grafana（开源组合）

适合需要自定义指标、可视化监控的场景，支持实时报警。

步骤：
- 安装Prometheus：在Linux服务器上下载并启动Prometheus，配置prometheus.yml添加ThinkPHP应用作为抓取目标（需应用暴露指标接口）。
- 暴露指标：通过ThinkPHP中间件或扩展（如think-prometheus）收集请求次数、耗时、错误率等指标，暴露为HTTP接口（如/metrics）。
- 配置Grafana：添加Prometheus为数据源，导入ThinkPHP监控面板（如社区提供的ThinkPHP Grafana Dashboard），可视化展示性能趋势。
优势：免费、灵活，可深度定制监控项，适合技术团队自主维护。

2. Datadog（商业工具）

提供全栈监控（应用、数据库、基础设施），支持ThinkPHP无缝集成，无需修改代码即可监控性能。

集成步骤：

安装Datadog Agent：在Linux服务器上安装Datadog Agent，配置datadog.yaml开启PHP监控。
安装PHP SDK：通过Composer安装Datadog PHP库：
```
composer require datadog/php-datadogstatsd
```

配置服务提供者：在app/provider.php中绑定Datadog客户端：

namespace app;use thinkService;use DataDogDogStatsd;class DatadogService extends Service{public function register(){$this->app->bind('datadog', function () {$config = config('datadog'); // 配置文件中定义Agent地址、命名空间等return new DogStatsd($config);});}}

记录性能指标：在控制器或中间件中使用Datadog记录执行时间、错误：

$datadog = app('datadog');$datadog->timing('thinkphp.controller.index.time', microtime(true) - $start_time);$datadog->increment('thinkphp.controller.index.requests');

优势：开箱即用，支持自动发现应用组件（如数据库、缓存），提供报警、分布式追踪等功能，适合企业级应用。

3. New Relic（商业工具）

专注于应用性能管理（APM），提供代码级性能分析、事务追踪、数据库查询分析等功能。

集成步骤：
- 安装New Relic PHP Agent：按照官方文档在Linux服务器上安装Agent，配置与ThinkPHP应用关联。
- 开启APM：在ThinkPHP配置中启用New Relic扩展（如newrelic.so），设置应用名称、许可证密钥。
- 查看监控数据：登录New Relic控制台，查看ThinkPHP应用的性能概览（如响应时间、吞吐量）、慢查询、错误日志等。
优势：深度代码分析，帮助快速定位性能瓶颈（如慢SQL、低效函数），适合复杂应用优化。

三、辅助监控工具

1. Linux系统工具

通过系统自带工具监控ThinkPHP运行的基础环境，快速定位资源瓶颈。

top/htop：实时查看CPU、内存使用率，识别高负载进程。
vmstat：监控系统整体性能（如CPU、内存、IO），分析系统级瓶颈。
iostat：监控磁盘IO性能，排查数据库或文件读写慢问题。
netstat/ss：监控网络连接状态，排查高并发下的网络瓶颈。

2. 数据库监控

ThinkPHP依赖MySQL等数据库，监控数据库性能是保障应用性能的关键。

慢查询日志：开启MySQL慢查询日志（slow_query_log=1），分析执行时间超过阈值的SQL语句，优化索引或查询逻辑。
EXPLAIN命令：对慢查询使用EXPLAIN分析执行计划，检查是否使用了索引、是否存在全表扫描。
数据库监控工具：使用Percona PMM（开源）或Oracle Enterprise Monitor（商业）监控数据库性能，查看查询频率、连接数、缓存命中率等指标。