CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
数据存储

【数据存储】日志切割归档:按天滚动与压缩

2026-09-21 11:48 作者:996 技术组 数据存储

实战应用:用在哪里

服务器的日志文件按天滚动切割:每天的日志独立成一个文件,超过保留期的日志自动压缩归档。切割的机制让日志的文件大小可控,归档的压缩让历史日志的存储成本降到原始的10 分之一。

按天切割

lua

---日志的按天切割
function LogRotate.checkAndRotate(logName)
    local today = os.date("%Y-%m-%d")
    local file = logName .. "_" .. today .. ".log"
    local size = QF_FileSize(file)
    if size > 500 * 1024 * 1024 then
        -- 超过 500MB 按序号切割
        local seq = 1
        while QF_FileExists(logName .. "_" .. today .. "_" .. seq .. ".log") do
            seq = seq + 1
        end
        QF_RenameFile(file, logName .. "_" .. today .. "_" .. seq .. ".log")
    end
end

单日日志超过 500MB 时按序号切割成多个文件,切割的粒度让单个文件的大小可控。切割的序号递增,同一天内的多个切割文件按序号排序。切割后的文件由压缩任务在低峰期压缩,压缩比约 8 比 1。

压缩与归档

lua

---日志的压缩归档
function LogArchive.compress(logName, date)
    local src = logName .. "_" .. date .. ".log"
    local dst = logName .. "_" .. date .. ".gz"
    QF_GzipCompress(src, dst)
    QF_DeleteFile(src)
end

function LogArchive.purge(logName, keepDays)
    local cutoff = os.date("%Y-%m-%d", os.time() - keepDays * 86400)
    local files = QF_ListFiles(logName .. "_*.gz")
    for _, f in ipairs(files) do
        local fileDate = f:match("(%d{4}-%d{2}-%d{2})")
        if fileDate < cutoff then
            QF_DeleteFile(f)
        end
    end
end

压缩的格式用 gzip 通用标准,解压的工具不限。保留的期限按日志类型分级:支付日志三年、行为日志一年、调试日志 30 天。归档的清理任务每周执行一次,过期的归档自动删除。日志的磁盘占用看板实时展示总量与趋势,超阈值的告警提前预警磁盘的满溢。

验证与监控

磁盘占用与日志文件的每日增量监控,增量异常(翻倍级)排查日志的输出量。

踩坑记录

切割的阈值曾经按文件行数计算,大行数的日志文件在磁盘上占用远超预期,改为按字节切割后可控。压缩的工具曾经依赖外部命令,外部命令的缺失让压缩静默失败,改用内置的压缩函数消除外部依赖。

上线要点

日志的切割参数(阈值、保留期、压缩开关)进配置表,运维的调整不改代码。日志的归档与磁盘的清理任务错峰执行,IO 的竞争在低峰期消失。日志的磁盘占用在看板展示趋势与预测,磁盘的扩容决策提前一周做出。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。

作者履历与出处

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。

← 返回文章地图返回研学路径

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

网络通信聊天聚合

【网络通信】跨服聊天话题聚合:多服聊天的话题合并设计

实战应用:用在哪里 跨服开放后,各服的世界频道各自为政,热门话题被服务器墙分隔。话题聚合方案:带话题标签的消息汇聚到跨服频道…

2026-09-22 17:43 996 技术组
数据存储行为数据周报

【数据存储】玩家行为周报摘要:行为数据的聚合存储设计

实战应用:用在哪里 运营要的是“这周谁打了副本、谁在挂机、谁在交易”,不是每天几万条的原始行为流。周报摘要方案:行为流水按玩…

2026-09-22 17:43 996 技术组
界面UI聊天轮盘

【界面UI】聊天快捷短语轮盘:常用语轮盘的交互设计

实战应用:用在哪里 战斗中打字报点来不及,快捷短语轮盘让玩家按住轮盘键滑向常用语松手即发:集合、撤退、求奶、集火左,八条槽位…

2026-09-22 17:43 996 技术组
前端接口手柄适配

【前端接口】游戏手柄按键映射:外设适配的映射实现

实战应用:用在哪里 部分玩家用手柄玩传奇,键位习惯各不相同。按键映射方案:手柄的摇杆、十字键、肩键映射到游戏动作,映射表玩家…

2026-09-22 17:43 996 技术组
Lua实战闭包封装

【Lua实战】闭包封装状态:计数器与工厂函数的实战应用

实战应用:用在哪里 模块级的计数器、限流器都面临一个问题:状态存全局容易被别的代码改坏。闭包把状态封在函数的作用域里,外部只…

2026-09-22 17:43 996 技术组
玩法设计师徒副本

【玩法设计】师徒双人副本:协同关卡的匹配与奖励设计

实战应用:用在哪里 师门任务的日常共同任务做成师徒双人副本:师父带徒弟进入专属关卡,关卡机制要求两人配合——师父扛伤开门、徒…

2026-09-22 17:43 996 技术组