使用 Logrotate 实现 Nginx 日志自动轮转与管理

GDBBader

于 2025-03-25 09:27:09 发布

阅读量747

点赞数 16

文章标签： nginx 前端运维

本文链接：https://blog.csdn.net/qq_31646657/article/details/146494154

版权

使用 Logrotate 实现 Nginx 日志自动轮转与管理

文章目录

使用 Logrotate 实现 Nginx 日志自动轮转与管理

在日常的服务器运维工作中，日志管理是一个至关重要的环节。对于使用 Nginx 作为 Web 服务器的环境来说，日志文件的大小会随着时间不断增长，如果不加以管理，可能会占用大量磁盘空间，甚至导致磁盘满载，影响服务器的正常运行。因此，合理地对 Nginx 日志进行轮转和管理是十分必要的。本文将详细介绍如何使用 logrotate 工具来实现 Nginx 日志的自动轮转。

一、什么是 Logrotate？

logrotate 是一个在 Linux 系统中广泛使用的日志轮转工具，它可以按照设定的规则定期自动对日志文件进行切割、压缩、删除等操作，从而有效管理日志文件的大小和数量，避免日志文件无限增长占用过多磁盘空间。它支持多种灵活的配置选项，能够满足不同场景下的日志管理需求。

二、为什么选择 Logrotate？

功能强大：logrotate 提供了丰富的配置选项，可以实现按天、按周、按月等时间周期轮转日志，还可以设置保留的日志文件数量、是否压缩日志等。
自动化程度高：一旦配置完成，logrotate 会根据设定的规则自动运行，无需人工干预，大大减轻了运维人员的工作负担。
与 Nginx 等服务配合良好：logrotate 可以在日志轮转后发送信号给 Nginx，通知其重新打开日志文件，确保日志记录的连续性。

三、Logrotate 的基本配置

在开始配置之前，我们需要先了解 logrotate 的基本配置语法。logrotate 的配置文件通常位于 /etc/logrotate.conf，而针对特定服务（如 Nginx）的配置文件则放在 /etc/logrotate.d/ 目录下。

以下是一个简单的 logrotate 配置示例，用于轮转 Nginx 的日志文件：

/path/to/nginx/logs/*.log {
    daily          # 每天轮转一次日志
    missingok      # 如果日志文件不存在，不会报错
    rotate 7       # 保留最近 7 天的日志文件
    compress       # 对轮转后的日志文件进行压缩
    delaycompress  # 延迟压缩，即在下一次轮转时才压缩上一次轮转的日志文件
    notifempty     # 如果日志文件为空，不会进行轮转
    create 640 nginx nginx  # 创建新的日志文件，权限为 640，所有者为 nginx 用户，所属组为 nginx 组
    sharedscripts  # 对于多个日志文件，只运行一次 postrotate 脚本
    postrotate
        [ -f /path/to/nginx/logs/nginx.pid ] && kill -USR1 `cat /path/to/nginx/logs/nginx.pid`
    endscript
}

配置项说明：

daily：表示每天轮转一次日志文件。也可以使用 weekly（每周）、monthly（每月）等选项。
missingok：如果指定的日志文件不存在，不会报错，logrotate 会继续处理其他日志文件。
rotate 7：表示保留最近 7 天的日志文件，超过 7 天的日志文件会被自动删除。
compress：对轮转后的日志文件进行 gzip 压缩，节省磁盘空间。
delaycompress：延迟压缩，即在下一次轮转时才压缩上一次轮转的日志文件。这可以避免在轮转过程中对正在写入的日志文件进行压缩，导致数据丢失。
notifempty：如果日志文件为空，不会进行轮转操作，避免生成空的日志文件。
create 640 nginx nginx：创建新的日志文件时，设置文件权限为 640（所有者可读写，同组用户可读），所有者为 nginx 用户，所属组为 nginx 组。这需要确保系统中存在 nginx 用户和组。
sharedscripts：对于多个日志文件，只运行一次 postrotate 脚本。如果不设置此选项，每个日志文件都会运行一次 postrotate 脚本。
postrotate：在日志轮转完成后执行的脚本。这里通过发送 USR1 信号给 Nginx，通知其重新打开日志文件，确保日志记录的连续性。

四、安装 Logrotate

在大多数 Linux 发行版中，logrotate 已经预装好了。如果没有安装，可以通过包管理器进行安装。例如，在基于 Debian 的系统（如 Ubuntu）中，可以使用以下命令安装：

sudo apt-get update
sudo apt-get install logrotate

在基于 Red Hat 的系统（如 CentOS）中，可以使用以下命令安装：

sudo yum install logrotate

五、配置 Logrotate 轮转 Nginx 日志

1. 创建 Logrotate 配置文件

在 /etc/logrotate.d/ 目录下创建一个名为 nginx 的配置文件，文件名可以根据实际需求命名，但建议与服务名称一致，便于管理和识别。以下是一个示例配置文件内容：

/path/to/nginx/logs/*.log {
    daily
    missingok
    rotate 7
    compress
    delaycompress
    notifempty
    create 640 nginx nginx
    sharedscripts
    postrotate
        [ -f /path/to/nginx/logs/nginx.pid ] && kill -USR1 `cat /path/to/nginx/logs/nginx.pid`
    endscript
}

2. 配置文件路径说明

/path/to/nginx/logs/*.log：指定 Nginx 日志文件的路径和文件名模式。* 表示匹配该目录下的所有 .log 文件。根据你的实际 Nginx 配置，将路径替换为 Nginx 日志文件的实际存储路径。
/path/to/nginx/logs/nginx.pid：指定 Nginx 的 PID 文件路径。kill -USR1 命令需要通过 PID 文件找到 Nginx 的进程 ID，然后发送信号通知其重新打开日志文件。确保这个路径与你的 Nginx 配置中指定的 PID 文件路径一致。

3. 测试配置文件

在实际应用中，我们可以通过以下命令手动测试 logrotate 配置文件是否正确：

sudo logrotate -d /etc/logrotate.d/nginx

-d 参数表示以调试模式运行 logrotate，它会显示详细的执行过程和可能的错误信息，但不会真正执行日志轮转操作。通过这种方式，我们可以提前发现配置文件中的问题并进行修正。

4. 检查日志轮转是否成功

在确认配置文件无误后，可以手动运行 logrotate 命令来触发日志轮转：

sudo logrotate -f /etc/logrotate.d/nginx

-f 参数表示强制执行日志轮转，即使日志文件的大小或时间条件尚未满足。执行命令后，检查 Nginx 日志文件是否被正确轮转。例如，原本的 access.log 文件应该被重命名为类似 access.log.1 的文件，并且新的 access.log 文件被创建。同时，检查轮转后的日志文件是否被压缩（如果配置了 compress 选项）。