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.  

  5. # Log anything (except mail) of level info or higher. 

  6. # Don't log private authentication messages! 

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

  8.  

  9. # The authpriv file has restricted access. 

  10. authpriv.*                                              /var/log/secure   

  11.  

  12. # Log all the mail messages in one place. 

  13. mail.*                                                  -/var/log/maillog   

  14.  

  15.  

  16. # Log cron stuff 

  17. cron.*                                                  /var/log/cron   

  18.  

  19. # Everybody gets emergency messages 

  20. *.emerg                                                 *   

  21.  

  22. # Save news errors of level crit and higher in a special file. 

  23. uucp,news.crit                                          /var/log/spooler   

  24.  

  25. # Save boot messages also to boot.log 

  26. local7.*                                                /var/log/boot.log   

 

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

syslog APIs

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

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

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

 

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

  1. #include <syslog.h> 

  2.  

  3. int main(int argc, char *argv[])    

  4. {    

  5.     openlog("testsyslog", LOG_CONS | LOG_PID, 0);    

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

  7.     closelog();    

  8. return 0;    

  9. }   

 

編譯生成可執行文件後,每運行一次,程序將往/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. #include <syslog.h> 

    2.  

    3. int main(int argc, char *argv[])    

    4. {    

    5.     openlog("testsyslog", LOG_CONS | LOG_PID, 0);    

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

    7.     closelog();    

    8. return 0;    

    9. }   

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

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章