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