rsyslog配置文件详解（rsyslog.conf）

# rsyslog configuration file

# For more information see /usr/share/doc/rsyslog-*/rsyslog_conf.html

# If you experience problems, see http://www.rsyslog.com/doc/troubleshoot.html

#### MODULES ####

####模块####

# The imjournal module bellow is now used as a message source instead of imuxsock

#加载输入模块（消息来源）

$ModLoad imuxsock 　　　　　　　　# provides support for local system logging (e.g. via logger command)（提供对本地系统日志的支持（例如通过记录器命令））

$ModLoad imjournal 　　　　　　　　# provides access to the systemd journal（提供对systemd日志的访问）

#$ModLoad imklog 　　　　　　　　# reads kernel messages (the same are read from journald)（读取内核消息（从日志读取相同的消息））

#$ModLoad immark  　　　　　　　　# provides --MARK-- message capability（提供--MARK--消息功能）

# Provides UDP syslog reception

#接收使用UDP 协议转发过来的日志

$ModLoad imudp

$UDPServerRun 

# Provides TCP syslog reception

#接收使用TCP 协议转发过来的日志

#$ModLoad imtcp

#$InputTCPServerRun 

#注意：两个协议可以同时监听

#### GLOBAL DIRECTIVES ####
#定义日志格式默认模板

# Where to place auxiliary files

$WorkDirectory /var/lib/rsyslog

# Use default timestamp format

$ActionFileDefaultTemplate RSYSLOG_TraditionalFileFormat

$template myFormat,"%timestamp% %fromhost-ip% %msg%\n"                  #定义模板 $template tplname, string/list/subtree/plugin

$ActionFileDefaultTemplate myFormat                                     #默认使用myFormat模板

# File syncing capability is disabled by default. This feature is usually not required,            #默认情况下禁用文件同步功能。 通常不需要此功能

# not useful and an extreme performance hit

#$ActionFileEnableSync on

# Include all config files in /etc/rsyslog.d/                          #将所有配置文件包含在/etc/rsyslog.d/

$IncludeConfig /etc/rsyslog.d/*.conf

# Turn off message reception via local log socket;                                                   #通过本地日志socket，关闭信息接收

# local messages are retrieved through imjournal now.

$OmitLocalLogging on

# File to store the position in the journal                                                                   #文件存储在日志中的位置

$IMJournalStateFile imjournal.state

#### RULES ####

#定义规则

# Log all kernel messages to the console.

# Logging much else clutters up the screen.

#kern.*                                                 /dev/console                        #关于内核的所有日志都放到/dev/console（控制台）
# Log anything (except mail) of level info or higher.

# Don't log private authentication messages!

*.info;mail.none;authpriv.none;cron.none                /var/log/messages       

#记录所有日志类型的info级别以及大于info级别的信息到/var/log/messages，

#但是mail邮件信息，authpriv验证方面的信息和cron时间任务相关的信息除外

# The authpriv file has restricted access.                                         #authpriv验证相关的所有信息存放在/var/log/secure

authpriv.*                                              /var/log/secure

# Log all the mail messages in one place.       #邮件的所有信息存放在/var/log/maillog; 这里有一个-符号, 表示是使用异步的方式记录, 因为日志一般会比较大

mail.*                                                  -/var/log/maillog

# Log cron stuff                                                    #计划任务有关的信息存放在/var/log/cron

cron.*                                                  /var/log/cron

# Everybody gets emergency messages            #记录所有的大于等于emerg级别信息, 以wall方式发送给每个登录到系统的人

*.emerg                                                 :omusrmsg:*

# Save news errors of level crit and higher in a special file.            #记录uucp,news.crit等存放在/var/log/spooler

uucp,news.crit                                          /var/log/spooler

# Save boot messages also to boot.log                                  #启动的相关信息存放在   /var/log/boot.log

local7.*                                                /var/log/boot.log

# ### begin forwarding rule ###

#转发规则

# The statement between the begin ... end define a SINGLE forwarding   #begin ... end之间的语句定义了一个SINGLE转发

# rule. They belong together, do NOT split them. If you create multiple  #规则。 他们属于一起，不要分裂。 如果你创建多个

# forwarding rules, duplicate the whole block!                #转发规则，重复整个块

# Remote Logging (we use TCP for reliable delivery)       #远程日志记录（我们使用TCP可靠的传送）

# An on-disk queue is created for this action. If the remote host is     #为此操作创建一个磁盘队列。 如果远程主机是down掉，消息被假脱机到磁盘，并在重新启动时发送。

# down, messages are spooled to disk and sent when it is up again.

#$ActionQueueFileName fwdRule1 # unique name prefix for spool files                  #假脱机文件的唯一名称前缀

#$ActionQueueMaxDiskSpace 1g   # 1gb space limit (use as much as possible)       #1gb空间限制（尽可能多使用）

#$ActionQueueSaveOnShutdown on # save messages to disk on shutdown            #关闭时将消息保存到磁盘

#$ActionQueueType LinkedList   # run asynchronously                                                 #使用链接列表模式

#$ActionResumeRetryCount -1    # infinite retries if host is down                               #如果主机关闭，则会无限重试

# remote host is: name/ip:port, e.g. 192.168.0.1:514, port optional

#*.* @@remote-host:514

*.*        @@localhost:5000                                                                                                 #@@表示通过tcp协议发送    @表示通过udp进行转发

# ### end of the forwarding rule ###

延伸知识点：
1. 假脱机
在信息学中，假脱机（外部设备联机并行操作，SPOOL,Simultaneous Peripheral Operations On-line）是一种数据缓冲，指传输数据的过程中，将数据存放在临时工作区中。其它程序可以在之后的任意时间点对其存取。通常英语动词spool可以指储存设备的行为，具体表现为物理意义上的缠或卷，就比如说磁带机。最常见的假脱机的应用是打印缓存，即把打印任务加入到队列。