Ubuntu 设置 log 级别

Linux环境下使用rsyslog管理日志

 
 

在 Linux 系统中,日志文件记录了系统中包括内核、服务和其它应用程序等在内的运行信息。
在咱们解决问题的时候,日志是很是有用的,它能够帮助咱们快速的定位遇到的问题。php

在 Cent OS 6中,日志是使用rsyslogd守护进程进行管理的,该进程是以前版本的系统中syslogd的升级版,对原有的日志系统进行了功能的扩展,提供了诸如过滤器,日志加密保护,各类配置选项,输入输出模块,支持经过 TCP 或者 UDP 协议进行传输等。css

rsyslog的配置文件为 /etc/rsyslog.conf , 大多很多天志文件都位于 /var/log/ 目录中。html

定位日志文件

大多很多天志文件都位于 /var/log/ 目录中。在该目录中,你可能注意到不少日志文件末尾包含一串数字(如 maillog-20150301 ),这说明这些日志文件通过了日志转储,这样能够避免日志文件过大。linux

在软件包logrotate中包含了一个定时任务,根据/etc/logrotate.conf文件和/etc/logrotate.d/目录中的的配置按期的转储日志文件。nginx

Rsyslog基本配置

Rsyslog 的主要配置文件为 /etc/rsyslog.conf 文件,在配置文件中,咱们经过配置 filter 以及 action 对日志进行管理。正则表达式

rsyslog配置文件中,使用以下格式定义规则sql

filter        action 

rsyslog发现符合 filter 规则的日志后,会将日志发送到 action 指定的动做进行处理。typescript

Filter

rsyslog中,提供了三种方式的过滤器方法:数据库

基于设施/优先级的过滤器 (Facility/Priority-based filters)

基于设施/优先级的过滤器是最经常使用的方法,语法以下:segmentfault

FACILITY.PRIORITY 

FACILITY指定了产生日志消息的子系统,可选值为 auth , authpriv , cron , daemon , kern , lpr , mail , news , syslog , user , ftp , uucp , local0 ~ local7

PRIORITY指定了日志消息的优先级,可用的优先级包含 debug (7) , info (6) , notice (5) , warning (4) , err (3) , crit (2) , alert (1) , emerg (0)

前置符号=代表只有该优先级的消息会被捕获,!代表除了该优先级的消息以外的优先级会被捕获。除了前置符号外,可使用符号*

表示全部的设施或者优先级,对优先级部分使用none关键字会捕获全部没有指定优先级的消息。

定义多个设施或者优先级使用,分隔,若是是多个 filter 的话,则使用;进行分隔。

使用范例

kern.*                    # 选择全部优先级的内核日志 mail.crit # 选择全部mail 的优先级高于crit的日志 cron.!info,!debug # 选择除了 info 和 debug 优先级的 cron 日志 
基于属性的过滤器

基于属性的过滤器语法

:PROPERTY, [!]COMPARE_OPERATION, "STRING" 

:PROPERTY是要比较的日志属性,COMPARE_OPERATION 为要执行的比较操做,这个的!表示取反的意思,"STRING"为比较的值。

可使用的比较操做:

比较操做 描述
contains 匹配提供的字符串值是不是属性的一部分,若是不区分大小写,使用contains_i
isequal 比较属性和值是否相等
startswith 属性是否以指定字符串开始(startswith_i)
regex 正则表达式(POSIX BRE 基本正则)匹配
ereregex 正则表达式(POSIX ERE 扩展正则)匹配
isempty 判断属性是否为空,不须要 value

使用范例:

:msg, contains, "error" :hostname, isequal, "host1" :msg, !regex, "fatal .* error" 
基于表达式的过滤器

基于表达式的过滤器使用了rsyslog自定义的脚本语言RainerScript构建复杂的filter,这里暂时不对这种方法进行讲述。

Action

Action定义了当匹配指定的 filter 的时候,执行什么操做。

若是要指定多个 ACTION, 使用 &链接多个 ACTION。
例如:

kern.=crit user1
   & ^test-program;temp & @192.168.0.1 

这里的;temp指定了传递日志给 test-program 程序时( ^ 开头代表日志发送给该可执行文件),使用它 temp 模板格式化日志。

在 ACTION 后面追加;模板名称能够为指定的 action 使用该模板格式化日志。

保存日志到日志文件

语法:

FILTER PATH 

这里的 PATH 指定了日志要保存到的文件。例如 cron.* /var/log/cron.log 指定了全部的定时任务日志都写入到/var/log/cron.log文件。

默认状况下,每次生成 syslog 的时候,日志信息会同步到日志文件。能够在文件路径前使用 - 指定忽略同步(若是系统崩溃,会丢失日志,可是这样能够提升日志性能)。

除了上述方法记录日志(静态),也能够动态的生成日志文件。

FILTER ?DynamicFile 

这里的DynamicFile是预约义的输出路径模板。

经过网络发送syslog

rsyslog可使用网络将日志消息发送或者接受日志,使用这个特性,能够实现使用单一的日志服务器统一管理多台服务器日志。

@[(zNUMBER)]HOST:[PORT] 

这里的@告诉syslog使用 UDP 协议发送日志,要使用 TCP 的话,使用 @@。可选值zNUMBER设置了是否容许使用zlib对日志压缩(压缩级别1-9)。

使用范例

*.* @192.168.0.1 # 使用 UDP 发送,默认端口514 *.* @@example.com:18 # 使用 TCP 发送到端口18, 默认10514 *.* @(z9)[2001:db8::1] # UDP, ipv6,使用zlib级别9压缩 
丢弃日志

要丢弃日志消息,使用~动做。

FILTER ~ 

例如:

cron.* ~

模板

任何rsyslog生成的日志均可以根据须要使用模板进行格式化,要建立模板,使用以下指令

$template TEMPLATE_NAME,"text %PROPERTY% more text", [OPTION] 

这里的$template指令代表了接下来的内容定义了一个模板,TEMPLATE_NAME是模板的名称,接下来双引号之间的内容为模板的内容。

这里还有一个 OPTION , 它指定了模板的功能,支持选项为sqlstdsql,在使用数据库存储的时候会用到。

生成动态文件名

模板能够用来生成动态文件名,就如以前所述,在使用动态文件名的时候,须要在 ACTION 中的模板名称前增长?代表该文件名是动态生成的。

例如:

$template DynamicFile,"/var/log/test_logs/%timegenerated%-test.log" *.* ?DynamicFile 

timegenerated属性从日志信息中提取出消息的时间戳,这样能够为每一个日志生成惟一文件名称。

属性

在模板中使用的属性是在%之间的内容,使用属性能够访问日志消息中的内容。

%PROPERTY_NAME[:FROM_CHAR:TO_CHAR:OPTION]% 

可用的属性列表见man rsyslog.conf

全局指令

全局指令是rsyslogd守护进程的配置指令。全部的全局指令必须以$开始,每行只能有一个指令,例如:

$MainMsgQueueSize 50000 

在新的配置格式中(rsyslog v6),已经不在使用这种方式的指令,可是它们仍然是可用的。

队列

在 rsyslog 中,队列用来传输数据,当 rsyslog 接收到一个消息的时候,首先传递消息预处理器,而后加入到主消息队列,接下来消息会从队列中取出传递给规则处理器。

Message Flow in Rsyslog

规则处理器是一个解析过滤引擎,它会基于配置文件中定义的规则,执行相应的动做(action),每个动做都有本身的动做队列,消息经过这个队列发送到对应的动做处理器,而后输出。

对于同一个消息来讲,能够同时传递这个消息给多个动做队列。

定义队列

在配置文件/etc/rsyslog.conf文件中

$objectQueueType queue_type

这里的队列类型可选值为 direct , linkedlist , fixedarray (内存队列), 或者 disk

默认状况下,对于主队列,使用的是FixedArray队列(10000个消息长度),动做队列采用的是direct 队列。

PHP 使用 syslog 输出日志

在PHP 中,调用系统日志系统的函数有三个

bool openlog ( string $ident , int $option , int $facility ) bool syslog ( int $priority , string $message ) bool closelog ( void ) 

函数openlog用于打开到系统日志系统的链接,第一个参数$ident是一个字符串,syslog 会将该字符串自动加到使用syslog函数输出的全部日志消息的前面。第二个参数是日志选项,第三个参数是记录日志的设施。

函数openlog()closelog()是可选的。

例如,咱们在/etc/rsyslog.conf配置文件中增长以下配置

local5.*     /tmp/php_test.log 

增长后须要重启 rsyslog 进程(sudo /etc/init.d/rsyslog restart)

在 PHP 脚本中,执行以下操做

<?php openlog("LogHeader", LOG_PID, LOG_LOCAL5); syslog(LOG_DEBUG, "Hello, Logger"); 

执行上述脚本,咱们能够在/tmp目录中看到出现名为php_test.log的文件

Mar 10 14:47:04 vm-hp LogHeader[8261]: Hello, Logger 

第一部分Mar 10 14:47:04为日志时间,第二部分vm-hp为主机的 HOSTNAME , 咱们在 调用openlog函数的时候,指定了 indentLogHeader, 同时在日志中加入进程的 PID(LOG_PID)。

上述日志消息,若是要使用模板的话,是下面这样的

$template LOG_TMP,"%timegenerated% %HOSTNAME% %msg%" local5.* /tmp/php_test.log;LOG_TMP 

咱们将全部支持的模板属性变量输出以下

msg: Hello, Logger, rawmsg: <175>Mar 10 15:52:49 LogHeader[13845]: Hello, Logger, HOSTNAME: vm-28-234-pro01-hp, FROMHOST: vm-28-234-pro01-hp, syslogtag: LogHeader[13845]:, programname: LogHeader, PRI: 175, PRI-text: local5.debug, IUT: 1, syslogfacility: 21, syslogfacility-text: local5, syslogseverity: 7, syslogseverity-text: debug, timereported: Mar 10 15:52:49, TIMESTAMP: Mar 10 15:52:49, timegenerated: Mar 10 15:52:49, PROTOCOL-VERSION: 0, STRUCTURED-DATA: -, APP-NAME: LogHeader, PROCID: 13845, MSGID: - 

参考: Red Hat Enterprise linux 6 Deployment Guide: Chapter 23. Viewing and Managing Log Files

相关文章
相关标签/搜索