天天看點

linux syslog 筆記

 ​

Linux日記系統由系統日志監控程式syslogd和核心日志監控程式klogd組成。從它們的命名可以看到,這兩個監控程式都是守護程式(daemon),且都注冊成了系統服務。換句話說,我們可以在目錄/etc/init.d/下找到它們對應的執行程式,并通過service指令對它們進行啟動,關閉,重新開機等操作。/etc/syslog.conf檔案是Linux日記系統的配置檔案。下面是本人/etc/syslog.conf檔案内容(ubuntu下為/etc/rsyslog.conf):

  1. # Log all kernel messages to the console.  
  2. # Logging much else clutters up the screen.  
  3. #kern.*                                                 /dev/console  
  4. # Log anything (except mail) of level info or higher.  
  5. # Don't log private authentication messages!   
  6. *.info;mail.none;authpriv.none;cron.none                /var/log/messages  
  7. # The authpriv file has restricted access.   
  8. authpriv.*                                              /var/log/secure  
  9. # Log all the mail messages in one place.   
  10. mail.*                                                  -/var/log/maillog  
  11. # Log cron stuff   
  12. cron.*                                                  /var/log/cron  
  13. # Everybody gets emergency messages   
  14. *.emerg                                                 *  
  15. # Save news errors of level crit and higher in a special file.   
  16. uucp,news.crit                                          /var/log/spooler  
  17. # Save boot messages also to boot.log   
  18. local7.*                                                /var/log/boot.log  

在對這個配置檔案進行詳細的解釋之前,我們先看一下在Linux C程式設計中如何利用syslog進行日記。

syslog APIs

Linux C中提供一套系統日記寫入接口,包括三個函數:openlog,syslog和closelog。

調用openlog是可選擇的。如果不調用openlog,則在第一次調用syslog時,自動調用openlog。調用closelog也是可選擇的,它隻是關閉被用于與syslog守護程序通信的描述符。

下面是這三個函數的調用格式:

  1. #include <syslog.h>   
  2. void openlog(char *ident, int option, int facility);   
  3. void syslog(int priority, char *format, ...);   
  4. void closelog();  

其中openlog和closelog都是可選的。不過,通過調用openlog,我們www.linuxidc.com可以指定ident參數。這樣,ident将被加到每條日記記錄中。ident一般設成程式的名字,如在下面例子中的"testsyslog":

  1. int main(int argc, char *argv[])   
  2. {   
  3.     openlog("testsyslog", LOG_CONS | LOG_PID, 0);   
  4.     syslog(LOG_USER | LOG_INFO, "syslog test message generated in program %s \n", argv[0]);   
  5.     closelog();   
  6.     return 0;   
  7. }  

編譯生成可執行檔案後,每運作一次,程式将往/var/log/messages添加一條如下的記錄:

  1. Apr 23 17:15:15 lirong-920181 testsyslog[27214]: syslog test message generated in program ./a.out  

格式基本是:timestamp hostname ident[pid]:log message。其中ident就是我們調用openlog是指定的"testsyslog",而之是以會列印出[27214]是openlog的option參數中指定了LOG_PID。下面我們詳細讨論openlog函數中的option,facility和syslog函數中的priority參數。

根據/usr/include/sys/syslog.h檔案,我們可以看到syslog支援的option如下:

  1. /*  
  2.  * Option flags for openlog.  
  3.  *  
  4.  * LOG_ODELAY no longer does anything.  
  5.  * LOG_NDELAY is the inverse of what it used to be.  
  6.  */ 
  7. #define LOG_PID     0x01    /* log the pid with each message */  
  8. #define LOG_CONS            0x02    /* log on the console if errors in sending */  
  9. #define LOG_ODELAY  0x04    /* delay open until first syslog() (default) */  
  10. #define LOG_NDELAY  0x08    /* don't delay open */  
  11. #define LOG_NOWAIT  0x10    /* don't wait for console forks: DEPRECATED */  
  12. #define LOG_PERROR  0x20    /* log to stderr as well */  
  13. 我們可以通過與操作結合這些option。syslog支援的faclility如下:
  1. /* facility codes */ 
  2. #define LOG_KERN            (0<<3)    /* kernel messages */  
  3. #define LOG_USER            (1<<3)    /* random user-level messages */  
  4. #define LOG_MAIL            (2<<3)    /* mail system */  
  5. #define LOG_DAEMON  (3<<3)    /* system daemons */  
  6. #define LOG_AUTH            (4<<3)    /* security/authorization messages */  
  7. #define LOG_SYSLOG  (5<<3)    /* messages generated internally by syslogd */  
  8. #define LOG_LPR     (6<<3)    /* line printer subsystem */  
  9. #define LOG_NEWS            (7<<3)    /* network news subsystem */  
  10. #define LOG_UUCP            (8<<3)    /* UUCP subsystem */  
  11. #define LOG_CRON            (9<<3)    /* clock daemon */  
  12. #define LOG_AUTHPRIV    (10<<3)   /* security/authorization messages (private) */  
  13. #define LOG_FTP     (11<<3)   /* ftp daemon */  

facility的ID(上面對應的數值)與名字的對應關系如下:

  1. { "auth", LOG_AUTH },   
  2. { "authpriv", LOG_AUTHPRIV },   
  3. { "cron", LOG_CRON },   
  4. { "daemon", LOG_DAEMON },   
  5. { "ftp", LOG_FTP },   
  6. { "kern", LOG_KERN },   
  7. { "lpr", LOG_LPR },   
  8. { "mail", LOG_MAIL },   
  9. { "mark", INTERNAL_MARK },      /* INTERNAL */  
  10. { "news", LOG_NEWS },   
  11. { "security", LOG_AUTH },       /* DEPRECATED */  
  12. { "syslog", LOG_SYSLOG },   
  13. { "user", LOG_USER },   
  14. { "uucp", LOG_UUCP },  

這個對應關系作用是是将syslog系統調用中facility ID和syslog.conf檔案中的配置選項對應起來。後面将詳細講解。facility的作用是指明調用syslog應用的類型。syslog支援的priority如下:

  1. #define LOG_EMERG   0   /* system is unusable */  
  2. #define LOG_ALERT   1   /* action must be taken immediately */  
  3. #define LOG_CRIT            2   /* critical conditions */  
  4. #define LOG_ERR     3   /* error conditions */  
  5. #define LOG_WARNING 4   /* warning conditions */  
  6. #define LOG_NOTICE  5   /* normal but significant condition */  
  7. #define LOG_INFO            6   /* informational */  
  8. #define LOG_DEBUG   7   /* debug-level messages */  

priority的ID(上面對應的數值)與名字的對應關系如下:

  1. { "alert", LOG_ALERT },   
  2. { "crit", LOG_CRIT },   
  3. { "debug", LOG_DEBUG },   
  4. { "emerg", LOG_EMERG },   
  5. { "err", LOG_ERR },   
  6. { "error", LOG_ERR },       /* DEPRECATED */  
  7. { "info", LOG_INFO },   
  8. { "none", INTERNAL_NOPRI },     /* INTERNAL */  
  9. { "notice", LOG_NOTICE },   
  10. { "panic", LOG_EMERG },     /* DEPRECATED */  
  11. { "warn", LOG_WARNING },        /* DEPRECATED */  
  12. { "warning", LOG_WARNING },  

這個對應關系的作用和facility情況是相同的,都是為了與syslog.conf檔案中的配置選項對應起來。priority的作用是指明日記記錄的優先級,也可以了解成記錄時間的嚴重程度。在實際使用中,syslog函數中的priority參數實際上是前面提到的facility和priority的組合,通過與操作。

回到前面提到的syslog.conf檔案和testsyslog的程式,根據前面的分析,我們來研究一下為什麼testsyslog會将日記記錄寫到檔案/var/log/messages中,而不是别的檔案。

syslog.conf檔案行的基本文法是這樣的:

[消息類型(規則)]     [處理方案(日記檔案)]

這裡需要注意的是,兩者之間必須用一個或者多個Tab字元分開。消息類型是由”消息來源“(facility)和”緊急程度“(priority)構成,中間點号連接配接。如前面syslog.conf檔案中的news.crit表示來自news的”關鍵“狀況。這裡,news表示消息來源,crit表示關鍵狀況。通配符*表示一切消息來源,如第一條規則:*.info,将info級以上(notice,warning, err, alert, emerg)(priority表)的所有消息發送到日記檔案/var/log/messages。而testsyslog程式中,調用syslog函數時指定的priority是LOG_USER | LOG_INFO,根據上面提到的ID和名字對應的關系,對應的消息類型規則是user.info,包含在規則*.info中,是以日記記錄會寫到/var/log/messages。

修改syslog.conf檔案

一般來說,我們希望能夠為自己的應用程式指定特定的日記檔案。這時候,我們就需要修改syslog.conf檔案。假設我們現在要把調試(debug)日記記錄寫到檔案/var/log/debug檔案中。第一步要做的是,在syslog.conf檔案添加如下消息規則作為第一條規則:

  1. user.debug                  /var/log/debug  

要是添加的新規則生效,第二步我們需要重新開機syslogd和klogd:service syslog restart(ubuntu下為/etc/init.d/rsyslog restart)

為了測試新規則是否生效,我們可以将testsyslog修改如下:

  1.     syslog(LOG_USER | LOG_DEBUG, "syslog test message generated in program %s \n", argv[0]);   

編譯生成執行檔案後,每運作一次,/var/log/debug檔案都會增加一條新的記錄

繼續閱讀