日志系统整体设计步骤以及功能函数梳理

首先到底要做一个什么东西我们要造一个C 高并发异步日志库功能如下用LOG_INFO xxx这种简单写法自动带时间、级别、文件名、函数名、行号支持级别过滤TRACE/DEBUG/INFO/WARN/ERROR/FATAL异步写文件不卡主线程文件自动滚动按大小 / 按天线程安全多线程一起写不乱你平时写的cout 出错了 endl;我们要做的LOG_INFO 服务器启动成功; LOG_ERROR 数据库连接失败;输出效果20260407 18:22:33.123456 INFO main.cpp:100 server start success第一阶段最基础的零件——所有功能的地基1. LogCommon.hpp 公用定义作用定规矩定义 6 个日志级别TRACE DEBUG INFO WARN ERROR FATAL定义级别名字符串映射INFO → INFO定义缓冲区大小常量namespace tulun { // 日志级别数字越小越详细 enum class LOG_LEVEL { TRACE 0, DEBUG, INFO, WARN, ERROR, FATAL, }; // 数字转字符串0→TRACE1→DEBUG… const char* LLtoStr[] { TRACE, DEBUG, INFO, WARN, ERROR, FATAL }; // 缓冲区大小常量 const int SMALL_BUFF_SIZE 128; }面试点日志级别用来过滤线上只开 INFO调试开 DEBUG。2. Timestamp 时间戳作用给每一条日志打精准时间功能获取当前微秒级时间格式化成好看的字符串20260407 18:22:33.123456给文件命名用20260407-182233核心函数now()获取当前时间toString()格式化字符串// 获取当前微秒时间戳 Timestamp Timestamp::Now() { struct timeval tv; gettimeofday(tv, nullptr); uint64_t micro tv.tv_sec * 1000000 tv.tv_usec; return Timestamp(micro); } // 转成 2026/04/07-15:30:55.123456Z string Timestamp::toFormattedString()为什么微秒高并发系统能区分同一毫秒内的多条日志。3. LogMessage 日志消息体作用把一条日志拼成完整格式它会自动拼接时间 级别 文件名 行号 你的内容你写LOG_INFO 连接成功;它自动拼成2026/04/07-15:30:55 INFO main.cpp main() 10 连接成功组成部分时间戳 Timestamp日志级别 INFO/DEBUG…文件名截取最后一段函数名__func__行号__LINE__用户输入的内容核心函数// 构造函数拼头部 LogMessage::LogMessage(level, file, func, line) { ss 时间 级别 文件名 函数 行号; header_ ss.str(); } // 重载 运算符让你能流式写 templateclass T LogMessage operator(const T val) { text_ val; return *this; } // 最终返回完整日志字符串 string LogMessage::toString() { return header_ text_; }第二阶段核心大脑 Logger——日志器作用给用户提供最简单的接口控制全局行为它干 5件事全局日志级别控制——判断这条日志该不该输出提供输出接口控制台 / 文件 / 异步——提供LOG_INFO等宏给你用提供刷新接口——决定输出到哪控制台 / 文件 / 网络线程安全控制析构时输出日志最关键的设计利用析构函数输出日志// 1. 用户写 LOG_INFO xxx Logger::Logger(level, file, func, line) : impl_(level, file, func, line) // 构造 LogMessage {} // 2. 临时对象销毁时自动输出 Logger::~Logger() { // 把日志字符串给输出函数 s_output_(impl_.toString()); s_flush_(); // 如果是 FATAL直接退出进程 if (level FATAL) exit(1); }日志宏#define LOG_INFO \ if (当前级别 INFO) \ Logger(INFO, __FILE__, __func__, __LINE__).stream()为什么要用宏自动带__FILE__文件名自动带__func__函数名自动带__LINE__行号级别不满足时整条语句不执行零开销最重要的 4 个函数setLogLevel设置过滤级别低于该级别直接丢弃。setOutput你可以指定输出位置默认输出到控制台可以改成输出到文件可以改成输出到异步系统output真正执行输出的函数。日志宏 LOG_XXX包装了文件、行号、函数名让你用起来超级简单。第三阶段同步日志流程超级简单LOG_INFO hello → 生成 Logger 临时对象 → 构造 LogMessage拼头部 → operator 写入内容 → 析构函数调用 output() → output 直接输出到控制台/文件缺点写磁盘是慢 IO高并发下业务线程会被日志卡住性能暴跌。所以我们必须做异步日志第四阶段高性能核心 —— 异步日志 AsyncLogging为什么要异步同步主线程自己写磁盘 →慢、阻塞异步主线程只丢到内存 →极速、不阻塞后台线程慢慢写磁盘异步日志设计思想双缓冲 / 多缓冲技术你可以理解为两个缓冲区交换使用前端缓冲区主线程拼命往里写日志后端缓冲区后台线程拿去写入文件当前端满了直接交换两个缓冲区后台线程默默写入完全不影响主线程这就是高并发日志库的核心类似于两个桶接力倒水前端桶主线程疯狂写日志后端桶后台线程拿去写文件前端满了 →交换两个桶主线程继续写后台线程慢慢刷盘关键成员currentBuffer_当前写的缓冲区buffers_装满的缓冲区队列mutex_保护缓冲区cond_通知后台线程thread后台写线程核心流程用户 append加锁 → 往 currentBuffer 写 → 满了就放入队列 → 唤醒后端后端线程 loop等待队列非空 →把缓冲区全部拿走→ 解锁 → 批量写文件核心函数// 主线程调用写入日志 void AsyncLogging::append(const char* msg, size_t len) { lock_guard(mutex); if (当前缓冲区不够放) { buffers.push_back(move(currentBuffer)); currentBuffer.reset(); } currentBuffer.append(msg, len); cond.notify_one(); } // 后台线程函数 void AsyncLogging::workThreadFunc() { vectorstring buffersToWrite; while (running) { { unique_lock(mutex); // 等待 200ms 或有数据 cond.wait_for(lock, 200ms); // 把当前缓冲也加入队列 buffers.push_back(move(currentBuffer)); // 交换后端拿走所有缓冲前端清空 buffersToWrite.swap(buffers); } // 无锁批量写文件性能关键点 for (auto buf : buffersToWrite) { output_.append(buf); } } }为什么这么设计快锁时间极短只在交换缓冲区时加锁批量写减少 IO 次数主线程几乎无等待异步日志 3 个核心函数append()主线程调用把日志塞缓冲区超快threadFunc()后台线程死循环等待缓冲区满交换缓冲区写入文件start() / stop()启动 / 停止后台线程第五阶段 线程同步工具CountDownLatchCountDownLatch.hpp——等线程启动好作用确保异步线程真正启动后主线程才继续跑用法初始化计数 1主线程调用wait()线程启动好调用countDown()主线程继续执行保证日志线程没启动前不写日志第六阶段文件写入模块——日志最终落地1. AppendFile 底层文件操作作用封装 fwrite自带缓冲区减少 IO它是真正把字节写到磁盘的类。成员FILE* fp_文件句柄buffer_自带 1MB 缓冲区writenBytes_统计已写字节数用来滚动文件// 追加写入自带缓冲超快 void AppendFile::append(const char* msg, size_t len) { fwrite_unlocked(msg, 1, len, fp_); writenBytes_ len; } // 刷新到磁盘 void AppendFile::flush() { fflush(fp_); }2. LogFile 文件管理器作用管理日志文件 → 满了就切到第二天就切我最爱的功能永不爆炸的日志文件它管 3 件事生成文件名包含时间、主机名、进程 ID判断是否要滚动文件线程安全的写入接口滚动规则按大小滚动默认 128KB超过就切按时间滚动每天 0 点自动切新文件每次写入都会检查是否满了 / 是否跨天核心函数// 新建一个日志文件 bool LogFile::rollFile() // 线程安全的追加 void LogFile::append(...) { lock_guard(mutex); append_unlocked(...); } // 不加锁的追加内部用 void LogFile::append_unlocked(...) { file_-append(...); // 检查是否需要滚动/刷新 if (写太多) rollFile(); if (太久没刷) flush(); }文件名示例mylog.20260407_153055.unknownhost.1234.log为什么要滚动日志答防止单文件过大无法打开、占用磁盘、方便清理归档。第七阶段 整个库完整运行流程这个日志系统的亮点多级日志过滤线上关闭调试日志微秒级时间戳高并发精准排序自动携带上下文文件、行号、函数异步多缓冲主线程无阻塞高性能日志文件滚动按大小 / 时间切分线程安全多线程并发写不乱码异步日志完整链路1. 用户调用 LOG_INFO hello 2. 宏判断级别满足才执行 3. 构造 Logger 对象 4. 构造 LogMessage拼接时间/级别/文件/行号 5. operator 填入用户内容 6. Logger 析构调用 output() 7. output 把日志交给 AsyncLogging.append() 8. 主线程写入前端缓冲 9. 缓冲满/超时 → 交换缓冲 10. 后台线程批量写入 LogFile 11. LogFile 调用 AppendFile 写磁盘 12. 自动检查文件大小/时间 → 滚动文件我现在用一句话给你串起来我先做了时间戳、级别定义、底层文件写入这些小零件然后做了日志消息打包、日志入口宏为了高性能做了异步多缓冲为了方便管理做了日志滚动最后拼成一个主线程无阻塞、多线程安全、自动切文件的工业级日志库。文件核心功能LogCommon.hpp定义日志级别枚举TRACE/DEBUG/INFO/WARN/ERROR/FATAL、日志级别字符串映射、缓冲区大小常量Timestamp.hpp/.cpp时间戳封装支持微秒级时间获取、格式化输出普通字符串 / 文件命名格式LogMessage.hpp/.cpp日志消息封装拼接日志头时间、级别、文件 / 函数 / 行号和日志内容Logger.hpp/.cpp日志器核心类提供日志宏LOG_TRACE/LOG_DEBUG 等、输出 / 刷新函数设置、日志级别控制AppendFile.hpp/.cpp底层文件写入封装支持大缓冲区、非阻塞写入、字节计数LogFile.hpp/.cpp日志文件管理支持文件滚动按大小 / 时间、线程安全写入、自动刷新AsynLogging.hpp/.cpp异步日志实现后台线程批量写入日志减少主线程阻塞CountDownLatch.hpp/.cpp倒计时锁用于异步日志线程初始化同步第八阶段面试官最爱问的 10 题1. 你们日志系统为什么用异步同步日志会阻塞业务线程高并发下性能极差。异步日志将 IO 交给后台线程主线程只写内存无阻塞、高吞吐。2. 异步日志怎么实现的采用多缓冲技术前端缓冲区接收日志后端线程负责写入缓冲区满或定时则交换缓冲区批量写入3. 日志级别有什么用用于过滤日志。线上环境只开启 INFO/WARN/ERROR减少日志量提升性能。4. 日志文件滚动是什么防止文件无限变大。按大小或时间自动创建新文件方便管理、压缩、清理。5. 日志系统线程安全吗安全。共享缓冲区加锁、文件写入加锁、异步线程单独处理 IO。6. 你们日志的性能为什么高异步非阻塞批量写入磁盘减少 IO缓冲区减少系统调用锁粒度小7. FATAL 日志做了什么打印错误信息然后直接终止进程用于严重错误。8. 日志为什么要带文件名和行号方便快速定位代码问题。9. 时间戳为什么用微秒高并发场景下同一毫秒可能产生大量日志微秒能区分顺序。10. 这套日志能用于生产环境吗完全可以。它是仿照 Muduo 日志库设计的工业级标准高并发稳定可靠。