如何使用Ubuntu PHP日志监控

Ubuntu PHP日志监控实操指南

一 快速定位日志路径

• 常见日志位置与用途如下（按你的PHP 版本与Web 服务器选择）：
  • PHP-FPM：/var/log/php-fpm.log 或 /var/log/php7.x-fpm.log（x 为版本号）
  • Apache：/var/log/apache2/error.log（PHP 错误通常写入此文件）
  • Nginx：/var/log/nginx/error.log（PHP-FPM 错误常与此配合查看）
• 不确定位置时，优先检查对应服务的配置文件（如 php.ini、www.conf、Nginx/Apache 虚拟主机配置）中的 error_log 指令。以上路径在不同系统与配置下可能略有差异，请以实际环境为准。

二 命令行实时监控

• 使用 tail -f 跟踪文件尾部新增内容（最常用、最轻量）：
  • 示例：sudo tail -f /var/log/php7.4-fpm.log
• 同时跟踪多个日志（需安装 multitail）：
  • 安装：sudo apt install multitail
  • 示例：multitail /var/log/php7.4-fpm.log /var/log/nginx/error.log
• 使用 less + F 进入“跟随模式”，按 Ctrl+C 退出跟随：
  • 示例：sudo less +F /var/log/apache2/error.log
• 以上命令适合临时排查与值守观察，配合 grep 可做关键字过滤（如：tail -f … | grep -i “error”）。

三 进阶集中化监控 ELK

• 架构建议：PHP 应用 → Filebeat → Logstash → Elasticsearch → Kibana（集中存储、检索、可视化与告警）。
• 关键配置要点（示例为 8.x 版本）：
  • Filebeat（PHP 服务器）：收集应用与 FPM 日志
    • filebeat.inputs:
      • type: log enabled: true paths:
        • /var/www/html/storage/logs/*.log
        • /var/log/php.log*
    • output.logstash: hosts: [“logstash-server:5044”]
  • Logstash：解析与丰富日志
    • input { beats { port => 5044 } }
    • filter { grok { match => { “message” => “%{TIMESTAMP_ISO8601:timestamp} %{LOGLEVEL:level} %{GREEDYDATA:message}” } } date { match => [“timestamp”,“ISO8601”] target => “@timestamp” } mutate { remove_field => [“timestamp”] } }
    • output { elasticsearch { hosts => [“http://localhost:9200”] index => “php-logs-%{+YYYY.MM.dd}” user => “elastic” password => “your_password” } }
  • Elasticsearch：存储与检索（单节点示例）
    • 配置：network.host: 0.0.0.0；discovery.type: single-node
  • Kibana：可视化与仪表板（默认端口 5601）
• 应用侧建议用 Monolog 输出结构化（JSON）日志，便于 grok 解析与检索。

四 日志轮转与保留策略

• 使用 logrotate 管理日志轮转、压缩与清理，避免磁盘被占满：
  • 手动触发一次轮转：sudo logrotate -f /etc/logrotate.conf
  • 建议为 PHP-FPM 与业务日志单独配置轮转周期、保留份数与压缩，确保长期可观测与合规留存。

五 实用排查与配置要点

• 确保 PHP 错误日志已开启并指向可写路径（编辑 php.ini）：
  • error_reporting = E_ALL
  • log_errors = On
  • error_log = /var/log/php_errors.log
  • 修改后重启服务：sudo systemctl restart apache2 或 sudo systemctl restart nginx（若使用 PHP-FPM，还需重启 php-fpm）
• 快速排查顺序建议：
  • 先看 PHP-FPM 日志（如：/var/log/php7.x-fpm.log）是否有进程异常、慢请求
  • 再看 Web 服务器错误日志（如：/var/log/nginx/error.log 或 /var/log/apache2/error.log）定位请求处理阶段的错误
  • 如启用 Filebeat，确认采集路径、权限与 Logstash/ES 连通性。