ubuntu上thinkphp项目的监控方案

在Ubuntu环境下跑ThinkPHP项目，最让人头大的问题是什么？不是代码写不出来，而是项目上线后，你正睡到半夜，突然用户反馈页面打不开，或者请求慢得像蜗牛，你却只能靠重启试试撞大运。说实话，这种“盲人摸象”式的运维，迟早要把项目搞崩。今天就来聊聊，在Ubuntu上给ThinkPHP项目搭一套靠谱的监控方案，从进程守护到性能剖析，一网打尽。

一、进程与文件变更监控：Supervisor

先解决最基础的问题：进程挂了怎么办？代码更新后怎么自动重启？答案就是Supervisor，一个轻量级的进程守护神器。它不仅能保证ThinkPHP进程一直活着，开发环境下还能监听到文件变化自动重启（当然，生产环境不建议用热更新）。

• 安装Supervisor：一条命令搞定——sudo apt-get update && sudo apt-get install supervisor。
• 配置监控：在/etc/supervisor/conf.d/thinkphp.conf里写入下面这段配置。注意替换项目路径和用户信息：

[program:thinkphp]
process_name=%(program_name)s_%(process_num)02d
command=php /path/to/your/thinkphp/project start
autostart=true
autorestart=true
user=your_ubuntu_user
numprocs=1
redirect_stderr=true
stdout_logfile=/path/to/your/thinkphp/project/runtime/log/supervisor.log
stopwaitsecs=3600

• 激活配置：先sudo supervisorctl reread && sudo supervisorctl update让Supervisor认识新配置，然后sudo supervisorctl start thinkphp:*启动监控。之后就算进程意外退出，它也会自动拉起来。

二、性能与错误综合监控：日志+自定义中间件

进程守住了，但性能问题怎么发现？ThinkPHP自带的日志框架和中间件机制，足以应付大部分日常监控需求——不需要额外工具，一顿配置就能搞定。

• 日志配置：在application/config.php里设置日志类型为文件、指定存储路径和记录级别：

'log' => [
    'type' => 'file',
    'var_log_path' => './runtime/log',
    'level' => ['info', 'debug', 'warn', 'error'],
],

• 自定义性能中间件：写一个中间件，在请求进入和结束时掐表，把耗时记入日志。创建app/middleware/PerformanceMiddleware.php：

namespace appmiddleware;
use thinkfacadeLog;
use thinkmiddlewareBaseMiddleware;
class PerformanceMiddleware extends BaseMiddleware {
    public function handle($request, Closure $next) {
        $start = microtime(true);
        $response = $next($request);
        $cost = microtime(true) - $start;
        Log::info("请求耗时: {$cost}秒");
        return $response;
    }
}

• 注册中间件：在application/middleware.php中添加一行：

return [
    'appmiddlewarePerformanceMiddleware'
];

• 错误监控：在application/config.php中开启详细错误日志：

'error_reporting' => E_ALL,
'error_log' => './runtime/error.log',
'exception_format' => 'json',

再配合try-catch捕获异常并记录：

try {
    // 业务逻辑
} catch (Exception $e) {
    thinkfacadeLog::error("捕获异常: " . $e->getMessage());
    return json(['status' => 500, 'msg' => '服务器内部错误']);
}

三、专业APM监控：第三方工具集成

如果你的项目已经上了规模，或者对性能洞察有更高要求，那就要祭出专业的APM工具了。这里介绍两个主流方案：Datadog和Prometheus+Grafana。

1. Datadog

Datadog能提供端到端的应用性能管理和基础设施监控，深入到ThinkPHP的每个请求。集成并不复杂。

• 安装PHP库：composer require datadog/php-datadogstatsd
• 配置参数：创建config/datadog.php，设置Agent地址、端口和应用名称：

return [
    'host' => 'localhost',
    'port' => 8125,
    'namespace' => 'thinkphp_app',
    'tags' => ['env:production'],
];

• 注册服务提供者：在provider.php中绑定Datadog实例：

namespace app;
use thinkService;
use DataDogDogStatsd;
class DatadogService extends Service {
    public function register() {
        $this->app->bind('datadog', function() {
            $config = config('datadog');
            return new DogStatsd($config);
        });
    }
}

• 记录指标：在控制器中调用app('datadog')记录执行时间。比如记录index方法的耗时：

public function index() {
    $datadog = app('datadog');
    $start = microtime(true);
    // 业务逻辑
    $elapsed = microtime(true) - $start;
    $datadog->timing('thinkphp.index_execution_time', $elapsed);
    return 'Hello, ThinkPHP!';
}

2. Prometheus + Grafana

这是开源社区的主力组合，尤其适合分布式系统。Prometheus负责采集和存储指标，Grafana负责可视化展示。

• 部署流程：
  • 在Ubuntu上下载Prometheus，配置prometheus.yml，添加ThinkPHP应用的抓取目标——前提是你的ThinkPHP项目要暴露一个/metrics接口。
  • 暴露指标：可以通过中间件或者第三方库（比如think-prometheus）来生成Prometheus格式的指标数据，像请求总数、错误数、响应时间分位数等。
  • 配置Grafana：添加Prometheus作为数据源，然后创建仪表盘，展示CPU使用率、内存占用、请求延迟等关键图表。这套组合拳打出来，系统状态一目了然。

四、基础系统资源监控：命令行与图形化工具

应用层的监控做完了，系统底层的资源占用也不能忽视。有时候性能瓶颈不在代码，而在CPU、内存或磁盘IO上。

1. 命令行工具

• top/htop：top是系统自带，直接看进程CPU和内存占用。htop需要sudo apt-get install htop，界面更友好，支持鼠标操作和彩色显示。
• ps：想只看PHP进程？ps aux | grep php，快速定位资源大户。
• vmstat/iostat/sar：系统级监控三件套。比如vmstat 1每秒刷新内存、CPU、IO状态；iostat -x 1看磁盘IO细节；sar -u 1追踪CPU利用率变化。这些命令对排查系统负载异常很有帮助。

2. 图形化工具

• Glances：一款跨平台监控神器，支持终端界面和Web界面。安装简单：sudo apt-get install glances，运行glances就能看到CPU、内存、磁盘、网络等实时数据，还能通过浏览器远程访问。
• System Monitor：Ubuntu自带的图形化工具，在“系统”菜单→“系统监视器”找到它。虽然功能简单，但直观展示资源使用情况和进程管理，适合快速看一眼。

最后说一句：监控不是上完工具就完事了。方案选得再好，不趁、不落地、不跟进，都是摆设。从进程守护到系统资源，从日志分析到APM，按需搭配，逐步完善，才能让ThinkPHP项目跑得稳、看得清。