centos系统中php-fpm日志如何分析

CentOS 上 PHP-FPM 日志分析与排查指南

一 日志位置与类型

• 常见路径与用途如下（不同安装方式或发行版可能略有差异）：
  • /var/log/php-fpm/error.log：PHP-FPM 运行期错误、告警、启动失败等核心信息。
  • /var/log/php-fpm/access.log：按请求记录脚本执行情况（是否启用取决于 access.log 配置）。
  • /var/log/php-fpm/slowlog.log：记录超过阈值的慢脚本（需开启 slowlog 与 request_slowlog_timeout）。
  • 若使用 mod_php，PHP 错误可能写入 /var/log/httpd/error_log；若使用 PHP-FPM + Nginx，Nginx 错误可能写入 /var/log/nginx/error.log。
  • 不确定日志位置时，可用 php --ini 查找 php.ini，并检查其中的 error_log 配置项；也可通过 journalctl -u php-fpm 查看 systemd 日志。

二 快速定位与常用命令

• 实时查看与检索
  • 实时跟踪错误日志：tail -f /var/log/php-fpm/error.log
  • 关键字检索：grep -i “error|warning|fatal” /var/log/php-fpm/error.log
  • 按时间窗口统计错误数（示例为 2025-12-05 10:00–11:00）：
    • awk ‘/2025-12-05 10:00:/,/2025-12-05 11:00:/’ /var/log/php-fpm/error.log | grep -i error | wc -l
• 慢请求定位
  • 列出慢日志中执行时间超过阈值的条目（示例阈值 5 秒，字段索引依日志格式调整）：
    • awk ‘$4 > 5 { print} ’ /var/log/php-fpm/slowlog.log
• 访问特征分析
  • 提取访问日志中的 POST 请求目标：grep -oP ‘POST \K[^ ]+’ /var/log/php-fpm/access.log
  • 统计访问量最高的页面（按路径第 3 段聚合）：
    • awk ‘{ print $7} ’ /var/log/php-fpm/access.log | cut -d’/’ -f3 | sort | uniq -c | sort -nr
• 服务与系统日志联动
  • 查看 PHP-FPM 服务日志：journalctl -u php-fpm -f
• 提示：字段索引与分隔符依赖实际 access.log 格式，必要时先用 head 观察样例行再调整 awk/cut 参数。

三 常见错误模式与处置要点

• 502 Bad Gateway：多为 PHP-FPM 未启动/崩溃 或 监听地址/端口与 Web 服务器不一致。处置：检查状态与重启 systemctl status/restart php-fpm；核对 listen = 127.0.0.1:9000 与 Nginx/Apache 的 FastCGI 配置一致。
• 504 Gateway Timeout：脚本执行超时或 进程/资源不足。处置：调整 request_terminate_timeout（或 pool 的 request_timeout）、提升 pm.max_children，并优化慢脚本。
• Primary script unknown：常见于 Nginx 未正确传递 SCRIPT_FILENAME。处置：确保 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 且 root 路径正确。
• 进程池耗尽（pm.max_children reached）：并发超过上限。处置：结合内存与负载调大 pm.max_children，或改用 dynamic/ondemand 并优化应用。
• Allowed memory exhausted：内存超限。处置：提升 memory_limit，优化代码与查询。
• 文件权限问题：PHP-FPM 运行用户对脚本/目录无权限。处置：校正 user/group 与目录权限，必要时设置 listen.owner/listen.group。
• PHP-FPM 无法启动/端口冲突：配置错误或端口被占用。处置：先 php-fpm -t 校验配置，再检查端口占用与日志细节。

四 配置与运维建议

• 确保错误能被记录与定位
  • 在 php.ini 中开启：error_reporting = E_ALL、log_errors = On、设置 error_log；生产环境建议 display_errors = Off 以避免信息泄露。
• 启用慢日志以发现性能瓶颈
  • 在 www.conf（或对应 pool）中开启：slowlog = /var/log/php-fpm/slowlog.log、request_slowlog_timeout = 5（单位秒，可按业务调整）。
• 变更生效与持续监控
  • 修改配置后执行 systemctl restart php-fpm；日常用 tail -f、grep、awk 或 journalctl -u php-fpm 持续观察。
• 日志轮转与容量控制
  • 使用 logrotate 对 php-fpm.log / error.log / slowlog.log 做按日切割与保留策略，避免磁盘被占满。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！