linux logrotate 配置说明

Internet 2022-01-05 13:23:13 views: null

文章目录

1、logrotate介绍

logrotate软件是一个日志管理工具，用于 分割日志，删除旧的日志文件，并创建新的日志文件，起到“转储作用”，可以为系统节省磁盘空间。一般centos系统已经自带安装好了。

logrotate是基于 crontab 运行的，其脚本是 /etc/cron.daily/logtotate ，日志轮转是系统自发完成的，实际运行时，logrotate 会调用配置文件 /etc/logrotate.conf 。可以在 /etc/logrotate.d 目录里放置自定义好的配置文件，用来覆盖 logrotate.conf 的缺省值。

2、配置logrotate

2.1、配置方式

执行脚本： /usr/sbin/logrotate
默认配置文件： /etc/logrotate.conf
自定义配置目录： /etc/logrotate.d/*.conf

/etc/logrotate.conf 通过 include 指令，会引入 /etc/logrotate.d 目录下的自定义的配置文件。

修改配置文件后，并不需要重启服务。 由于 /usr/sbin/logrotate 实际上只是一个可执行文件，不是以 daemon 运行。

默认配置文件： /etc/logrotate.conf ，内容如下：

[root@root /opt]# cat /etc/logrotate.conf

weekly       #  默认每周执行一次日志轮询

rotate 4     #  默认保留4个日志文件

create       # 自动创建新的日志文件，新的文件和原来的文件具有相同的权限

dateext      #  日志切割后，文件以当前日志为结尾，例如：messages-20181125

#compress   # 指定不压缩转储文件，如果需要压缩，去掉注释就可以了。

include /etc/logrotate.d     # 将/etc/logrotate.d目录中的配置文件加载进来

/var/log/wtmp {
    
               # 针对wtmp日志的配置参数
    monthly                # 每月切割一次
    create 0664 root utmp  # 新建日志的权限为0644，用户为root，组为utmp
    minsize 1M             # 文件大小超过1M后才会切割
    rotate 1               # 只保留1个日志文件
}

/var/log/btmp {
    
    
    missingok
    monthly
    create 0600 root utmp    #新建日志的权限为0644，属主为root，属组为utmp
    rotate 1
}

# system-specific logs may be also be configured here.

/etc/logrotate.d/ 目录，通常一些第三方软件包的配置， 如 yum，zabbix-agent，syslog，nginx 等。

下面是 yum 的配置内容：

[root@gop-sg-192-168-56-103 logrotate.d]# cat yum
/var/log/yum.log {
    
    
    missingok
    notifempty
    size 30k
    yearly
    create 0600 root root
}

3、logrotate 参数

参数 说明
daily
weekly
monthly
yearly		 切割周期，多久切割一次。
daily ： 切割周期为 每天
weekly ： 切割周期为 每周
monthly ： 切割周期为 每月
yearly： 切割周期为 每年
size size 当日志文件到达指定的大小时才转储。
默认单位是 bytes。bytes (缺省) 及 KB (sizek) 或 MB (sizem)
如： size 30k、 size 50M
rotate count 日志文件保留备份的个数。默认是 0 。
如：0 指没有备份；5 指保留最近的5个备份，其余的全部删除。
maxage count 保留多少天的日志文件。
如：5 指保留最近的5天的日志文件，其余的全部删除。
如果 日志文件按天转储，则 rotate 与 maxage 基本上是一样的。
tabooext [+] list 让 logrotate 不转储指定扩展名的文件，缺省的扩展名是：.rpm-orig, .rpmsave, v, 和～
missingok missing ok ，在日志轮循期间，错误将被忽略。
例如 “文件无法找到” 之类的错误。
copytruncate
nocopytruncate		 copytruncate： 用于还在打开中的日志文件，把当前日志备份并截断。 把正在输出的日志拷 (copy) 一份出来，再清空 (trucate) 原来的日志。
nocopytruncate： 备份日志文件，但是不截断 。
create mode owner group
nocreate		 create mode owner group：转储文件，使用指定的文件模式创建新的日志文件。
nocreate： 不建立新的日志文件。
如： create 644 root root
以指定的权限创建全新的日志文件，同时 logrotate 也会重命名原始日志文件。
nocompress
compress		 nocompress： 不压缩（默认）
compress： 通过 gzip 压缩转储以后的日志。如 XXX.gz
delaycompress
nodelaycompress		 delaycompress： 和 compress 一起使用时，转储的日志文件到下一次转储时才压缩。
nodelaycompress： 覆盖 delaycompress 选项，转储同时压缩。
prerotate/endscript 在所有其它指令完成 前 执行。这两个关键字必须单独成行
postrotate/endscript 在所有其它指令完成 后 执行。这两个关键字必须单独成行
sharedscripts 共享脚本，整个日志组运行一次脚本 。
比如 nginx 涉及到多个日志文件，一般使用 * 号 通配符：/var/log/nginx/*.log { ... } ，
sharedscripts 的作用是在 所有的日志文件 都轮转完毕后 统一执行一次脚本 ；
如果没有 sharedscripts ，那么 每个日志文件 轮转完毕后 都会执行一次脚本 。
errors address 转储时的错误信息发送到指定的 Email 地址。
mail address
nomail		 mail address ： 把转储的日志文件发送到指定的 E-mail 地址
nomail ： (默认)转储时不发送日志文件
ifempty
notifempty		 ifempty ：if empty ，即使是空文件也转储（默认）。
notifempty ：not if empty ，如果是空文件的话，不转储。
olddir directory
noolddir		 olddir directory ：储后的日志文件放入指定的目录，必须和当前日志文件在同一个文件系统。
noolddir ： 转储后的日志文件和当前日志文件放在同一个目录下。
dateext 在日志名称后面，添加日期后缀。默认是当前日期。默认是 -%Y%m%d 的后缀。
可用 dateformat 选项扩展配置。
如：nginx_access.log --> nginx_access.log-20210120
注意： 格式化日期中不要出现 分号(:) ，因为名称是不能含有分号的。
dateformat dateext的拓展，必须配合 dateext 使用，只支持 %Y、%m、%d、%s 这四个参数。
在早期版本，只支持 %Y、%m、%d 三个参数。
后续版本，又逐步增加 %H、%s 两个参数。
如： dateformat -%Y-%m-%d
结果：nginx_access.log --> nginx_access.log-2021-01-20
注意：文件名称中禁止出现分号(:)
dateyesterday 与 dateext 配合使用，后缀日期提前一天。
比如，当前日期是2021-01-20，提前一天就是 2021-01-19
extension 与 dateext 、dateformat 配合使用，指定文件的后缀。
如：extension .log
结果：nginx_access.log --> nginx_access-2021-01-20.log
说明：nginx_access.log ， 文件名是nginx_access，后缀是.log， 文件名 + -%Y-%m-%d 格式的日期 + .log 后缀，结果是 nginx_access-2021-01-20.log

问题1：rotate 和 maxage 的区别？

它们都是用来控制保存多少日志文件的，区别在于rotate是以个数为单位的，而maxage是以天数为单位的。如果我们是以按天来轮转日志，那么二者的差别就不大了。

问题2：create 和 copytruncate 的区别。

create 和 copytruncate 都是 创建日志文件，但是差别挺大的。

1）create（创建文件）：

这也就是默认的方案，可以通过 create 命令配置文件的权限和属组设置；这个方案的思路是 重命名原日志文件，创建新的日志文件。

详细步骤如下：

  • 重命名正在输出日志文件，因为重命名只修改目录以及文件的名称，而进程操作文件使用的是 inode，所以并不影响原程序继续输出日志。

  • 创建新的日志文件，文件名和原日志文件一样，注意，此时只是文件名称一样，而 inode 编号不同，原程序输出的日志还是往原日志文件输出。

  • 最后通过某些方式通知程序，重新打开日志文件；由于重新打开日志文件会用到文件路径而非 inode 编号，所以打开的是新的日志文件。

这也就是 logrotate 的默认操作方式，也就是 mv+create 执行完之后，通知应用重新在新文件写入即可。mv+create 成本都比较低，几乎是原子操作，如果应用支持重新打开日志文件，如 syslog, nginx, mysql 等，那么这是最好的方式。

不过，有些程序并不支持这种方式，压根没有提供重新打开日志的接口；而如果重启应用程序，必然会降低可用性，为此引入了 copytruncate 方式。

2）copytruncate（复制、清空）：

该方案是把正在输出的日志拷 (copy) 一份出来，再清空 (trucate) 原来的日志。
详细步骤如下：

  • 将当前正在输出的日志文件复制为目标文件，此时程序仍然将日志输出到原来文件中，此时，原文件名也没有变。
  • 清空日志文件，原程序仍然还是输出到预案日志文件中，因为清空文件只把文件的内容删除了，而 inode 并没改变，后续日志的输出仍然写入该文件中。

如上所述，对于 copytruncate 也就是先复制一份文件，然后清空原有文件。
通常来说，清空操作比较快，但是如果日志文件太大，那么复制就会比较耗时，从而可能导致部分日志丢失。不过这种方式不需要应用程序的支持即可。

4、dateformat 配置示例

4.1、示列1

production.log 转储后的名称是 production.2016-07-10.log 。

dateext
dateformat %Y-%m-%d.  # 修改了默认日期后缀，注意后面有一个点(.)

/var/test/production.log
{
    
    
        create 755 www-data www-data
        extension log   # 后缀为log
}

说明，对于 nginx_access.log ，如果 后缀是 log ，则 文件名是 nginx_access. ，
新文件是由 文件名 + %Y-%m-%d. 格式的日期 + log 后缀组成的，结果是 nginx_access.2021-01-20.log 。

4.2、示列2

production.log 转储后的名称是production-2016-07-10.log 。

dateext
dateformat -%Y-%m-%d

/var/www/redmine/log/production.log
{
    
    
	extension .log
}

说明：对于 nginx_access.log ，如果 后缀是 .log ，则 文件名是 nginx_access ，
新文件是由 文件名 + -%Y-%m-%d 格式的日期 + .log 后缀 组成的，结果是 nginx_access-2021-01-20.log 。

4.3、nginx 完整示例

[root@linux-node1 ~]# cat /etc/logrotate.d/nginx 
  /var/log/nginx/*.log {
    
         # 日志文件的路径
        daily                # 每天进行日志分割
        dateext              # 日志切割后，文件以当前日志为结尾，例如：access-logs-20181125
        missingok            # 日志不存在分析，分析下一个
        rotate 30            # 日志保留30份 
        compress             # 转存之后压缩.tar.gz
        delaycompress        # 日志压缩会被延后到下次分割时进行
        notifempty           # 空文件不转储
        create 644 nginx adm # 新日志文件权限
        sharedscripts        # 整个日志组运行一次脚本
        postrotate
            [ -f /var/run/nginx.pid ] && kill -USR1 `cat /var/run/nginx.pid`  # 重启nginx，重新加载日志文件，防止日志无法写入新文件 
        endscript            # 结束脚本
  }

5、测试和运行 logrotate

具体 logrotate 命令格式如下：

logrotate [OPTION...] <configfile>
-d, --debug ：debug 模式，测试配置文件是否有错误。
-f, --force ：强制转储文件。
-m, --mail=command ：压缩日志后，发送日志到指定邮箱。
-s, --state=statefile ：使用指定的状态文件。
-v, --verbose ：显示转储过程。

5.1、debug 模式：

并不会真正进行 rotate 或者 compress 操作，但是会打印出整个执行的流程，和调用的脚本等详细信息。

logrotate -d <configfile>

示例：

myTest_rotate 的配置内容：

## 测试专用
/var/tmp/logtest/myTest.log {
    
        
	size 2k
	rotate 10
    notifempty	
	dateext
	dateformat -%Y-%m-%d.
    create 644 root root
	extension log
}

运行：

[root@web-serv-0002 local]# logrotate -d  /var/tmp/logtest/myTest_rotate 
reading config file /var/tmp/logtest/myTest_rotate
extension is now log
Allocating hash table for state file, size 15360 B

Handling 1 logs

rotating pattern: /var/tmp/logtest/myTest.log  2048 bytes (10 rotations)
empty log files are not rotated, old logs are removed
considering log /var/tmp/logtest/myTest.log
  log needs rotating
rotating log /var/tmp/logtest/myTest.log, log->rotateCount is 10
Converted ' -%Y-%m-%d.' -> '-%Y-%m-%d.'
dateext suffix '-2022-01-04.'
glob pattern '-[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9].'
glob finding old rotated logs failed
renaming /var/tmp/logtest/myTest.log to /var/tmp/logtest/myTest.-2022-01-04.log
creating new /var/tmp/logtest/myTest.log mode = 0644 uid = 0 gid = 0

5.2、verbose 模式

会真正执行操作，打印出详细信息。

logrotate -v <configfile>

5.3、force 强制执行

如果时间不符合要求，logrotate 也不会真正执行时，如果想要立即执行，查看结果，就使用到了 强制执行模式。

logrotate -f <configfile>

示例：

logrotate -f  /var/tmp/logtest/myTest_rotate

6、logrotate 默认运行时间

logrotate 是基于cron 运行的，所以这个时间是由 cron 控制的，具体可以查询 cron 的配置文件/etc/crontab 。

旧版CentOS 的cron 的配置文件是 /etc/crontab ，新版CentOS 改为 /etc/anacrontab 。

[root@linux-node1 ~]# cat /etc/anacrontab         #生效时间是在凌晨3点到22点之间，而且随机延迟时间是45分钟
  # /etc/anacrontab: configuration file for anacron

  # See anacron(8) and anacrontab(5) for details.

  SHELL=/bin/sh
  PATH=/sbin:/bin:/usr/sbin:/usr/bin
  MAILTO=root
  # 添加到作业基本延迟的最大随机延迟
  RANDOM_DELAY=45
  
  # the jobs will be started during the following hours only
  START_HOURS_RANGE=3-22

  #period in days   delay in minutes   job-identifier   command
  1    5    cron.daily        nice run-parts /etc/cron.daily
  7    25    cron.weekly        nice run-parts /etc/cron.weekly
  @monthly 45    cron.monthly        nice run-parts /etc/cron.monthly

从上面的内容可以看出：

  • 如果机器 没有关机，默认 logrotate（配置文件里设置的是cron.daily）一般会在每天的3点05分到3点50分之间执行， 真实的延迟时间是 RANDOM_DELAY + delay in minutes。
  • 如果在3-22 这个时间段内服务器处于 关机状态，则 logrotate 会在机器开机5分钟后执行分割日志的操作。

注意：

不建议直接修改此文件，如果想按照 logrotate 默认时间的执行，可通过 crontab 执行自定义的 logrotate 配置文件。

但是，这时就不能将自定义的配置文件放置在 /etc/logrotat.d/ 目录下，应该放置另外的路径，否则就会执行两遍日志分割的操作，执行时间分别是在crontab中定义的时间 和 anacrontab 默认的执行时间，即 3:05-3:50。

7、crontab 定时

正常的日志分割，大多数都是按天进行的，即每个日志只记录0-24点之间的内容，如果是按默认的anacrontab 设定的执行时间那肯定是不行的（不是一个完整的日期，执行切割日志的时间是随机的）。推荐使用 crontab 来定时执行 logrotate 文件。

具体实现方法：

1、在非 /etc/logrotate.d/ 下创建目录，例如，在 /etc 目录下创建 logrotate_mytime 目录， 然后 ，将 nginx 的 logrotate 的配置文件 nginx_rotate，放到 /etc/logrotate_mytime 目录下。

2、 添加 crontab 计划任务

在 root 用户下执行 crontab -e 进入 vim 模式，进行编辑。

[root@web-serv-0002 local]# crontab -e

#每天 23点59分进行日志切割
59 23 * * * /usr/sbin/logrotate -f /etc/logrotate_mytime/nginx_rotate

也有简单方式，如下：

sudo echo "59 23 * * * /usr/sbin/logrotate -f /etc/logrotate.daily.0/nginxLogrotate" > /etc/crontab

如果用非root用户则会报错error： error creating output file /var/lib/logrotate/logrotate.status.tmp: 权限不够 。

说明：
如果 crontab 中定义的执行时间是0点，则需要在 nginx_rotate 里添加上 dateyesterday 选项，否则，日志内容记录的是昨天的，而 日志名称格式却是今天的。

如果 crontab 中定义的执行时间是23点59分，这样的则不用添加 dateyesterday 选项。

3、 重启crontab

# centos6: 
service crond restart

# centos7: 
systemctl restart crond

7.1、crontab 常用命令

查看所有的定时任务

[root@web-serv-0002 local]# crontab -l
.....(省略)
59 23 * * * /usr/sbin/logrotate -f /etc/logrotate_mytime/nginx_rotate
.....(省略)

编辑定时任务

[root@web-serv-0002 local]# crontab -e   # 进入vim 模式
.....(省略)
59 23 * * * /usr/sbin/logrotate -f /etc/logrotate_mytime/nginx_rotate
.....(省略)

8、常见应用的 logrotate 配置

1）nginx

配置文件1：

/var/log/nginx/*.log {
    
       # 可以指定多个路径
    daily                      # 日志轮询周期，weekly,monthly,yearly
    rotate 30                  # 保存30天数据，超过的则删除
    size +100M                 # 超过100M时分割，单位K,M,G，优先级高于daily
    compress                   # 切割后压缩，也可以为nocompress
    delaycompress              # 切割时对上次的日志文件进行压缩
    dateext                    # 日志文件切割时添加日期后缀
    dateformat -%Y-%m-%d
    missingok                  # 如果没有日志文件也不报错
    notifempty                 # 日志为空时不进行切换，默认为ifempty
    create 640 nginx nginx     # 使用该模式创建日志文件
    sharedscripts              # 所有的文件切割之后只执行一次下面脚本
    postrotate
        if [ -f /run/nginx.pid ]; then
            kill -USR1 `cat /run/nginx.pid`
        fi
    endscript
}

配置文件2：

/var/log/nginx/*.log {
    
    
	daily
	rotate 30
	missingok
    notifempty
	olddir nginx_archive
	dateext
	dateformat -%Y-%m-%d
	dateyesterday
    copytruncate		
}

配置文件1与配置文件2的最大区别是日志文件是创建方式，一个是 create，另一个是 copytruncate。

转载：

https://www.cnblogs.com/uglyliu/p/13206868.html
https://www.jianshu.com/p/ec7f1626a3d3
https://blog.csdn.net/liuxiao723846/article/details/100120058

Supongo que te gusta

Origin blog.csdn.net/xiaojin21cen/article/details/122309230
Recomendado
Clasificación
Diario
Más
2024-05-09(31)
2024-05-08(18)
2024-05-07(35)
2024-05-06(4)
2024-05-05(0)
2024-05-04(17)
2024-05-03(8)
2024-05-02(0)
2024-05-01(4)
2024-04-30(33)

Code World

© 2018 codetd.com