C++学习之道：glog

你的名字 2021-09-10 09:32 696阅读 0赞

**一、安装配置**

**1、简介**

google 出的一个C++轻量级日志库，支持以下功能：

![复制代码][copycode.gif]

◆ 参数设置，以命令行参数的方式设置标志参数来控制日志记录行为；
    ◆ 严重性分级，根据日志严重性分级记录日志；
    ◆ 可有条件地记录日志信息；
    ◆ 条件中止程序。丰富的条件判定宏，可预设程序终止条件；
    ◆ 异常信号处理。程序异常情况，可自定义异常处理过程；
    ◆ 支持debug功能；
    ◆ 自定义日志信息；
    ◆ 线程安全日志记录方式；
    ◆ 系统级日志记录；
    ◆ google perror风格日志信息；
    ◆ 精简日志字符串信息

![复制代码][copycode.gif]

**2、安装**

下载地址：[https://code.google.com/p/google-glog/downloads/list][https_code.google.com_p_google-glog_downloads_list]

解压安装：

tar zxvf glog-0.3.3.tar.gz && cd glog-0.3.3 && ./configure && make

头文件目录为 /src/glog ，链接库为 .libs/libglog.\{a,so\}

帮助文档为 doc/glog.html 或直接访问以下 URL: [http://google-glog.googlecode.com/svn/trunk/doc/glog.html][http_google-glog.googlecode.com_svn_trunk_doc_glog.html]

**3、简单 Demo **

#include <glog/logging.h>
    
    int main(int argc,char* argv[]) { LOG(INFO) << "Hello,GLOG!"; }

链接时，需要 \-lglog ，也可能会需要 \-lunwind -lpthread （有一次遇到的，记不起来了，一般不需要）

执行时，可使用 ./glogdemo  将日志输出到 stderr，可使用 valgrind 检测，未发现内存泄漏。

**二、使用方法**

**1、错误级别**

GLOG 有四个错误级别，枚举如下：

![复制代码][copycode.gif]

enum SeverityLevel
    {
    　　google::INFO = 0,
    　　google::WARNING = 1,
    　　google::ERROR = 2,
    　　google::FATAL = 3,
    };

![复制代码][copycode.gif]

**2、Flags 设置：**

在上面的简单 Demo 中，只能将日志输出到 stderr ，如果想将日志重定向到文件，需要：

google::InitGoogleLogging(argv[0]); /* GLOG代码 */ google::ShutdownGoogleLogging();

则默认运行会将日志输出到 /tmp 目录下（格式为 "<program name>.<hostname>.<user name>.log.<severity level>.<date>.<time>.<pid>"），也可以使用设置临时环境变量的方式（给命令行参数加上 GLOG\_ 前缀），如 GLOG\_logtostderr=1 ./your\_application 将日志输出到 stderr。

另外，glog 使用了 gflags 库，如果已经安装好了 gflags 库（./configure && make && make install 然后再配置编译GLOG库）还可以通过 ./your\_application --logtostderr=1 来指定运行参数，但需要在使用时加上如下代码：（详见 [ http://www.cnblogs.com/tianyajuanke/p/3467572.html][http_www.cnblogs.com_tianyajuanke_p_3467572.html]）

google::ParseCommandLineFlags(&argc, &argv, true); /* GLOG代码 */ google::ShutDownCommandLineFlags();

但此方法会使 valgrind 检测有内存泄漏（截止 valgrind 3.9.0 依然如此），这是由于使用 gflags 库造成的。（即使不使用此方法，但只要在编译 glog 库之前安装好了 gflags 库，就会使 libglog.so 有内存泄漏，介意者可进入 gflags 目录 make uninstall 之后，再对 glog 进行 ./configure && make ）。

常用的运行参数如下：

![复制代码][copycode.gif]

logtostderr (bool, default=false)    //是否将所有日志输出到 stderr，而非文件
    alsologtostderr(bool,default=false)　　//是否同时将日志输出到文件和stderr
    minloglevel (int, default=google::INFO)　　//限制输出到 stderr 的部分信息，包括此错误级别和更高错误级别的日志信息 
    stderrthreshold (int, default=google::ERROR)　　//除了将日志输出到文件之外，还将此错误级别和更高错误级别的日志同时输出到 stderr，这个只能使用 -stderrthreshold=1 或代码中设置，而不能使用环境变量的形式。（这个参数可以替代上面两个参数）
    colorlogtostderr(bool, default=false)　　//将输出到 stderr 上的错误日志显示相应的颜色 
    v (int, default=0)　　//只记录此错误级别和更高错误级别的 VLOG 日志信息
    log_dir (string, default="")　　//设置日志文件输出目录 
    v (int, default=0)　　//只有当自定义日志（VLOG）级别值小于此值时，才进行输出，默认为0(注：自定义日志的优先级与GLOG内置日志优级相反，值越小优先级越高！！！)。
    vmodule (string, default="")　　//分文件（不包括文件名后缀，支持通配符）设置自定义日志的可输出级别，如：GLOG_vmodule=server=2,client=3 表示文件名为server.* 的只输出小于 2 的日志，文件名为 client.* 的只输出小于 3 的日志。如果同时使用 GLOG_v 选项，将覆盖 GLOG_v 选项。

![复制代码][copycode.gif]

更多运行参数见 logging.cc 中的 DEFINE\_ 开头的定义。

运行参数设置的第三种方法是，可以在代码里通过加上  FLAGS\_ 前缀来设置，如：

FLAGS_stderrthreshold=google::INFO; FLAGS_colorlogtostderr=true;

**3、条件输出：**

LOG_IF(INFO, num_cookies > 10) << "Got lots of cookies"; 　　//当条件满足时输出日志
    LOG_EVERY_N(INFO, 10) << "Got the " << google::COUNTER << "th cookie";　　//google::COUNTER 记录该语句被执行次数，从1开始，在第一次运行输出日志之后，每隔 10 次再输出一次日志信息
    LOG_IF_EVERY_N(INFO, (size > 1024), 10) << "Got the " << google::COUNTER << "th big cookie";　　//上述两者的结合，不过要注意，是先每隔 10 次去判断条件是否满足，如果滞则输出日志；而不是当满足某条件的情况下，每隔 10 次输出一次日志信息。
    LOG_FIRST_N(INFO, 20) << "Got the " << google::COUNTER << "th cookie";　　//当此语句执行的前 20 次都输出日志，然后不再输出

演示代码如下：

![复制代码][copycode.gif]

#include <glog/logging.h>
    
    int main(int argc,char* argv[]) { google::InitGoogleLogging(argv[0]); FLAGS_stderrthreshold=google::INFO; FLAGS_colorlogtostderr=true; for(int i = 1; i <= 100;i++) { LOG_IF(INFO,i==100)<<"LOG_IF(INFO,i==100) google::COUNTER="<<google::COUNTER<<" i="<<i; LOG_EVERY_N(INFO,10)<<"LOG_EVERY_N(INFO,10) google::COUNTER="<<google::COUNTER<<" i="<<i; LOG_IF_EVERY_N(WARNING,(i>50),10)<<"LOG_IF_EVERY_N(INFO,(i>50),10) google::COUNTER="<<google::COUNTER<<" i="<<i; LOG_FIRST_N(ERROR,5)<<"LOG_FIRST_N(INFO,5) google::COUNTER="<<google::COUNTER<<" i="<<i; } google::ShutdownGoogleLogging(); }

![复制代码][copycode.gif]

输出结果如下：

![复制代码][copycode.gif]

I1210 13:23:20.059790  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=1  i=1 E1210 13:23:20.060670  6322 test01.cpp:13] LOG_FIRST_N(INFO,5)  google::COUNTER=1  i=1 E1210 13:23:20.061272  6322 test01.cpp:13] LOG_FIRST_N(INFO,5)  google::COUNTER=2  i=2 E1210 13:23:20.061337  6322 test01.cpp:13] LOG_FIRST_N(INFO,5)  google::COUNTER=3  i=3 E1210 13:23:20.061393  6322 test01.cpp:13] LOG_FIRST_N(INFO,5)  google::COUNTER=4  i=4 E1210 13:23:20.061450  6322 test01.cpp:13] LOG_FIRST_N(INFO,5)  google::COUNTER=5  i=5 I1210 13:23:20.061506  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=11  i=11 I1210 13:23:20.061529  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=21  i=21 I1210 13:23:20.061553  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=31  i=31 I1210 13:23:20.061575  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=41  i=41 I1210 13:23:20.061599  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=51  i=51 W1210 13:23:20.061621  6322 test01.cpp:12] LOG_IF_EVERY_N(INFO,(i>50),10)  google::COUNTER=51  i=51 I1210 13:23:20.061667  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=61  i=61 W1210 13:23:20.061691  6322 test01.cpp:12] LOG_IF_EVERY_N(INFO,(i>50),10)  google::COUNTER=61  i=61 I1210 13:23:20.061738  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=71  i=71 W1210 13:23:20.061761  6322 test01.cpp:12] LOG_IF_EVERY_N(INFO,(i>50),10)  google::COUNTER=71  i=71 I1210 13:23:20.061807  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=81  i=81 W1210 13:23:20.061831  6322 test01.cpp:12] LOG_IF_EVERY_N(INFO,(i>50),10)  google::COUNTER=81  i=81 I1210 13:23:20.061877  6322 test01.cpp:11] LOG_EVERY_N(INFO,10)  google::COUNTER=91  i=91 W1210 13:23:20.061902  6322 test01.cpp:12] LOG_IF_EVERY_N(INFO,(i>50),10)  google::COUNTER=91  i=91 I1210 13:23:20.062140  6322 test01.cpp:10] LOG_IF(INFO,i==100)  google::COUNTER=0  i=100

![复制代码][copycode.gif]

**4、日志类型**

![复制代码][copycode.gif]

LOG    //内置日志
    VLOG    //自定义日志
    DLOG    //DEBUG模式可输出的日志
    DVLOG    //DEBUG模式可输出的自定义日志
    SYSLOG    //系统日志，同时通过 syslog() 函数写入到 /var/log/message 文件
    PLOG    //perror风格日志，设置errno状态并输出到日志中
    RAW_LOG        //线程安全的日志，需要#include <glog/raw_logging.h>

![复制代码][copycode.gif]

前六种的日志使用方法完全相同（包括条件日志输出），而 RAW\_LOG 使用方法比较特殊，且不支持条件日志输出，另外不接受  colorlogtostderr 的颜色设置。自定义日志也不接受 colorlogtostderr 的颜色设置，另外其日志严重级别也为自定义数字，且与默认日志严重级别相反，数字越小严重级别越高。如：

![复制代码][copycode.gif]

1 #include <glog/logging.h>
     2 #include <glog/raw_logging.h>
     3 
     4 class GLogHelper 5 { 6 public: 7     GLogHelper(char* program) 8 { 9 google::InitGoogleLogging(program); 10         FLAGS_stderrthreshold=google::INFO; 11         FLAGS_colorlogtostderr=true; 12         FLAGS_v = 3; 13 } 14     ~GLogHelper() 15 { 16 google::ShutdownGoogleLogging(); 17 } 18 }; 19 
    20 int main(int argc,char* argv[]) 21 { 22     GLogHelper gh(argv[0]); 23     LOG(ERROR)<<"LOG"; 24     VLOG(3)<<"VLOG"; 25     DLOG(ERROR)<<"DLOG"; 26     DVLOG(3)<<"DVLOG"; 27     SYSLOG(ERROR)<<"SYSLOG"; 28     PLOG(ERROR)<<"PLOG"; 29     RAW_LOG(ERROR,"RAW_LOG"); 30 }

![复制代码][copycode.gif]

输出结果如下：

![复制代码][copycode.gif]

E1211 03:04:22.718116 13083 test01.cpp:23] LOG
    I1211 03:04:22.719225 13083 test01.cpp:24] VLOG
    E1211 03:04:22.719297 13083 test01.cpp:25] DLOG
    I1211 03:04:22.719365 13083 test01.cpp:26] DVLOG
    E1211 03:04:22.719391 13083 test01.cpp:27] SYSLOG E1211 03:04:22.719650 13083 test01.cpp:28] PLOG: Success [0]
    E1211 03:04:22.719650 13083 test01.cpp:29] RAW: RAW_LOG

![复制代码][copycode.gif]

**5、CHECK 宏**

当通过该宏指定的条件不成立的时候，程序会中止，并且记录对应的日志信息。功能类似于ASSERT，区别是 CHECK 宏不受 NDEBUG 约束，在 release 版中同样有效。

目前这个功能我暂时不需要，就不实践了，简单介绍下，如：

CHECK(port == 80)<<"HTTP port 80 is not exit.";

其它还有：CHECK\_EQ、 CHECK\_NOTNULL、CHECK\_STREQ、CHECK\_DOUBLE\_EQ 等判断数字、空指针，字符串，浮点数的 CHECK 宏，需要使用时可以搜索 glog/logging.h 文件中以 CHECK\_ 开头的宏定义。

此外，类似的，还有 PCHECK 和 RAW\_CHECK 版本，使用方法类似，只是 RAW\_CHECK 使用方法特殊，形如 RAW\_CHECK(i<3,"RAW\_CHECK");

**6、core dumped **

通过 google::InstallFailureSignalHandler(); 即可注册，将 core dumped 信息输出到 stderr，如：

![复制代码][copycode.gif]

#include <glog/logging.h> #include <string> #include <fstream>
    
    //将信息输出到单独的文件和 LOG(ERROR)
    void SignalHandle(const char* data, int size) { std::ofstream fs("glog_dump.log",std::ios::app); std::string str = std::string(data,size); fs<<str; fs.close(); LOG(ERROR)<<str; } class GLogHelper { public: GLogHelper(char* program) { google::InitGoogleLogging(program); FLAGS_colorlogtostderr=true; google::InstallFailureSignalHandler(); //默认捕捉 SIGSEGV 信号信息输出会输出到 stderr，可以通过下面的方法自定义输出方式：
            google::InstallFailureWriter(&SignalHandle); } ~GLogHelper() { google::ShutdownGoogleLogging(); } }; void fun() { int* pi = new int; delete pi; pi = 0; int j = *pi; } int main(int argc,char* argv[]) { GLogHelper gh(argv[0]); fun(); }

![复制代码][copycode.gif]

输出的错误报告如下，可定位错误于 fun() 函数内：

![复制代码][copycode.gif]

E1211 06:07:04.787719 15444 test01.cpp:11\] \*\*\* Aborted at 1386742024 (unix time) try "date -d @1386742024" if you are using GNU date \*\*\*  
E1211 06:07:04.789120 15444 test01.cpp:11\] PC: @           0x401227 fun()  
E1211 06:07:04.789481 15444 test01.cpp:11\] \*\*\* SIGSEGV (@0x0) received by PID 15444 (TID 0x7f03ce478720) from PID 0; stack trace: \*\*\*  
E1211 06:07:04.791168 15444 test01.cpp:11\]     @     0x7f03cd505960 (unknown)  
E1211 06:07:04.791453 15444 test01.cpp:11\]     @           0x401227 fun()  
E1211 06:07:04.791712 15444 test01.cpp:11\]     @           0x40125b main  
E1211 06:07:04.792908 15444 test01.cpp:11\]     @     0x7f03cd4f1cdd \_\_libc\_start\_main  
E1211 06:07:04.793227 15444 test01.cpp:11\]     @           0x400fc9 (unknown)  
段错误 (core dumped)

![复制代码][copycode.gif]

如果不使用  google::InstallFailureSignalHandler();  则只会输出 “段错误” 三个字，难于排查。

**7、其它常用配置**

google::SetLogDestination(google::ERROR,"log/prefix_");   //第一个参数为日志级别，第二个参数表示输出目录及日志文件名前缀。
    google::SetStderrLogging(google::INFO); 　　//输出到标准输出的时候大于 INFO 级别的都输出；等同于 FLAGS_stderrthreshold=google::INFO;
    FLAGS_logbufsecs =0;　　//实时输出日志
    FLAGS_max_log_size =100;　　//最大日志大小（MB）
    #define GOOGLE_STRIP_LOG 3    // 小于此级别的日志语句将在编译时清除，以减小编译后的文件大小，必须放在 #include 前面才有效。

**8、日志文件说明**

如果可执行文件名为 "test"，则将日志输出到文件后，还会生成 test.ERROR，test.WARNING，test.INFO 三个链接文件，分别链接到对应级别的日志文件。如果日志输出超过 FLAGS\_max\_log\_size 设置的大小，则会分为多个文件存储，链接文件就会指向其中最新的对应级别的日志文件。所以当日志文件较多时，查看链接文件来查看最新日志挺方便的。

**三、实用封装**

**　　GLogHelper.h 如下：**

![复制代码][copycode.gif]

#include <glog/logging.h> #include <glog/raw_logging.h>
    
    //将信息输出到单独的文件和 LOG(ERROR)
    void SignalHandle(const char* data, int size); class GLogHelper { public: //GLOG配置：
        GLogHelper(char* program); //GLOG内存清理：
        ~GLogHelper(); };

![复制代码][copycode.gif]

**　　GlogHelper.cpp 如下：**

![复制代码][copycode.gif]

#include <stdlib.h> #include "GLogHelper.h"
    
    //配置输出日志的目录：
    #define LOGDIR "log"
    #define MKDIR "mkdir -p "LOGDIR
    
    //将信息输出到单独的文件和 LOG(ERROR)
    void SignalHandle(const char* data, int size) { std::string str = std::string(data,size); /* std::ofstream fs("glog_dump.log",std::ios::app); fs<<str; fs.close(); */ LOG(ERROR)<<str; //也可以直接在这里发送邮件或短信通知，不过这个方法是被回调多次的（每次回调只输出一行错误信息，所以如上面的记录到文件，也需要>以追加模式方可），所以这里发邮件或短信不是很适合，不过倒是可以调用一个 SHELL 或 PYTHON 脚本，而此脚本会先 sleep 3秒左右，然后将错
    误信息通过邮件或短信发送出去，这样就不需要监控脚本定时高频率执行，浪费效率了。 } //GLOG配置：
    GLogHelper::GLogHelper(char* program) { system(MKDIR); google::InitGoogleLogging(program); google::SetStderrLogging(google::INFO); //设置级别高于 google::INFO 的日志同时输出到屏幕
        FLAGS_colorlogtostderr=true;    //设置输出到屏幕的日志显示相应颜色 //google::SetLogDestination(google::ERROR,"log/error_"); //设置 google::ERROR 级别的日志存储路径和文件名前缀
        google::SetLogDestination(google::INFO,LOGDIR"/INFO_"); //设置 google::INFO 级别的日志存储路径和文件名前缀
        google::SetLogDestination(google::WARNING,LOGDIR"/WARNING_");   //设置 google::WARNING 级别的日志存储路径和文件名前缀
        google::SetLogDestination(google::ERROR,LOGDIR"/ERROR_");   //设置 google::ERROR 级别的日志存储路径和文件名前缀
        FLAGS_logbufsecs =0;        //缓冲日志输出，默认为30秒，此处改为立即输出
        FLAGS_max_log_size =100;  //最大日志大小为 100MB
        FLAGS_stop_logging_if_full_disk = true;     //当磁盘被写满时，停止日志输出
        google::SetLogFilenameExtension("91_");     //设置文件名扩展，如平台？或其它需要区分的信息
        google::InstallFailureSignalHandler();      //捕捉 core dumped
        google::InstallFailureWriter(&SignalHandle);    //默认捕捉 SIGSEGV 信号信息输出会输出到 stderr，可以通过下面的方法自定义输出>方式：
    } //GLOG内存清理：
    GLogHelper::~GLogHelper() { google::ShutdownGoogleLogging(); }

![复制代码][copycode.gif]

**　　测试文件 test.cpp 如下：**

![复制代码][copycode.gif]

#include "GLogHelper.h"
    
    int main(int argc,char* argv[]) { //要使用 GLOG ，只需要在 main 函数开始处添加这句即可
        GLogHelper gh(argv[0]); LOG(INFO)<<"INFO"; LOG(ERROR)<<"ERROR"; }

![复制代码][copycode.gif]

[copycode.gif]: /images/20210825/ce3f39118d3544da9eb8fef43616ffae.png
[https_code.google.com_p_google-glog_downloads_list]: https://code.google.com/p/google-glog/downloads/list
[http_google-glog.googlecode.com_svn_trunk_doc_glog.html]: http://google-glog.googlecode.com/svn/trunk/doc/glog.html
[http_www.cnblogs.com_tianyajuanke_p_3467572.html]: http://www.cnblogs.com/tianyajuanke/p/3467572.html