glog 是 google 的一个 c++ 开源日志系统,轻巧灵活,入门简单,而且功能也比较完善。
安装
以下是官方的安装方法,一句命令:
➜ code git clone https://github.com/google/glog.git
➜ code cd glog
➜ glog git:(master) ✗ ./configure && make && make install
然而我出现了 N 个错误,以下是两个编译的错误:
错误记录:
Issue1: 出现 aclocal-1.14: command not found
和 recipe for target 'aclocal.m4' failed
的错误提示。
解决方法:
➜ glog git:(master) ✗ sudo apt-get install automake
➜ glog git:(master) ✗ sudo autoreconf -ivf
Issue2:之后出现另一个错误:error: expected initializer before 'Demangle'
。
解决方法:
➜ code cd glog
➜ glog git:(master) ✗ mkdir build && cd build
➜ build git:(master) ✗ export CXXFLAGS="-fPIC" && cmake .. && make VERBOSE=1
➜ build git:(master) ✗ make
➜ build git:(master) ✗ sudo make install
使用
菜鸟级
从一个最简单的程序开始:
#include <glog/logging.h>
int main(int argc,char* argv[])
{
google::InitGoogleLogging(argv[0]); //初始化 glog
LOG(INFO) << "Hello,GOOGLE!";
}
编译:
➜ glog g++ glog_test2.cpp -lglog -lgflags -lpthread -o glog_test #编译
➜ glog ./glog_test
➜ glog ll /tmp # 默认日志在 /tmp 下
total 28K
-rw-rw-r-- 1 angryrookie angryrookie 193 7月 3 22:04 glog_test.cheng.angryrookie.log.INFO.20160703-220405.6569
lrwxrwxrwx 1 angryrookie angryrookie 57 7月 3 22:04 glog_test.INFO -> glog_test.cheng.angryrookie.log.INFO.20160703-220405.6569
➜ glog cat /tmp/glog_test.INFO
Log file created at: 2016/07/03 22:04:05
Running on machine: cheng
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
I0703 22:04:05.242153 6569 glog_test2.cpp:7] Hello,GLOG!
这里 g++ 编译的时候注意链接的库是要按顺序的(我也是才知道)。gcc 和 g++ 中库的链接顺序是从右往左进行,所以要把最基础实现的库放在最后,这样左边的 lib 就可以调用右边的 lib 中的代码。
一开始没注意顺序出现各种找不到函数,用 nm -C
定位了好久。而且这里我必须再链接上 gflags 才能成功编译,看网上其他人都没有。如果有大神知道为什么麻烦带带我。
这里没有指定日志文件的目录,默认会放在 /tmp 下,文件名的格式为 <program name>.<hostname>.<user name>.log.<severity level>.<date>.<time>.<pid>
。我们再看一下代码打印出的日志信息:
I0703 22:04:05.242153 6569 glog_test2.cpp:7] Hello,GLOG!
这一行信息对应的分别是:I+日期 时:分:秒.微秒 线程号 源文件名:行数] 信息
,这些信息对定位问题,做统计都很有效,可以根据具体项目来做分析。
新手级
日志文件的位置可以通过 gflags 命令行参数 log_dir 来指定,这时注意在 main 函数开始时初始化 gflags: google::ParseCommandLineFlags(&argc, &argv, true);
,也可以直接在代码里 指定 FLAGS_log_dir
的值。这里还是推荐标准的做法,即用命令行参数。
glog 的日志会根据日志严重性分级记录日志,标准的分级为:INFO, WARNING, ERROR, FATAL。不同级别的日志信息会输出到不同文件,同时高级别的日志也会写入到低级别中。
再看个例子:
#include <glog/logging.h>
int main(int argc,char* argv[])
{
google::InitGoogleLogging(argv[0]); // 初始化 glog
google::ParseCommandLineFlags(&argc, &argv, true); // 初始化 gflags
LOG(INFO) << "Hello, GOOGLE!"; // INFO 级别的日志
LOG(ERROR) << "ERROR, GOOGLE!"; // ERROR 级别的日志
return 0;
}
再次编译运行:
➜ glog g++ glog_test2.cpp -lglog -lgflags -lpthread -o glog_test
➜ glog mkdir log # 建一个目录放日志文件
➜ glog ./glog_test -log_dir=./log
E0703 22:59:13.380125 6867 glog_test2.cpp:8] ERROR, GOOGLE! # 这里 ERROR 级别的日志还作为 stderr 输出了到控制台
➜ glog ll log
total 16K
-rw-rw-r-- 1 angryrookie angryrookie 196 7月 3 22:59 glog_test.cheng.angryrookie.log.ERROR.20160703-225913.6867
-rw-rw-r-- 1 angryrookie angryrookie 257 7月 3 22:59 glog_test.cheng.angryrookie.log.INFO.20160703-225913.6867
-rw-rw-r-- 1 angryrookie angryrookie 196 7月 3 22:59 glog_test.cheng.angryrookie.log.WARNING.20160703-225913.6867
lrwxrwxrwx 1 angryrookie angryrookie 58 7月 3 22:59 glog_test.ERROR -> glog_test.cheng.angryrookie.log.ERROR.20160703-225913.6867
lrwxrwxrwx 1 angryrookie angryrookie 57 7月 3 22:59 glog_test.INFO -> glog_test.cheng.angryrookie.log.INFO.20160703-225913.6867
lrwxrwxrwx 1 angryrookie angryrookie 60 7月 3 22:59 glog_test.WARNING -> glog_test.cheng.angryrookie.log.WARNING.20160703-225913.6867
这里可以看到,我们通过 log_dir 指定了日志存放目录。而这里虽然我们没有输出 WARNING 级别的日志信息,但却有该级别的日志。看一下分别是什么:
➜ glog cd log
➜ log cat glog_test.ERROR
Log file created at: 2016/07/03 22:59:13
Running on machine: cheng
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
E0703 22:59:13.380125 6867 glog_test2.cpp:8] ERROR, GOOGLE!
➜ log cat glog_test.WARNING
Log file created at: 2016/07/03 22:59:13
Running on machine: cheng
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
E0703 22:59:13.380125 6867 glog_test2.cpp:8] ERROR, GOOGLE!
➜ log cat glog_test.INFO
Log file created at: 2016/07/03 22:59:13
Running on machine: cheng
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
I0703 22:59:13.379570 6867 glog_test2.cpp:7] Hello, GOOGLE!
E0703 22:59:13.380125 6867 glog_test2.cpp:8] ERROR, GOOGLE!
WARNING 级别的日志里放了 ERROR 的输出信息,这就是我们说的高级别的日志会写入到低级别中,而且是每个低级别。
还有一个常用的日志输出语句,即自定义日志类型 VLOG。VLOG 的用法也很简单,像这样 VLOG(50) << "MY VLOG INFO";
。这里的 50 只是自己定义的一个级别,事实上你可以定义任何一个数字,但一般越小的数字代表这条输出日志越重要。通过命令行参数 -v 50 这样子来指定 VLOG 输出的级别,-v 50 意味着只有小于 50 以下的 VLOG 才会被输出(这里不会影响 LOG(INFO)
这些)。一般项目里越底层的库使用越大数字的 VLOG 来打印调试信息,这样可以使得日志不会被一堆底层库的运行信息淹没。
再看个例子:
#include <glog/logging.h>
int main(int argc,char* argv[])
{
google::InitGoogleLogging(argv[0]);
google::ParseCommandLineFlags(&argc, &argv, true);
LOG(INFO) << "Hello, GOOGLE!";
VLOG(100) << "VLOG INFO 100";
VLOG(50) << "VLOG INFO 50";
VLOG(10) << "VLOG INFO 10";
return 0;
}
这里我们有三条 VLOG 信息,分别是 100 50 10 三个级别。VLOG 的信息只会出现在 INFO 级别的日志中:
➜ glog g++ glog_test3.cpp -lglog -lgflags -lpthread -o glog_test
➜ glog ./glog_test -log_dir=./log -v 50
➜ glog cat log/glog_test.INFO
Log file created at: 2016/07/03 23:24:32
Running on machine: cheng
Log line format: [IWEF]mmdd hh:mm:ss.uuuuuu threadid file:line] msg
I0703 23:24:32.225793 7046 glog_test3.cpp:7] Hello, GOOGLE!
I0703 23:24:32.226384 7046 glog_test3.cpp:9] VLOG INFO 50
I0703 23:24:32.226410 7046 glog_test3.cpp:10] VLOG INFO 10
我们可以看到,指定了 -v 50 后,只有小于等于 50 的 VLOG 及正常 LOG(INFO) 信息被打印出来。如果你问如果不指定会怎样,回答就是一条 VLOG 信息都不会出现。
进阶版
如果你以为这里还有进阶版介绍的话,我只能向你表示抱歉。我的使用只是简单级别,目前项目也没有必要更复杂的 glog 接口。
当然,我们也可以像其他博客把 glog 的功能全列出来:
- 参数设置,以命令行参数的方式设置标志参数来控制日志记录行为
- 严重性分级,根据日志严重性分级记录日志
- 可有条件地记录日志信息
- 条件中止程序。丰富的条件判定宏,可预设程序终止条件
- 异常信号处理。程序异常情况,可自定义异常处理过程
- 支持debug功能。可只用于debug模式
- 自定义日志信息
- 线程安全日志记录方式
- 系统级日志记录
- google perror风格日志信息
- 精简日志字符串信息
参考资料
google-glog 开源库分析(一):glog介绍 - 天使的秘密
http://www.cnblogs.com/davidyang2415/p/3861109.html
google-glog 开源库分析(二):glog用法 - 天使的秘密
http://www.cnblogs.com/davidyang2415/p/3861112.html
google-glog 开源库分析(三):glog核心类结构 - 天使的秘密
http://www.cnblogs.com/davidyang2415/p/3861118.html
google-glog 开源库分析(四):glog宏技巧 - 天使的秘密
http://www.cnblogs.com/davidyang2415/p/3861120.html
C++的开源跨平台日志库glog学习研究(一) - lizhenghn
http://www.cnblogs.com/lizhenghn/p/3704749.html
C++的开源跨平台日志库glog学习研究(二)--宏的使用 - lizhenghn
http://www.cnblogs.com/lizhenghn/archive/2014/05/03/3705410.html
C++的开源跨平台日志库glog学习研究(三)--杂项 - lizhenghn
http://www.cnblogs.com/lizhenghn/p/3720508.html
如何使用Google日志库 (glog) - chenguangxing3的专栏
http://blog.csdn.net/chenguangxing3/article/details/17150069
glog使用与功能修改
http://www.cppfans.org/1566.html
glog多线程下按照指定条件创建新的日志文件 - lijingpeng的专栏
http://blog.csdn.net/lijingpengchina/article/details/9050539
window环境下glog的安装 - lijingpeng的专栏
http://blog.csdn.net/lijingpengchina/article/details/9047777
网友评论