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

怎样控制日志体积与敏感信息

怎样控制日志体积与敏感信息

生产日志不能靠“全部打开”换取可诊断性。客户端还要面对磁盘、上传流量、性能与隐私限制。本节给出一套可落地的边界:用级别控制默认噪声,用采样压缩高频事件,用轮转限制总量,并在日志写出前完成脱敏。

学习目标

  • 为生产环境划分合理的日志级别与保留边界
  • 理解采样、轮转和容量上限分别解决什么问题
  • 在日志写出前识别并遮盖常见敏感字段

先建立生产日志预算

生产日志的目标不是记录所有细节,而是在故障发生时保留足够证据。建议先给客户端定义明确预算,再决定哪些日志可以进入生产包。

可以把策略拆成四层:

控制点 主要目的 典型做法
日志级别 限制默认噪声 生产默认保留 INFO、WARN、ERROR
采样 压缩高频重复事件 对心跳、帧统计、重复成功日志按比例保留
轮转 限制单文件大小 文件达到阈值后切换新文件
总量上限 防止长期占满磁盘 只保留最近若干文件或限定总容量

DEBUG 和 TRACE 适合临时诊断,不应默认长期启用。错误堆栈、关键状态迁移和失败请求应优先保留,因为它们对定位问题的价值远高于重复成功日志。

生产日志从产生到落盘的控制链

对高频日志做确定性采样

采样应优先作用于“高频且重复”的成功事件,而不是错误日志。客户端还应尽量使用确定性规则,让同一事件在多次判断时得到一致结果,避免因为随机数导致一次操作中的日志忽多忽少。

下面的 Java 示例按事件 ID 的哈希值决定是否保留普通信息日志,同时始终保留错误日志:

java
public class LogSamplingDemo {
    static boolean keepInfo(String eventId, int percent) {
        if (percent <= 0) {
            return false;
        }
        if (percent >= 100) {
            return true;
        }
        int bucket = Math.floorMod(eventId.hashCode(), 100);
        return bucket < percent;
    }

    static void logInfo(String eventId, String message, int percent) {
        if (keepInfo(eventId, percent)) {
            System.out.println("INFO eventId=" + eventId + " " + message);
        }
    }

    static void logError(String eventId, String message) {
        System.out.println("ERROR eventId=" + eventId + " " + message);
    }

    public static void main(String[] args) {
        logInfo("evt-fixed", "heartbeat ok", 100);
        logError("evt-fixed", "asset load failed");
    }
}

预期输出:

text
INFO eventId=evt-fixed heartbeat ok
ERROR eventId=evt-fixed asset load failed

示例把采样率设为 100 只是为了得到确定输出。生产中可以对高频成功事件设置更低比例,但 ERROR 不应走同一采样通道,否则最需要的故障证据可能被丢弃。

在写出前完成脱敏

脱敏必须发生在日志进入文件、上传队列或远程采集 SDK 之前。不要先写原文再依赖服务器清洗,因为原始敏感信息已经落到了客户端磁盘或传输链路中。

常见需要处理的内容包括访问令牌、手机号、邮箱、身份证件、支付标识以及聊天文本中的隐私字段。更推荐“字段级日志”而不是整段序列化用户对象,这样可以从源头减少泄露面。

下面示例演示对手机号和邮箱做最小遮盖:

java
public class LogMaskingDemo {
    static String maskPhone(String phone) {
        if (phone == null || phone.length() < 7) {
            return "***";
        }
        return phone.substring(0, 3) + "****" + phone.substring(phone.length() - 4);
    }

    static String maskEmail(String email) {
        if (email == null) {
            return "***";
        }
        int at = email.indexOf('@');
        if (at <= 1) {
            return "***";
        }
        return email.substring(0, 2) + "***" + email.substring(at);
    }

    public static void main(String[] args) {
        System.out.println(maskPhone("13812345678"));
        System.out.println(maskEmail("player@example.com"));
    }
}

预期输出:

text
138****5678
pl***@example.com

对于访问令牌、会话密钥和密码,不建议“部分展示”,而应直接省略或替换成固定占位值。任何可能用于认证的秘密信息都不应依赖脱敏后继续保留。

用轮转和保留策略限制磁盘占用

轮转解决的是“单文件持续增长”,保留策略解决的是“很多旧文件累计占满磁盘”,两者不能互相替代。可以按客户端环境设定单文件上限、文件数量上限和上传成功后的清理策略。

例如目标是最多保留 5 个文件、每个不超过 10 MB,那么理论上日志目录的文件数据规模应控制在约 50 MB 以内,实际还应预留索引、压缩和临时文件空间。具体阈值应通过真机压测决定,而不是照搬桌面端或服务器配置。

验证生产策略时至少检查三件事:

  1. 连续制造高频日志,确认采样后写入速率明显下降。
  2. 人工触发轮转阈值,确认旧文件按预期被替换或删除。
  3. 搜索手机号、邮箱、令牌前缀等测试数据,确认落盘文件中没有原始敏感值。

生产日志的边界应该是“错误证据优先、重复成功可降采样、文件总量有上限、敏感信息不落盘”。做到这四点,才能同时保证诊断价值、客户端性能和隐私安全。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎样控制日志体积与敏感信息

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

登录哪都通