Linux服务器上Laravel日志管理策略

Linux服务器上 Laravel 日志管理策略

一基础配置与日志级别

日志默认位于项目的storage/logs目录，常见文件为laravel.log。Laravel 基于 Monolog，在 config/logging.php 定义通道（channel），默认使用 stack 聚合多个驱动；常见驱动包含：single（单文件）、daily（按天分割）、syslog（对接系统日志）、slack（即时告警）。开发环境可用 single，生产环境推荐 daily 或 stack + daily 组合。日志级别从低到高为：debug、info、notice、warning、error、critical、alert、emergency。在 .env 中设置 LOG_LEVEL=error 可只记录错误及以上级别；也可在 config/logging.php 的通道上设置 level 精细控制。代码示例：
- 使用 Log 门面记录日志：
```
use Illuminate\Support\Facades\Log;
Log::info('用户登录', ['user_id' => 1]);
Log::error('订单处理失败', ['order_id' => 1001, 'exception' => $e]);
```
- 生产建议的 stack 组合（文件落盘 + 关键错误告警）：
```
// config/logging.php
'default' => 'stack',
'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => ['daily', 'slack'],
        'ignore_exceptions' => false,
    ],
    'daily' => [
        'driver' => 'daily',
        'path' => storage_path('logs/laravel.log'),
        'level' => env('LOG_LEVEL', 'error'),
        'days' => env('LOG_DAILY_DAYS', 14),
    ],
    'slack' => [
        'driver' => 'slack',
        'url' => env('LOG_SLACK_WEBHOOK_URL'),
        'level' => 'critical', // 仅关键错误告警
        'style' => 'minimal',
    ],
];
```
以上配置要点与通道选择可满足大多数生产需求，并兼顾检索与告警。

二日志轮转与清理

方式一 Laravel 内置按天轮转
- 使用 daily 驱动并设置 days（保留天数）即可自动按天生成与清理日志文件，例如保留14天。此方式简单、与框架集成度高，适合大多数应用。
方式二系统级 logrotate 轮转
- 为 Laravel 日志单独配置 /etc/logrotate.d/laravel，示例：
```
/path/to/your/laravel/storage/logs/*.log {
    daily
    missingok
    rotate 14
    compress
    notifempty
    create 640 www-data www-data
    sharedscripts
    postrotate
        # 通知 PHP-FPM 重新打开日志文件（按需启用）
        # systemctl reload php-fpm || kill -USR1 `cat /run/php/php-fpm.pid 2>/dev/null` 2>/dev/null || true
    endscript
}
```
- 关键点：
  - 轮转周期与保留天数可按需调整（如 daily/7 或 weekly/4）。
  - create 640 www-data www-data 中的用户组需与 PHP-FPM/Nginx 运行用户一致，避免写入失败。
  - 如使用文件句柄保持（如单进程常驻写入），可在 postrotate 中发送信号触发重新打开日志（如 PHP-FPM 的 USR1）。
方式三兜底清理
- 作为额外防线，可用 cron 定期清理超期日志（避免与 logrotate 重复删除）：
```
# 每天 01:00 删除 14 天前的 .log 文件
0 1 * * * find /path/to/your/laravel/storage/logs -type f -name "*.log" -mtime +14 -delete
```
以上策略覆盖框架内与系统级两种轮转方式，并给出权限与信号注意事项，确保日志文件不会无限增长且始终可写。

三集中化与告警

对接系统日志：使用 syslog 驱动将日志发送到 rsyslog/syslog-ng，便于与 ELK/Graylog/Splunk 等集中式日志平台对接，统一采集、检索与可视化。
即时告警：通过 slack 或 Papertrail/Loggly 等通道，将 error/critical 级别日志实时推送至团队渠道，缩短故障响应时间。
建议做法：生产环境采用 stack = daily + syslog/slack 的组合，既保留本地文件用于取证，又将关键告警与全量日志送往集中平台。

四目录权限与运行用户

确保日志目录可写，运行用户与目录属主保持一致（示例为 www-data，请按实际环境替换为 nginx/apache 用户）：

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

若使用 logrotate 的 create 指令，请保持与运行用户一致，避免轮转后新文件不可写。

五日常运维与排错命令

实时查看最新日志：

tail -f /path/to/your/laravel/storage/logs/laravel.log

检索错误关键字并高亮：

tail -n 200 storage/logs/laravel.log | grep -i -E 'error|exception|failed' --color=auto

按时间范围查看（配合 GNU date）：

# 查看昨天的日志
sed -n "/$(date -d yesterday '+%Y-%m-%d')/p" storage/logs/laravel.log

统计最近 24 小时 ERROR 数量：

grep -c "$(date -d '24 hours ago' '+%Y-%m-%d')" storage/logs/laravel.log

以上命令覆盖日常排查的高频场景，便于快速定位问题。

Linux服务器上Laravel日志管理策略

发表回复