glog入门demo

glog

一. 下载与安装

git clone https://github.com/google/glog.git
cd glog
./autogen.sh
./configure
make
make check
make install

二.glog简单的使用说明

1. log的严重等级

等级描述 对应的等级数字
INFO 0
WARNING 1
ERROR 2
FATAL 3
  • 每一个等级都有一个对应的log输出文件,默认文件名为(包含文件路径) 为:/tmp/<program name>.<hostname>.<user name>.log.<severity level>.<date>.<time>.<pid>
  • 对于高严重的等级,不仅会把相应的log信息输出到对应到等级文件中,还会输出到比它更的log文件中, 例如对于ERROR等级的log,不仅会输出到ERROR的文件中,还会输出到INFO和WARNING的文件中。
  • 对于ERROR和FATAL等级,不仅仅会把相关的log信息输出到对应的文件中,还会把log信息输出到standard error中, 默认就是屏幕上。
  • 在release模式下,当产生了FATAL等级的log信息时,程序会被终止掉,在debug模式下,会自动把FATAL等级降至到ERROR等级, 也就是不会终止程序。

使用方法:

// 输出INFO等级的log信息。
LOG(INFO) << "This is INFO severity log information. ";
// 输出WARNING等级的log信息。
LOG(WARNING) << "This is WARNING severity log information. ";
// 输出ERROR等级的log信息。
LOG(ERROR) << "This is ERROR severity log information. ";
// 输出FATAL等级的log信息。
LOG(FATAL) << "This is FATAL severity log information. ";

2. 使用gflags在命令行中设置一些flag位.

在安装glog时,如果你的电脑中已经安装了gfalgs库的话, 在编译时,它会自动使用gflags库,然后呢,当你使用glog库时,就可以使用gflags库的命令行特性了。(需要在main函数的开始处加上对gflags的初始化代码gflags::ParseCommandLineFlags(&argc, &argv, true)). 常使用到flags包含(更详细看一下logging.cc文件):

  • logtostderr(bool类型): 把日志信息输出到stderr中,而不是文件中。 (在命令行中使用--logtostderr=true 或 --logtostderr=false)
  • stderrthreshold(int类型): 把严重等级>=指定等级的log信息额外输出到stderr中(默认为2,即ERROR和FATAL)
  • minloglevel (int 类型): 只有当严重等级>=指定等级时,会进行log的输出。

3. Conditional/Occasional Logging

  • LOG_IF(等级描述, 条件) << "日志信息"; 当条件满足时,才会打印日志。
  • LOG_EVERY_N(等级描述, n) << "日志信息"; 每n次会打印一条日志。
  • LOG_IF_EVERY_N(等级描述, 条件, n) << "日志信息."; 当条件成立时,每n次打印一条日志。
  • LOG_FIRST_N(等级描述, n) << "日志信息。"; 当打印前n次的日志信息。

4. debug 模式的支持

下面定义的宏只会在debug模式下起作用,在release模式下无效,这样可以避免在release版本下打印日志影响运行速度。

  • DLOG(等级描述) << "日志信息。";
  • DLOG_IF(等级描述, 条件) << "日志信息";
  • DLOG_EVERY_N(等级描述, n) << "日志信息";

5. CHECK 宏的使用

CHECK宏提供了一种机制:当条件不满足时,程序直接终止掉, 类似于ASSERT宏。

宏的名字 作用
CHECK_EQ(a,b) 检测a与b是否相等
CHECK_NE(a,b) 检测a与b是否不相等
CHECK_LE(a,b) 检测a是否小于或等于b
CHECK_LT(a,b) 检测a是否小于b
CHECK_GE(a,b) 检测a是否大于或等于b
CHECK_GT(a,b) 检测a是否大于b
CHECK_NOTNULL(指针) 检测指针不为空,它的返回值是传给它的指针. 该宏不能像c++的输出流那样使用

使用方法:

CHECK_EQ(a,b) << " 当a与b不相等时,程序会中止运行,并打印出该条目志信息。";

特别注意:当指针与NULL进行比较时,编译器会报错,因为把NULL认为是0。 如果不想报错,需要把NULL强转换为指针类型(static_cast<指针类型>(NULL).

6. 用户自己定义Failure Function

当产生FATAL的日志信息或CHECK宏检测失败时,程序就会终止掉,默认情况下glog会dump出堆栈的相关信息并以错误码1退出程序的运行,我们可以注册自定义的函数来运行你想要的函数。

// 第一步:定义自己的Failure函数
void MyFailureFunction()
{
    /*
     添加自己的代码。
     */
    exit(1);
}

// 第二步,在main函数的开始部分,加入一行如下代码:
int main(int argc, char* argv[])
{
    /*
       其它初始化代码。
     */
    google::InstallFailureFunction(&MyFailureFunction);
}

7. Failure Signal Handler

可以自定义一些信号捕捉函数,然后通过google::InstallFailureSignalHandler()函数来注册一下。具体没有深入研究。

三. 运行小小的demo

1. 创建文件glog_demo.cpp文件,内容如下:

#include <glog/logging.h>

int main(int argc, char** argv) {
    gflags::ParseCommandLineFlags(&argc, &argv, true);
    google::InitGoogleLogging(argv[0]);
    LOG(INFO) << "This is INFO log information";
    LOG(WARNING) << "This is WARNING log information";
    LOG(ERROR) << "This is ERROR log information";
    //LOG(FATAL) << "This is FATAL log information";

    LOG_IF(INFO, 1 < 2) << "This is true: 1 < 2. ";
    for (int i = 0; i < 100; ++i)
    {
        LOG_EVERY_N(INFO, 10) << "Log every 10 times. ";
    }

    CHECK(1 < 2) << "The world is end, because one is not less than  2. ";
    return 0;
}

2. 编译并运行

g++ glog_demo.cpp -o a.out -pthread -lgflags -lglog
./a.out glog_demo.cpp --logtostderr=true
posted @ 2020-01-30 20:43  殷大侠  阅读(1989)  评论(0编辑  收藏  举报