C++ Boost::Log

Log

一个高度模块化和可扩展的C++日志库,旨在为应用程序提供灵活的日志记录功能。

Boost::Log Refference

设计理念

提供 高度模块化 和 可扩展 的日志处理。各个模块可以独立使用和替换,并且能够添加自定义功能。支持宽/窄字符记录。

三层架构

  1. 日志数据收集层
    • 负责从程序中处理收集的日志事件
  2. 收集数据处理层
    • 负责处理收集到的日志事件
  3. 连接前两层的中央枢纽
    • 协调管理日志在上两层之间的流转

设计要点: 这个架构的核心优势是正交性,即日志的收集、处理方式和日志内容本身是相互独立的。这种设计让库不仅能用于传统日志记录,还能用于向用户发出通知、累积统计信息等场景。

关键组件

构成以上三层的具体组件:

  • 日志源 (Logging Sources): 日志事件的发起者 。最常见的是日志记录器 (Logger),它提供了类似 std::ostream 的流式接口来 格式化 日志消息。库也支持其他类型的源,如捕获子进程的控制台输出等。

  • 属性与属性值 (Attributes and Attribute Values): 日志记录的元数据 。一个属性本质上是获取某个值的函数(例如获取当前时间),其返回的值就是 属性值 ,会在日志处理的后续阶段使用。属性分为 三种 类型:

    • 全局属性 :附加到 所有 日志记录,优先级最低。

    • 线程特定属性 :仅附加到 特定线程 生成的记录。

    • 源特定属性 :由日志源维护 ,仅附加到通过 该源生成的记录 ,优先级最高。

    • 当同名属性出现在多个集合中时,优先级高的属性会覆盖优先级低的。

  • 日志核心 (Logging Core): 中央枢纽的具体实现。它负责接收日志事件,并应用全局过滤器来决定哪些日志记录可以继续传递。核心被实现为 单例 (Singleton) ,可通过 boost::log::core::get() 访问。

  • 过滤器 (Filters): 核心的一部分功能。过滤器用于在核心层面 筛选 日志记录,决定其是否被处理。

  • 接收器 (Sinks): 日志处理的最终目的地。它是处理层的核心,负责将日志记录 格式化并输出到文件 、控制台、网络等不同目标。接收器采用前后端分离的设计:

    • 前端 (Frontend): 负责接收日志记录,并决定同步、异步等传递策略。

    • 后端 (Backend): 负责执行实际的格式化操作并将日志写入最终目标。