Laravel在Linux上的日志管理有何秘诀

Laravel 在 Linux 上的日志管理秘诀

一 核心配置与通道选择

• 配置集中在 config/logging.php，默认通道为 stack（可聚合多个驱动）。常用驱动：single（单文件，开发便利）、daily（按天分割，生产首选）、syslog（对接系统日志/集中式日志）、slack（即时告警）。生产建议用 stack = daily + slack，既落盘又告警。通过 Log facade 记录：Log::info / warning / error / debug；也可指定通道 Log::channel(‘slack’)->error(…)。这些能力来自 Monolog 的深度集成，简单却灵活。

二 环境与级别的正确姿势

• 区分两个关键开关：应用显示错误的 APP_DEBUG（仅本地开发设为 true，生产务必 false），以及写入日志的最低级别 LOG_LEVEL（如 debug/info/notice/warning/error/critical/alert/emergency）。生产常见做法：APP_DEBUG=false，LOG_LEVEL=error 或 warning，避免日志泛滥与泄露敏感信息。

三 文件轮转与系统级管理

• Laravel 的 daily 通道自带按天分割与保留天数（默认保留 5 天，可在 config/app.php 设置 log_max_files 调整，如 30 天）。但在 Linux 上更推荐用 logrotate 做统一治理（压缩、清理、权限、可执行脚本），路径惯例：/etc/logrotate.conf 与 /etc/logrotate.d/。示例（适配默认 storage/logs/*.log）：
  • 创建配置：/etc/logrotate.d/laravel

    /path/to/your/laravel/storage/logs/*.log {
      daily
      missingok
      rotate 14
      compress
      delaycompress
      notifempty
      create 0640 www-data www-data
      sharedscripts
      postrotate
        # 如用 systemd 且以服务运行，可触发重新打开日志句柄
        # systemctl reload php-fpm.service >/dev/null 2>&1 || true
      endscript
    }
    

  • 调试与强制执行：logrotate -d /etc/logrotate.d/laravel（干跑），logrotate -f /etc/logrotate.d/laravel（强制）。这样可避免单文件无限增长、便于归档与审计。

四 权限与目录准备

• 确保日志目录存在且可写（以 Debian/Ubuntu 的 www-data 为例，路径按实际调整）：
  • 创建目录：sudo mkdir -p /var/www/your_project/storage/logs
  • 设置属主：sudo chown -R www-data:www-data /var/www/your_project/storage/logs
  • 设置权限：sudo chmod -R 755 /var/www/your_project/storage/logs
  • 如使用自定义路径（如 /var/log/laravel.log），同样需 mkdir -p、chown/chmod，保证 Web/PHP 进程可写。

五 集中式日志与告警实践

• 集中式：将日志发往 syslog 或云日志服务（如 Papertrail），便于与 ELK/Graylog/Splunk 集成；在 config/logging.php 配置相应通道即可。告警：在 stack 中加入 slack 通道，将 error 及以上级别即时推送到团队频道，缩短 MTTR。若需结构化检索，可在通道上启用 JSON 格式。示例（思路）：
  • ‘channels’ => [ ‘stack’ => [ ‘driver’ => ‘stack’, ‘channels’ => [‘daily’,‘slack’], ], ‘slack’ => [ ‘driver’ => ‘slack’, ‘url’ => env(‘LOG_SLACK_WEBHOOK_URL’), ‘level’ => ‘error’, ], ]
  • 生产建议：日常文件落盘（daily）+ 关键告警（slack）+ 集中化存储（syslog/ELK），既稳妥又可观测。