游戏客户端架构 / 系统课时

日志本身会不会拖慢游戏

日志本身会不会拖慢游戏

日志并不是“写几行文字”这么简单。高频调用时,字符串格式化、线程同步、缓冲区复制和磁盘写入都可能进入帧时间预算。本节从实际开销链路出发,判断日志什么时候会从诊断工具变成性能问题,并建立低开销的记录方式。

学习目标

  • 识别高频日志消耗 CPU、内存和 I/O 的主要位置
  • 用简单基准验证日志频率对执行时间的影响
  • 建立分级、采样、聚合和异步写入的低开销策略

日志成本发生在哪里

一次日志调用通常不只包含最终的文件写入。客户端可能先判断日志级别,再构造字符串、序列化对象、获取时间和线程信息,之后进入队列或锁,最后才由缓冲区写入文件。

高频日志从调用到磁盘的开销链路

其中最容易被低估的是调用频率。单次格式化只花几十微秒并不代表安全:如果它出现在每帧、每个实体甚至每个网络包的循环中,累计成本会迅速放大。日志还可能产生临时字符串,使托管运行时承受额外 GC 压力。

磁盘写入同样不能只看文件大小。频繁刷新缓冲区、小块同步写入,或者多个线程竞争同一个日志输出器,都可能造成抖动。对于追求稳定帧时间的客户端,偶发的数毫秒阻塞往往比平均吞吐量更值得关注。

用基准看到频率差异

下面的 C# 程序比较“每次循环都写日志”和“每 100 次采样一次”。它不是游戏引擎性能测试,但可以直观看出减少格式化与写入次数为什么有效。

csharp
using System;
using System.Diagnostics;
using System.IO;
using System.Text;

class Program
{
    static void Main()
    {
        const int count = 20_000;
        string densePath = Path.Combine(Path.GetTempPath(), "dense-log.txt");
        string sampledPath = Path.Combine(Path.GetTempPath(), "sampled-log.txt");

        long denseMs = WriteLogs(densePath, count, 1);
        long sampledMs = WriteLogs(sampledPath, count, 100);

        Console.WriteLine($"dense={denseMs} ms");
        Console.WriteLine($"sampled={sampledMs} ms");
        Console.WriteLine($"denseFile={densePath}");
        Console.WriteLine($"sampledFile={sampledPath}");
    }

    static long WriteLogs(string path, int count, int sampleEvery)
    {
        var stopwatch = Stopwatch.StartNew();

        // 使用较大的缓冲区,避免把测试变成“每行强制刷盘”的极端场景。
        using var writer = new StreamWriter(path, false, Encoding.UTF8, 64 * 1024);
        for (int i = 0; i < count; i++)
        {
            if (i % sampleEvery != 0)
                continue;

            // 高频字符串格式化与写入都会累计成本。
            writer.WriteLine($"frame={i} position=({i % 100},{i % 60}) state=Running");
        }

        stopwatch.Stop();
        return stopwatch.ElapsedMilliseconds;
    }
}

预期输出

text
dense=<TIME> ms
sampled=<TIME> ms
denseFile=<PATH>
sampledFile=<PATH>

<TIME> 与 <PATH> 会因机器和系统临时目录不同而变化。重点不是某个固定毫秒数,而是比较两种策略的调用次数、文件大小和耗时差异。真实游戏还应结合 Profiler、帧时间以及 GC 指标一起观察。

高开销日志通常长什么样

最危险的不是偶尔出现的错误日志,而是位于热点路径中的普通调试信息。例如每帧打印玩家坐标、遍历上千个实体时输出状态、每个网络包都打印完整载荷,都会把原本很小的单次成本乘以巨大的调用次数。

另一个常见问题是“日志级别关闭了,但昂贵参数已经算完”。如果日志框架不能延迟格式化,那么在调用前应先判断级别,避免为了最终不会输出的日志构造大型字符串、序列化 JSON 或拼接集合内容。

低开销诊断策略

生产客户端更适合把日志设计成分层诊断能力。错误和关键状态转换可以直接记录;高频事件优先使用采样,例如每 100 次记录一次;重复事件可以聚合成“过去 10 秒发生 438 次”,而不是写 438 行相同内容。

写文件时应优先使用缓冲和后台线程,让游戏主线程只完成轻量入队。队列本身还需要容量上限:磁盘过慢时宁可丢弃低优先级调试日志并记录丢弃计数,也不要让无限增长的日志队列消耗内存。

对于必须调查的短时性能现场,可以临时提高某个模块的日志级别,并设置持续时间或数量上限。这样既能获得足够细节,又不会让长期运行的详细日志反过来改变原本要观察的性能行为。

判断日志是否值得优化时,最终应看它是否进入热点路径、是否制造明显分配、是否造成锁等待或 I/O 阻塞,以及关闭或采样后帧时间是否改善。日志本身不是问题,无限制地在高频路径记录才是问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

日志本身会不会拖慢游戏

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通