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

posted @ 2018-07-14 21:05  XXX已失联  阅读(16443)  评论(2编辑  收藏  举报