亚洲免费在线-亚洲免费在线播放-亚洲免费在线观看-亚洲免费在线观看视频-亚洲免费在线看-亚洲免费在线视频

便利的開發工具-log4cpp快速使用指南

系統 1928 0

簡介: log4cpp是個基于LGPL的開源項目,是基于優秀的日志處理跟蹤項目Java語言的log4j移植過來的。log4j介紹的文檔很多,在java領域使用的也比較廣泛,而這個功能強大的庫對國內的C++語言開發人員卻使用的不多。這里從開發人員使用的角度介紹這個庫,使開發人員用最少的代價盡快掌握這種技術。下面先簡單介紹一下這個項目的優點(也是log4j的優點),然后分原理,手動使用步驟,配置文件驅動方式使用步驟,其他考慮等方面進行討論。以下討論基于log4cpp0.3.4b。

<!-- <p class="ibm-no-print"> <div id="dw-tag-this" class="ibm-no-print"></div> <div id="interestShow" class="ibm-no-print"></div> </p> -->

發布日期: 2003 年 9 月 01 日
級別: 初級
建議: 0( 添加評論 ) <!-- Rating_Area_Begin --><!-- Ensure that div id is based on input id and ends with -widget -->

1 star 2 stars 3 stars 4 stars 5 stars 平均分 (共 0 個評分 )
<!-- Rating_Area_End -->

<!-- dW_Summary_Area_END --><!-- CONTENT_BODY -->
<!-- MAIN_COLUMN_BEGIN -->
<!-- Related_Searches_Area_And_Overlays_Begin --><!-- MAIN_COLUMN_CONTAINER_BEGIN -->
<!-- MAIN_COLUMN_CONTENT_BEGIN -->

0. 優點

  • 提供應用程序運行上下文,方便跟蹤調試;
  • 可擴展的、多種方式記錄日志,包括命令行、文件、回卷文件、內存、syslog服務器、Win事件日志等;
  • 可以動態控制日志記錄級別,在效率和功能中進行調整;
  • 所有配置可以通過配置文件進行動態調整;
  • 多語言支持,包括Java(log4j),C++(log4cpp、log4cplus),C(log4c),python(log4p)等;

1. 原理

log4cpp有3個主要的組件:categories(類別)、appenders(附加目的地)、和 layouts(布局)。(為了方便大家理解,文中盡量使用英文原詞)

layout類控制輸出日志消息的顯示樣式(看起來像什么)。log4cpp當前提供以下layout格式:

                  log4cpp::BasicLayout 	   // 以“時間戳 優先級(priority,下文介紹)
                        // 類別(category,下文介紹)
		     // NDC標簽(nested diagnostic contexts 下文介紹): 日志信息”。
	             // 如:1056638652 INFO main : This is some info
log4cpp::PatternLayout 	// 讓用戶根據類似于 C 語言 printf 函數的轉換模式
                                        //來指定輸出格式。格式定義見代碼附帶文檔。
log4cpp::SimpleLayout 	// 以“優先級(priority) - 日志信息”格式顯示。 

                

appender類用來輸出日志(被layout格式化后的)到一些設備上。比如文件、syslog服務、某個socket等。可以定義自己的appender類輸出日志信息到別的設備上,比如應用自身的日子處理進程、數據庫等。appender和layout的關系是layout附在appender上,appender類調用layout處理完日志消息后,記錄到某個設備上。log4cpp當前提供以下appender:

                  log4cpp::IdsaAppender       
// 發送到IDS或者logger, 詳細見 http://jade.cs.uct.ac.za/idsa/
log4cpp::FileAppender       // 輸出到文件
log4cpp::RollingFileAppender   
// 輸出到回卷文件,即當文件到達某個大小后回卷
log4cpp::OstreamAppender     // 輸出到一個ostream類
log4cpp::RemoteSyslogAppender   // 輸出到遠程syslog服務器
log4cpp::StringQueueAppender   // 內存隊列
log4cpp::SyslogAppender     // 本地syslog
log4cpp::Win32DebugAppender   // 發送到缺省系統調試器
log4cpp::NTEventLogAppender   // 發送到win 事件日志

                

category 類真正完成記錄日志功能,兩個主要組成部分是appenders和priority(優先級)。優先級控制哪類日志信息可以被這個category記錄,當前優先級分為:NOTSET, DEBUG, INFO, NOTICE, WARN, ERROR, CRIT, ALERT 或 FATAL/EMERG 。每個日志信息有個優先級,每個category有個優先級,當消息的優先級大于等于category的優先級時,這個消息才會被category記錄,否則被忽略。優先級的關系如下。category類和appender的關系是,多個appender附在category上,這樣一個日志消息可以同時輸出到多個設備上。

NOTSET < DEBUG < INFO < NOTICE < WARN < ERROR < CRIT < ALERT < FATAL = EMERG

category被組織成一個樹,子category創建時優先級缺省NOTSET,category缺省會繼承父category的appender。而如果不希望這種appender的繼承關系,log4cpp允許使用additivity 標簽,為false時新的appender取代category的appender列表。

為了更好的理解上面的概念下面以手動使用方式舉例。


2. 手動使用步驟

手動使用log4cpp的基本步驟如下:

  1. 實例化一個layout 對象;
  2. 初始化一個appender 對象;
  3. 把layout對象附著在appender對象上;
  4. 調用log4cpp::Category::getInstance("name"). 實例化一個category對象;
  5. 把appender對象附到category上(根據additivity的值取代其他appender或者附加在其他appender后)。
  6. 設置category的優先級;
                  // FileName: test_log4cpp1.cpp
// Test log4cpp by manual operation.
// Announce: use as your own risk.
// Compile : g++ -otest1 -llog4cpp test_log4cpp1.cpp
// Run     : ./test1
// Tested  : RedHat 7.2 log4cpp0.3.4b
// Author  : liqun (liqun@nsfocus.com)
// Data    : 2003-6-27
#include	"log4cpp/Category.hh"
#include	"log4cpp/FileAppender.hh"
#include	"log4cpp/BasicLayout.hh"
int main(int argc, char* argv[])
{
        // 1實例化一個layout 對象
        log4cpp::Layout* layout = 
        new log4cpp::BasicLayout();
        // 2. 初始化一個appender 對象
	log4cpp::Appender* appender = new 
              log4cpp::FileAppender("FileAppender",
              "./test_log4cpp1.log");
	// 3. 把layout對象附著在appender對象上
	appender->setLayout(layout);
	// 4. 實例化一個category對象
	log4cpp::Category& warn_log = 
        log4cpp::Category::getInstance("mywarn");
	// 5. 設置additivity為false,替換已有的appender
        warn_log.setAdditivity(false);
	// 5. 把appender對象附到category上
	warn_log.setAppender(appender);
	// 6. 設置category的優先級,低于此優先級的日志不被記錄
	warn_log.setPriority(log4cpp::Priority::WARN);
	// 記錄一些日志
	warn_log.info("Program info which cannot be wirten");
	warn_log.debug("This debug message will fail to write");
	warn_log.alert("Alert info");
	// 其他記錄日志方式
	warn_log.log(log4cpp::Priority::WARN, "This will be a logged warning");
	log4cpp::Priority::PriorityLevel priority;
	bool this_is_critical = true;
	if(this_is_critical)
		priority = log4cpp::Priority::CRIT;
	else
		priority = log4cpp::Priority::DEBUG;
	warn_log.log(priority,"Importance depends on context");
	
	warn_log.critStream() << "This will show up << as " 
	<< 1 << " critical message" 
	<< log4cpp::CategoryStream::ENDLINE;
	// clean up and flush all appenders
	log4cpp::Category::shutdown();
	return 0;
}

                


3. 配置文件驅動方式使用步驟

另一個非常優秀的特征就是通過讀取配置文件,確定category、appender、layout等對象。也是我們非常推薦的使用方式,可以靈活地通過配置文件定義所有地對象及其屬性,不用重新編碼,動態更改日志記錄的策略。

Log4cpp主要提供了 log4cpp::PropertyConfigurator 和log4cpp::SimpleConfigurator兩種機制(文件格式),但 log4cpp::SimpleConfigurator將來不再支持了,而且格式非常簡單,這里就不多說明,自己看源碼吧。

配置文件的格式和log4j的配置文件一樣,是標準的java屬性文件格式。下面是附帶的例子配置文件:

                  # a simple test config
#定義了3個category sub1, sub2, sub1.sub2
log4j.rootCategory=DEBUG, rootAppender
log4j.category.sub1=,A1
log4j.category.sub2=INFO
log4j.category.sub1.sub2=ERROR, A2
# 設置sub1.sub2 的additivity屬性
log4j.additivity.sub1.sub2=false
#定義rootAppender類型和layout屬性
log4j.appender.rootAppender=org.apache.log4j.ConsoleAppender
log4j.appender.rootAppender.layout=org.apache.log4j.BasicLayout
#定義A1的屬性
log4j.appender.A1=org.apache.log4j.FileAppender
log4j.appender.A1.fileName=A1.log
log4j.appender.A1.layout=org.apache.log4j.SimpleLayout
#定義A2的屬性
log4j.appender.A2=org.apache.log4j.ConsoleAppender
log4j.appender.A2.layout=org.apache.log4j.PatternLayout
log4j.appender.A2.layout.ConversionPattern=The message '%m' at time %d%n 

                

配置文件語法如下,不是很規范,結合上面的例子,應該可以看懂。

                  log4j / log4cpp . [category / appender].[category or appender 's name].
  [category or appender 's property] 
= [Appender / Layout / property's value / Priority, appender name1 [appender name2 ...]]
  [appender]
    {ConsoleAppender}
    {FileAppender}  // 當appender的類型是FileAppender時,可以定義它下面的屬性。
      [fileName]  string  foobar  // 格式是:屬性名 值的類型 缺省值
      [append]  bool  true
    {RollingFileAppender}
      [fileName]   string  foobar
      [maxFileSize]  num  10*1024*1024
      [maxBackupIndex]  num  1
      [append]  bool  true
    {SyslogAppender}
      [syslogName]  string  syslog
      [syslogHost]  string  localhost
      [facility]  num  -1  // * 8 to get LOG_KERN, etc. compatible values. 
      [portNumber]  num  -1
    {IdsaAppender}
      [idsaName]  string  foobar
    {Win32DebugAppender}
    {NTEventLogAppender}
      [source]  string  foobar
      
      [threshold]  string ""  // 全部 
      // 如果此類型appender需要layout,必須定義此appender的下面屬性
      [layout]
        {BasicLayout}  
        {SimpleLayout}
        {PatternLayout}    
        // 當layout的值是BasicLayout時,需要定義下面的屬性。
          [ConversionPattern]
          
  [rootCategory]
  [additivity]
    [category name]  bool  true

		
                

基本使用步驟是:

  1. 讀取解析配置文件;
  2. 實例化category對象;
  3. 正常使用這些category對象進行日志處理;

下面是個簡單的使用代碼,使用起來是非常方便的:

                  // FileName: test_log4cpp2.cpp
// Test log4cpp by config file.
// Announce: use as your own risk.
// Compile : g++ -llog4cpp test_log4cpp2.cpp
// Run     : ./a.out
// Tested  : RedHat 7.2 log4cpp0.3.4b
// Author  : liqun (liqun@nsfocus.com)
// Data    : 2003-6-27
#include "log4cpp/Category.hh"
#include "log4cpp/PropertyConfigurator.hh"
int main(int argc, char* argv[])
{
	// 1 讀取解析配置文件
	// 讀取出錯, 完全可以忽略,可以定義一個缺省策略或者使用系統缺省策略
	// BasicLayout輸出所有優先級日志到ConsoleAppender
    try { 
		log4cpp::PropertyConfigurator::configure("./log4cpp.conf");
	} catch(log4cpp::ConfigureFailure& f) {
		std::cout << "Configure Problem " << f.what() << std::endl;
        return -1;
    }
	
	// 2 實例化category對象
	// 這些對象即使配置文件沒有定義也可以使用,不過其屬性繼承其父category
	// 通常使用引用可能不太方便,可以使用指針,以后做指針使用
	// log4cpp::Category* root = &log4cpp::Category::getRoot();
    log4cpp::Category& root = log4cpp::Category::getRoot();
	
    log4cpp::Category& sub1 = 
        log4cpp::Category::getInstance(std::string("sub1"));
    log4cpp::Category& sub3 = 
        log4cpp::Category::getInstance(std::string("sub1.sub2"));
	// 3 正常使用這些category對象進行日志處理。
	// sub1 has appender A1 and rootappender.
	sub1.info("This is some info");
	sub1.alert("A warning");
	
	// sub3 only have A2 appender.
	sub3.debug("This debug message will fail to write");
	sub3.alert("All hands abandon ship");
	sub3.critStream() << "This will show up << as " << 1 << " critical message" 
	<< log4cpp::CategoryStream::ENDLINE;
	sub3 << log4cpp::Priority::ERROR 
              << "And this will be an error"  
              << log4cpp::CategoryStream::ENDLINE;
	sub3.log(log4cpp::Priority::WARN, "This will be a logged warning");
	
	return 0;
}

                


4. 相關考慮

性能問題,可能是很多想使用log4cpp的程序員關心的問題。在參考資料2中有一段描述。結論就是log4j以及log4cpp是以性能為首要目標的;如果關閉日志記錄的話,對性能影響可以忽略;打開日志記錄,主要消耗是在記錄動作,而不是庫的管理過程;所以你盡可放心的使用。實在要深究性能的話。可以從下面方面提高:

輸出的日志消息不要使用復雜的轉換或者處理,比如: sub1.debug(string("Current num is") + i + GetCurStat()); 這種情況即使不進行日志處理,括號中的語句還是會執行。變通方法是:

                  if(sub1.isDebugEnabled())
{
	sub1.debug(string("Current num is") + i + GetCurStat());
}

                

安全性問題對于商業軟件開發可能也是問題。可能不希望別人通過修改配置文件獲取程序的調試等程序內部運行情況的日志信息。比較穩妥的方案或者是加密配置文件,運行中解密,輸出到臨時文件后讀取;或者在發行版本里讀取配置文件后,強行把低于某個優先級的category設到比較高的優先級。

多線程安全性問題。當前log4cpp還沒有宣稱自己是多線程安全的,不過其代碼中大多數可能沖突的地方都增加了線程互斥控制,對多線程環境應該問題不大。但為了加入這個特性,linux下編譯log4cpp時,configure請加入--with-pthreads 或者--with-omnithreads選項。Win版本已經加入對MS線程的支持。

<!-- CMA ID: 49603 --><!-- Site ID: 10 --><!-- XSLT stylesheet used to transform this file: dw-article-6.0-beta.xsl -->

參考資料

便利的開發工具-log4cpp快速使用指南


更多文章、技術交流、商務合作、聯系博主

微信掃碼或搜索:z360901061

微信掃一掃加我為好友

QQ號聯系: 360901061

您的支持是博主寫作最大的動力,如果您喜歡我的文章,感覺我的文章對您有幫助,請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧,狠狠點擊下面給點支持吧,站長非常感激您!手機微信長按不能支付解決辦法:請將微信支付二維碼保存到相冊,切換到微信,然后點擊微信右上角掃一掃功能,選擇支付二維碼完成支付。

【本文對您有幫助就好】

您的支持是博主寫作最大的動力,如果您喜歡我的文章,感覺我的文章對您有幫助,請用微信掃描上面二維碼支持博主2元、5元、10元、自定義金額等您想捐的金額吧,站長會非常 感謝您的哦!!!

發表我的評論
最新評論 總共0條評論
主站蜘蛛池模板: 天天干夜夜操美女 | 久久精品伊人 | 2019国产精品视频 | 国产欧美精品一区二区 | 在线观看91精品国产不卡免费 | 中文一区在线 | 亚洲天堂久久 | 色中文字幕 | 99热精品久久只有精品30 | 久热这里只精品99国产6_99 | 国产伦码精品一区二区 | 国产精品第一页爽爽影院 | 全黄冷激性性视频 | 国产麻豆精品高清在线播放 | 日本aaaa级 | 亚洲aa在线 | 咪咪爱在线视频 | 久久国产免费观看精品3 | 久久精品国产精品2020 | 色综合久久天天综合绕观看 | 亚洲www色| 国产成人精品曰本亚洲77美色 | 五月婷婷激情网 | 青青99| 一级特级aaa毛片 | 日本狠狠干 | 国产臀控福利视频在线 | 一区二区3区免费视频 | 免费一级毛片在线播放欧美 | 夜夜夜夜夜夜夜猛噜噜噜噜噜噜 | 国产一国产一级毛片视频 | 四虎在线精品 | 欧美色黄视频 | 黄色在线视频观看 | 欧美日本综合一区二区三区 | 国产精品欧美亚洲韩国日本不卡 | 亚洲永久视频 | 精品福利一区二区三区免费视频 | 一区二区三区日韩 | 天天操夜夜欢 | 国产成人99精品免费视频麻豆 |