Debian PHP服务如何监控

Debian 上监控 PHP 服务的实用方案

一 监控目标与总体思路

• 保障 PHP-FPM 进程可用与自动恢复：进程存活、崩溃自启、资源限制与重启策略。
• 观测 性能指标：进程池使用率、请求排队、慢请求、响应时延、错误率。
• 收集与告警 日志：FPM 错误日志、慢日志、应用错误日志，结合系统日志与可视化分析。
• 平台化监控：在 Debian 上落地 Zabbix 或 Prometheus 做长期趋势与告警。

二 快速检查与日志定位

• 服务状态与实时日志
  • 检查服务：sudo systemctl status php8.2-fpm（版本号按实际替换）
  • 实时日志：sudo tail -f /var/log/php8.2-fpm.log
• systemd 日志
  • 按服务查看：journalctl -u php8.2-fpm -f
• PHP 错误日志位置
  • 由 php.ini 的 error_log 指令决定，建议统一输出到 /var/log/php-fpm.log 或应用专属目录，便于采集与轮转。
• Web 访问日志（配合定位 PHP 层错误）
  • Nginx：/var/log/nginx/access.log、/var/log/nginx/error.log
  • 实时查看：tail -f /var/log/nginx/access.log

三 PHP-FPM 指标与状态页

• 启用状态页（示例为 Debian 常见路径）
  • 编辑池配置：/etc/php/8.0/fpm/pool.d/www.conf（或 /etc/php-fpm.d/www.conf）
  • 开启：pm.status_path = /php_status
  • 访问控制（示例）：在 Nginx 对该路径仅允许内网访问
    • location ~ ^/(php_status)$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php8.2-fpm.sock; allow 127.0.0.1; deny all; }
  • 重载：sudo systemctl reload php8.2-fpm
  • 验证：curl http://127.0.0.1/php_status
• 常用指标与含义
  • pool：进程池名称
  • processes：总进程数（active + idle）
  • idle：空闲进程数
  • active：活跃进程数
  • max_children：最大子进程数（来自 pm.max_children）
  • slow_requests：慢请求计数（需开启 slowlog）
• 慢请求日志
  • 在池配置中开启：slowlog = /var/log/php-fpm/www-slow.log；request_slowlog_timeout = 5s
  • 用途：定位耗时函数、SQL、外部调用瓶颈

四 进程守护与自动恢复

• 使用 Supervisor 管理 PHP-FPM 或常驻脚本
  • 安装：sudo apt-get install supervisor
  • 示例配置 /etc/supervisor/conf.d/php-fpm.conf
    • [program:php-fpm]
    • command=bash -c “sleep 1 && /usr/sbin/php-fpm8.2 --nodaemonize --fpm-config /etc/php/8.2/fpm/php-fpm.conf”
    • autostart=true；autorestart=true；stderr_logfile=/var/log/supervisor/php-fpm.err.log；stdout_logfile=/var/log/supervisor/php-fpm.out.log
  • 使配置生效：sudo supervisorctl update；sudo supervisorctl reload
• 适用场景
  • FPM 以 前台模式运行时由 Supervisor 托管，异常退出自动拉起
  • 管理 Laravel Queue/自定义常驻脚本：command=/usr/bin/php artisan queue:work --timeout=60 --tries=3

五 平台化监控与告警

• Zabbix
  • 在 Debian 10/11 可部署 Zabbix Server + Apache/PHP 前端 + MariaDB，导入初始数据后通过 Web 界面配置监控项与触发器，覆盖服务器与应用层指标与告警。
• Prometheus
  • 在 Debian 安装 Prometheus：sudo apt-get install prometheus
  • 配置抓取目标（Nginx 状态页、PHP-FPM 状态页、Node Exporter 等），结合 Grafana 做可视化与阈值告警。