glog日誌庫使用筆記

　　日誌能方便地診斷程序緣由、統計程序運行數據，是大型軟件系統必不可少的組件之一。glog 是google的開源日誌系統，相比較log4系列的日誌系統，它更加輕巧靈活。

　　在Github上下載glog，解壓後用CMake生成VS2017工程（默認生成的是靜態連接庫glogd.lib）：

　　在64位的windows系統中，一個64位進程不能加載一個32位dll，同理一個32位進程也不能加載一個64位dll，所以要注意應用程序和glog庫版本的統一。編譯成功後，在build\Debug文件夾下會生成glogd.lib庫文件。   src\windows路徑下的glog文件夾包含Windows平臺所需的頭文件：

 　　使用glog時能夠在項目「屬性→C/C++→常規→附加包含目錄」中設置glog頭文件路徑，也能夠直接將windows/glog文件夾複製到VS2017的安裝路徑中：C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC\14.14.26428\include

 　　新建一個簡單的x64的Debug工程進行測試，在「項目屬性→連接器→輸入→附加依賴項」中加入glogd.lib，並在「項目屬性→連接器→常規→附加庫目錄」中輸入glogd.lib的路徑。進行編譯：

#include <glog/logging.h>

int main(int argc, char* argv[]) {
    // Initialize Google's logging library.
    google::InitGoogleLogging(argv[0]);

    // ...
    int num_cookies = 100;
    LOG(INFO) << "Found " << num_cookies << " cookies";

    return 0;
}

　　結果出現錯誤：

1>ConsoleApplication1.obj : error LNK2019: 沒法解析的外部符號 "__declspec(dllimport) void __cdecl google::InitGoogleLogging(char const *)" (__imp_?InitGoogleLogging@google@@YAXPEBD@Z)，該符號在函數 main 中被引用
1>ConsoleApplication1.obj : error LNK2019: 沒法解析的外部符號 "__declspec(dllimport) public: __cdecl google::LogMessage::LogMessage(char const *,int)" (__imp_??0LogMessage@google@@QEAA@PEBDH@Z)，該符號在函數 main 中被引用
1>ConsoleApplication1.obj : error LNK2019: 沒法解析的外部符號 "__declspec(dllimport) public: __cdecl google::LogMessage::~LogMessage(void)" (__imp_??1LogMessage@google@@QEAA@XZ)，該符號在函數 main 中被引用
1>ConsoleApplication1.obj : error LNK2019: 沒法解析的外部符號 "__declspec(dllimport) public: class std::basic_ostream<char,struct std::char_traits<char> > & __cdecl google::LogMessage::stream(void)" (__imp_?stream@LogMessage@google@@QEAAAEAV?$basic_ostream@DU?$char_traits@D@std@@@std@@XZ)，該符號在函數 main 中被引用
1>C:\Users\Thinkpad\Desktop\ConsoleApplication1\x64\Debug\ConsoleApplication1.exe : fatal error LNK1120: 4 個沒法解析的外部命令

 　　參考其餘文檔，在預處理器定義中添加GOOGLE_GLOG_DLL_DECL=宏後解決：

　　運行程序發現並無信息輸出到控制檯中，若是沒有設置日誌存放的文件夾，它們會被存放到指定的路徑(windows平臺上會默認存放到$(LOCALAPPDATA)的Temp文件夾下。如C:\Users\Thinkpad\AppData\Local\Temp，路徑中的「Thinkpad」是計算機當前的用戶名)，你能夠找到以特定格式命名的文件，格式爲:

/tmp/<program name>.<hostname>.<user name>.log.<severity level>.<date>.<time>.<pid>

　　生成的log文件以下圖所示：

  

　　打開文件能夠看到以下信息：

Log file created at: 2018/07/14 16:37:30
Running on machine: ROBO
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
I0714 16:37:30.196939 15848 consoleapplication1.cpp:14] Found 100 cookies

　　上面介紹了日誌輸出的格式和咱們輸出的日誌信息。glog擁有的4個日誌等級：INFO，WARNING，ERROR，FATAL分別對應0，1，2，3。數值越大嚴重性越高，嚴重性高的日誌不但會保存到本身的日誌文件中，還會同時保存到全部比它嚴重性更低的日誌文件中。例如ERROR信息會被同時打印到INFO，WARNING，ERROR日誌文件中。添加以下測試代碼：

　　LOG(INFO) << "google log first info level message!";
　　LOG(WARNING) << "google log first warning level message!";
　　LOG(ERROR) << "google log first error level message!";

　　運行程序生成了三種日誌文件：

// INFO
Log file created at: 2018/07/14 16:46:28
Running on machine: ROBO
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
I0714 16:46:28.779220  9736 consoleapplication1.cpp:14] google log first info level message!
W0714 16:46:28.780218  9736 consoleapplication1.cpp:15] google log first warning level message!
E0714 16:46:28.780218  9736 consoleapplication1.cpp:16] google log first error level message!

// WARNING
Log file created at: 2018/07/14 16:46:28
Running on machine: ROBO
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
W0714 16:46:28.780218  9736 consoleapplication1.cpp:15] google log first warning level message!
E0714 16:46:28.780218  9736 consoleapplication1.cpp:16] google log first error level message!

// ERROR
Log file created at: 2018/07/14 16:46:28
Running on machine: ROBO
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
E0714 16:46:28.780218  9736 consoleapplication1.cpp:16] google log first error level message!

　　同時注意控制檯輸出了錯誤信息（默認狀況下ERROR和FATAL等級的信息會同時被輸出到stderr上）：

 

　　不一樣於log4系列的日誌系統經過配置文件的方式，glog採用命令的方式來來配置參數，還能夠直接在程序中指定。好比下面程序指定了輸出log的文件夾：

int main(int argc, char* argv[])
{
    string home = "./log/";  //要先建立此目錄,不然運行報錯.
  
    google::InitGoogleLogging(argv[0]);

    string info_log = home + "master_info_";
    google::SetLogDestination(google::INFO, info_log.c_str());

    string warning_log = home + "master_warning_";
    google::SetLogDestination(google::WARNING, warning_log.c_str());

    string error_log = home + "master_error_";
    google::SetLogDestination(google::ERROR, error_log.c_str());

    string fatal_log = home + "master_fatal_";
    google::SetLogDestination(google::FATAL, fatal_log.c_str());

    // You can specify one of the following severity levels (in increasing order of severity)
    LOG(INFO) << "info";
    LOG(WARNING) << "warning";
    LOG(ERROR) << "error";
    LOG(FATAL) << "fatal";   // Logging a FATAL message terminates the program (after the message is logged)!

    return 0;
}

　　在Project目錄下（若是直接運行程序則在程序所在路徑下）建立log文件夾，運行程序生成的日誌會輸出到該文件夾中：

　　注意，打印FATAL消息會在打印完成後終止程序：

 

　　glog提供了一些調試模式時輸出，release模式下不輸出的宏，如DLOG，DLOG_IF，DLOG_EVERY_N等。這些宏只有在debug模式下才會輸出日誌，正常模式下不會輸出日誌，也不會拖慢應用程序的速度。

　　// 若是工程爲Debug模式,下面信息會輸出,若是是release模式,下面信息不會輸出.
    DLOG(INFO) << "DLOG:Debug Mode Message!";

 　　

　　若是要自定義輸出log文件的格式，可修改源代碼logging.cc文件中相關的函數。

 

 

 

參考：

glog簡介

glog 入門教程

glog使用教程

Glog使用文檔

glog使用與功能修改

Google-glog 日誌庫使用手記

在Windows上編譯、應用glog

Installing GLog on Windows

How To Use Google Logging Library (glog)

google/glog: C++ implementation of the Google logging module