Google Logging (glog) 库完全指南：C++应用日志记录的最佳实践

Google Logging (glog) 库完全指南：C++应用日志记录的最佳实践

glog 项目地址: https://gitcode.com/gh_mirrors/glog6/glog

什么是Google Logging (glog)库

Google Logging (glog)是一个专为C++14及以上版本设计的应用程序级日志记录库。作为Google内部广泛使用的日志解决方案，它提供了基于C++流式风格的日志API和一系列实用宏，帮助开发者高效地实现结构化日志记录。

核心特性

1. 多级别日志：支持INFO、WARNING、ERROR、FATAL等不同严重级别的日志记录
2. 线程安全：内置线程安全机制，适合多线程环境使用
3. 高性能：经过Google生产环境验证的高性能实现
4. 灵活配置：支持日志文件滚动、日志级别动态调整等高级功能
5. 跨平台：支持Linux、Windows、macOS等多种操作系统

快速入门指南

基本日志记录

使用glog记录日志非常简单直观，下面是一个基本示例：

#include <glog/logging.h>

int main(int argc, char* argv[]) {
    // 初始化日志系统
    google::InitGoogleLogging(argv[0]);
    
    int num_cookies = 42;
    
    // 记录不同级别的日志
    LOG(INFO) << "程序启动成功";
    LOG(WARNING) << "发现" << num_cookies << "个cookie，可能过多";
    LOG(ERROR) << "无法连接到数据库";
    
    return 0;
}

日志级别说明

glog定义了以下几种标准日志级别：

• INFO：普通信息性消息
• WARNING：警告信息，表明潜在问题
• ERROR：错误信息，需要关注但不会终止程序
• FATAL：致命错误，将终止程序

高级用法

条件日志

glog提供了多种条件日志宏，可以只在特定条件下记录日志：

// 只在条件满足时记录日志
LOG_IF(INFO, num_cookies > 10) << "发现大量cookie: " << num_cookies;

// 每N次记录一次日志
LOG_EVERY_N(INFO, 100) << "已处理" << google::COUNTER << "个请求";

// 首次出现时记录日志
LOG_FIRST_N(INFO, 1) << "首次启动检测";

调试日志

对于调试目的，glog提供了专门的调试日志宏：

DLOG(INFO) << "调试信息，只在调试模式记录";
DLOG_IF(INFO, condition) << "条件调试日志";

检查宏

glog包含了一系列检查宏，类似于断言但功能更强大：

CHECK_EQ(a, b) << "a必须等于b";
CHECK_NE(a, b) << "a必须不等于b";
CHECK_LT(a, b) << "a必须小于b";

配置与优化

日志文件管理

glog可以自动管理日志文件，支持按大小或时间滚动：

// 设置日志文件前缀
google::SetLogDestination(google::INFO, "/var/log/myapp_info_");
// 设置日志文件最大大小(MB)
google::SetLogFileSize(100);  // 100MB
// 保留的日志文件数量
google::SetLogFilesNum(10);

性能优化建议

1. 在生产环境中适当提高日志级别，减少不必要的日志记录
2. 使用DLOG系列宏替代LOG进行调试日志记录
3. 避免在日志语句中进行复杂计算
4. 考虑使用异步日志记录提高性能

常见问题解答

Q: 如何控制日志输出级别？

A: 可以通过环境变量或代码设置最小日志级别：

// 代码设置
FLAGS_minloglevel = google::WARNING;  // 只记录WARNING及以上级别

Q: 如何将日志同时输出到控制台和文件？

A: 设置FLAGS_logtostderr标志：

FLAGS_logtostderr = 1;  // 输出到stderr
FLAGS_alsologtostderr = 1;  // 同时输出到文件和stderr

Q: 如何自定义日志格式？

A: 可以通过设置日志前缀样式：

FLAGS_log_prefix = true;  // 启用前缀
FLAGS_log_year_in_prefix = true;  // 在前缀中包含年份

结语

Google Logging (glog)库为C++应用程序提供了强大而灵活的日志记录解决方案。通过本文的介绍，您应该已经掌握了glog的基本用法和高级特性。在实际项目中合理使用glog，可以大大提高应用程序的可维护性和可调试性。

glog 项目地址: https://gitcode.com/gh_mirrors/glog6/glog