C++ Boost::Log
Log
一个高度模块化和可扩展的C++日志库,旨在为应用程序提供灵活的日志记录功能。
Boost::Log Refference
设计理念
提供 高度模块化 和 可扩展 的日志处理。各个模块可以独立使用和替换,并且能够添加自定义功能。支持宽/窄字符记录。
三层架构
- 日志数据收集层
- 负责从程序中处理收集的日志事件
- 收集数据处理层
- 负责处理收集到的日志事件
- 连接前两层的中央枢纽
- 协调管理日志在上两层之间的流转
设计要点: 这个架构的核心优势是正交性,即日志的收集、处理方式和日志内容本身是相互独立的。这种设计让库不仅能用于传统日志记录,还能用于向用户发出通知、累积统计信息等场景。
关键组件
构成以上三层的具体组件:
日志源 (Logging Sources): 日志事件的发起者 。最常见的是日志记录器 (Logger),它提供了类似 std::ostream 的流式接口来 格式化 日志消息。库也支持其他类型的源,如捕获子进程的控制台输出等。
属性与属性值 (Attributes and Attribute Values): 日志记录的元数据 。一个属性本质上是获取某个值的函数(例如获取当前时间),其返回的值就是 属性值 ,会在日志处理的后续阶段使用。属性分为 三种 类型:
全局属性 :附加到 所有 日志记录,优先级最低。
线程特定属性 :仅附加到 特定线程 生成的记录。
源特定属性 :由日志源维护 ,仅附加到通过 该源生成的记录 ,优先级最高。
当同名属性出现在多个集合中时,优先级高的属性会覆盖优先级低的。
日志核心 (Logging Core): 中央枢纽的具体实现。它负责接收日志事件,并应用全局过滤器来决定哪些日志记录可以继续传递。核心被实现为 单例 (Singleton) ,可通过 boost::log::core::get() 访问。
过滤器 (Filters): 核心的一部分功能。过滤器用于在核心层面 筛选 日志记录,决定其是否被处理。
接收器 (Sinks): 日志处理的最终目的地。它是处理层的核心,负责将日志记录 格式化并输出到文件 、控制台、网络等不同目标。接收器采用前后端分离的设计:
前端 (Frontend): 负责接收日志记录,并决定同步、异步等传递策略。
后端 (Backend): 负责执行实际的格式化操作并将日志写入最终目标。