日志库的设计思路

s_lisheng@163.com (AIDB) — Mon, 22 Jun 2026 19:38:13 +0800

一、基本思路
#

日志库的设计，抓住最核心的一条，就是日志从产生到到达最终目的地期间的处理流程。一般而言，为了设计一个灵活可扩展，可配置的日志库，可将日志库抽象为4个部分：记录器、过滤器、格式化器、输出器四部分。

组成	描述
记录器	负责产生日志记录的原始信息，比如（原始信息，日志等级，时间，记录的位置）等信息
过滤器	负责按指定的过滤条件过滤掉我们不需要的日志（比如按日志等级过滤）
格式化器	负责对原始日志信息按照我们想要的格式去格式化
输出器	负责将将要进行记录的日志（一般经过过滤器及格式化器的处理后）记录到日志目的地（例如：输出到文件中）

通过将日志库分为4个抽象，使之成了一个较为灵活可扩展的日志库。比如你想实现输出到文件和输出到TCP中这两个功能，你只需分别实现这两个输出器的实例即可。

实现了上面的抽象就基本实现日志库的核心功能。在具体实现上，需要设计一个Logger，将上面的抽象组合起来。另外还有一些其他的工作需要完善，比如读取日志配置文件，根据配置文件中的配置条件去构建相应的代码等等其他工作。

二、一条日志的生命周期
#

可能到目前对日志库是怎么工作的还有些模糊，下面以一条日志的生命周期为例来说明日志库是怎么工作的：

产生。info!("log information.");
经过记录器。记录器去获取日志发生的时间，位置，线程信息等等信息，会有一个数据结构去存储你需要的信息（例如：msg:"log information.",time:2018-3-20 10:00:00,level:info,location:main.rs:3 lines）
经过过滤器。决定是否记录（例如，过滤条件设为info级以下的过滤掉，这里条日志信息等级是info，满足条件，继续。）
经过格式化器。假设我们想输出为2018-3-22 10:00:00 [info] log information.
到输出器。例如输出到文件中，我们就将这条信息写到文件上（File::write(....);，文件中会记录2018-3-22 10:00:00 [info] log information.）.
假如你还实现了日志回滚等功能的话，在日志写入文件之后，还要判断是否触发日志回滚操作，如果满足了日志回滚的条件（比如文件Size超过某一大小），则进行日志回滚操作。
这条日志的生命周期结束了。

三、伪代码实现：
#

从配置文件中读取配置（可通过序列化或其他方式），生成Config。
LoggerBuilder根据Config去构造Logger。
由Logger实现日志库的核心功能。

//配置
struct Config {
    level:Level,
    ...
}

//Logger建造者
struct LoggerBuilder {
    ...
}

//Logger
struct Logger {
    record:Recorder,
    filter:Filter,
    formater:Formater,
    output:Output,
}
......

四、更多功能细节
#

上面是日志库设计的主干，可能我们还需要更多的功能，比如日志回滚、运行时修改配置等……

日志库 on AIDB

日志库的设计思路

一、基本思路 #

二、一条日志的生命周期 #

三、伪代码实现： #

四、更多功能细节 #

一、基本思路
#

二、一条日志的生命周期
#

三、伪代码实现：
#

四、更多功能细节
#