C++日志操作开源函数库之Google-glog

　　今天想给我的C++项目找一个开源的日志类，用于记录系统日志，结果浪费了半个下午的时间。从网上搜索相关资料，找到以下几个备选方案：

1、log4cplus　　下载地址：http://sourceforge.net/projects/log4cplus/files/log4cplus-stable/1.1.0

2、log4cxx　　下载地址：http://logging.apache.org/log4cxx/download.html　　（log4cxx 是由JAVA实现的 log4j 开源的，用C++实现的一个开源库）

3、glog　　下载地址：http://code.google.com/p/google-glog/downloads/list

4、log4cpp　　下载地址： http://sourceforge.net/projects/log4cpp/files

　　我初步看了一下，第1个和第4个是sourceforge网站上的开源项目，不知道是不是被屏蔽了，总之是打不开网页。浪费我半小时找代理和FQ，均找不到。看到第2个是Java注明的日志类log4j的姊妹C++版，顿时感觉应该不错，结果编译的过程让我直接疯掉了。先是下载log4cxx源代码，又说光下载这个还不够，还要下载另外两个Apache项目（apr、apr-util）代码，下完这三个还不行，在Windows下编译还需要下一个Windows X64版本的Sed，好吧，这还不算数，居然还是链接失败，网上还找不到相应的解决方案，整个过程浪费我4个小时。

　　所以今天的教训就是，人家的开源项目根本就不待见Windows平台，或者说根本不待见我这样的菜鸟。既然我是Windows平台上的一只小菜鸟，那我就老老实实用简单的东西吧。从第三方网站上下载Google glog，编译一下居然轻松通过，很好！

一、基本用法测试

　　1、从网上下载google-glog-v0.3.4-50-gde75983.zip，解压到本地，可以看到工程文件google-glog.sln，可以用Visual Studio 2008打开。

　　2、直接编译就可以得到libglog.dll、libglog.lib等文件，这里的lib文件在编译时要用，而dll文件则是运行时要用的，可以看出这里的glog采用的是“隐式”动态链接库编译方法。

　　3、将解压出来的文件夹路径：“google-glog\src\windows”添加到Visual Studio 2008 的工程路径中，以便于引用头文件。同时将上一步编译出来的lib文件加入路径或者直接拷贝到自定义工程路径中；

　　4、使用如下代码可以测试使用：

 1 #include <iostream>
 2 using namespace std;
 3 
 4 #include <glog/logging.h>
 5 #pragma comment(lib, "libglog.lib")
 6 
 7 int main(int argc, char **argv)
 8 {
 9     google::InitGoogleLogging("KLH");
10     google::SetLogDestination(google::INFO, "F://");
11 
12     char str[20] = "hello log!";    
13     LOG(INFO) << "Found " << google::COUNTER <<endl;    
14     LOG(INFO) << str ;                // << " cookies";    
15     LOG(WARNING) << "warning test";    // 会输出一个Warning日志    
16     LOG(ERROR) << "error test";        // 会输出一个Error日志 
17 
18     system("pause");
19     return 0;
20 }

　　5、编译生成的exe文件还不能直接运行，需要将第3步编译的dll文件拷贝到相同目录中才能运行。测试的日志文件自动生成在F:/根目录中。类似于如下格式内容：

1 Log file created at: 2015/12/14 20:28:18
2 Running on machine: VICTO-PC
3 Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
4 I1214 20:28:18.590252  9648 main2.cpp:13] Found 0
5 I1214 20:28:18.591253  9648 main2.cpp:14] hello log!
6 W1214 20:28:18.591253  9648 main2.cpp:15] warning test
7 E1214 20:28:18.592252  9648 main2.cpp:16] error test　

　　6、其实这里可以看出，用动态链接库编译的方式有个麻烦的地方就是编译出来的exe不能单独运行，必须拷贝dll文件放到一起才行。如何采用静态链接的方式呢？答案是要看官方doc文档的说法：在自定义工程中添加“GOOGLE_GLOG_DLL_DECL=” 和 “GLOG_NO_ABBREVIATED_SEVERITIES” 这两个宏，第二个宏主要是为了避免与windows.h冲突（下面会讲到），第一个宏才是使用静态链接库时必须的！在编译时可以编译两个版本：Release 和 Debug 以供调试时使用。

　　7、在使用过程中一定要注意编译参数 “/MT” 和 “/MD” 的区别，当然还有 “/MTd” 和 “/MDd” 的不同，可以免去复杂的链接错误、冲定义等问题，在下一篇日志中会专门讲到，如果不清楚这个问题将会是很费劲的，包括之前写过一篇libevent入门的文章说在使用时要忽略一大堆的系统函数库，我觉得也是这个原因导致的。

 

二、Windows平台应用

　　当我在Windows平台项目上应用这个glog时遇到了一个问题，那就是直接编译上面的代码时会出现错误：

错误    2    fatal error C1189: #error :  ERROR macro is defined. Define GLOG_NO_ABBREVIATED_SEVERITIES before including logging.h. See the document for detail.    d:\cppworkspace\opensourcelibrary\google-glog\src\windows\glog\log_severity.h    55

　　双击这个错误很容易定位到出错的地方：

1 const int GLOG_INFO = 0, GLOG_WARNING = 1, GLOG_ERROR = 2, GLOG_FATAL = 3,
2   NUM_SEVERITIES = 4;
3 #ifndef GLOG_NO_ABBREVIATED_SEVERITIES
4 # ifdef ERROR
5 #  error ERROR macro is defined. Define GLOG_NO_ABBREVIATED_SEVERITIES before including logging.h. See the document for detail.
6 # endif
7 const int INFO = GLOG_INFO, WARNING = GLOG_WARNING,
8   ERROR = GLOG_ERROR, FATAL = GLOG_FATAL;
9 #endif

　　其实解决这个错误倒是不难，可以看到只要是在Windows工程中预定义GLOG_NO_ABBREVIATED_SEVERITIES这个宏就可以了，但是为什么要这么做呢？找了一下，答案在官方文档中：

Notes for Windows users
Google glog defines a severity level ERROR, which is also defined in windows.h . You can make glog not define INFO, WARNING, ERROR, and FATAL by defining GLOG_NO_ABBREVIATED_SEVERITIES before including glog/logging.h . Even with this macro, you can still use the iostream like logging facilities:
  #define GLOG_NO_ABBREVIATED_SEVERITIES
  #include <windows.h>
  #include <glog/logging.h>
  // ...
  LOG(ERROR) << "This should work";
  LOG_IF(ERROR, x > y) << "This should be also OK";
However, you cannot use INFO, WARNING, ERROR, and FATAL anymore for functions defined in glog/logging.h .
  #define GLOG_NO_ABBREVIATED_SEVERITIES
  #include <windows.h>
  #include <glog/logging.h>
  // ...
  // This won't work.
  // google::FlushLogFiles(google::ERROR);

  // Use this instead.
 google::FlushLogFiles(google::GLOG_ERROR);
If you don't need ERROR defined by windows.h, there are a couple of more workarounds which sometimes don't work:
#define WIN32_LEAN_AND_MEAN or NOGDI before you #include windows.h .
#undef ERROR after you #include windows.h .
See this issue for more detail.

 　　这下就清楚了，原来是glog中原来定义的ERROR宏与windows.h中的ERROR冲突了，为了避免冲突，glog作出了改变，增加了GLOG_NO_ABBREVIATED_SEVERITIES宏定义用以区分，那么在代码中用google::GLOG_ERROR来代替原来的google::ERROR

三、自定义glog日志格式

　　要自定义glog输出格式并不难，可以直接修改logging.cc文件中的LogMessage::Init函数，直接给出修改的位置：

 1 void LogMessage::Init(const char* file,
 2                       int line,
 3                       LogSeverity severity,
 4                       void (LogMessage::*send_method)()) {
 5 ... ...
 6   if (FLAGS_log_prefix && (line != kNoLogPrefix)) {
 7       /*
 8     stream() << LogSeverityNames[severity][0]
 9              << setw(2) << 1+data_->tm_time_.tm_mon
10              << setw(2) << data_->tm_time_.tm_mday
11              << ' '
12              << setw(2) << data_->tm_time_.tm_hour  << ':'
13              << setw(2) << data_->tm_time_.tm_min   << ':'
14              << setw(2) << data_->tm_time_.tm_sec   << "."
15              << setw(6) << usecs
16              << ' '
17              << setfill(' ') << setw(5)
18              << static_cast<unsigned int>(GetTID()) << setfill('0')
19              << ' '
20              << data_->basename_ << ':' << data_->line_ << "] ";
21              */
22       // Change output format. By KuLiuheng.    2015.12.15
23       stream()    << LogSeverityNames[severity][0]
24                 << ' '
25                 << setw(4) << 1900+data_->tm_time_.tm_year    << '-'
26                 << setw(2) << 1+data_->tm_time_.tm_mon    << '-'
27                 << setw(2) << data_->tm_time_.tm_mday
28                 << ' '
29                 << setw(2) << data_->tm_time_.tm_hour  << ':'
30                 << setw(2) << data_->tm_time_.tm_min   << ':'
31                 << setw(2) << data_->tm_time_.tm_sec   << "."
32                 << setw(6) << usecs
33                 << ' '
34                 << setfill(' ') << setw(5)
35                 << static_cast<unsigned int>(GetTID()) << setfill('0')
36                 << ' '
37                 << data_->basename_ << ':' << data_->line_ << "] ";
38   }
39 ... ...
40 }

 　　这样一来输出的格式就是：

Log file created at: 2015/12/15 14:31:05
Running on machine: VICTO-PC
Log line format: [IWEF] yyyy-mm-dd hh:mm:ss.uuuuuu threadid file:line] msg
I 2015-12-15 14:31:05.341013  2928 main2.cpp:14] Found 0
I 2015-12-15 14:31:05.343014  2928 main2.cpp:15] hello log!
W 2015-12-15 14:31:05.343014  2928 main2.cpp:16] warning test
E 2015-12-15 14:31:05.344014  2928 main2.cpp:17] error test

四、使用glog严重错误DUMP功能

　　使用google::InstallFailureSignalHandler(); 和 google::InstallFailureWriter(&FatalMessageDump); 可以在程序出现严重错误时将详细的错误信息打印出来，但是使用默认编译的glog将会出现找不到此函数定义的问题，类似于：

error LNK2019: 无法解析的外部符号 "__declspec(dllimport) void __cdecl google::InstallFailureWriter(void (__cdecl*)(char const *,int))" (__imp_?InstallFailureWriter@google@@YAXP6AXPBDH@Z@Z)，该符号在函数 "public: void __thiscall EnvironmentManager::Initialize(int,char * *,int)" (?Initialize@EnvironmentManager@@QAEXHPAPADH@Z) 中被引用
error LNK2019: 无法解析的外部符号 "__declspec(dllimport) void __cdecl google::InstallFailureSignalHandler(void)" (__imp_?InstallFailureSignalHandler@google@@YAXXZ)，该符号在函数 "public: void __thiscall EnvironmentManager::Initialize(int,char * *,int)" (?Initialize@EnvironmentManager@@QAEXHPAPADH@Z) 中被引用

　　这个时候只需要在默认的glog工程中，将signalhandler.cc 纳入到libglog工程中，重新编译即可。重新初始化glog的方法如下：

 1 // Start google log system:
 2 google::InitGoogleLogging(argv[0]);
 3 google::SetLogDestination(google::GLOG_INFO, ".//");
 4 google::SetStderrLogging(google::GLOG_INFO);
 5 google::SetLogFilenameExtension("log_");
 6 google::InstallFailureSignalHandler();
 7 google::InstallFailureWriter(&FatalMessageDump);
 8 FLAGS_colorlogtostderr = true;        // Set log color
 9 FLAGS_logbufsecs = 0;                // Set log output speed(s)
10 FLAGS_max_log_size = 1024;            // Set max log file size(GB)
11 FLAGS_stop_logging_if_full_disk = true;    // If disk is full