游戏客户端架构 / 系统课时
怎样控制日志体积与敏感信息
怎样控制日志体积与敏感信息
生产日志不能靠“全部打开”换取可诊断性。客户端还要面对磁盘、上传流量、性能与隐私限制。本节给出一套可落地的边界:用级别控制默认噪声,用采样压缩高频事件,用轮转限制总量,并在日志写出前完成脱敏。
学习目标
- 为生产环境划分合理的日志级别与保留边界
- 理解采样、轮转和容量上限分别解决什么问题
- 在日志写出前识别并遮盖常见敏感字段
先建立生产日志预算
生产日志的目标不是记录所有细节,而是在故障发生时保留足够证据。建议先给客户端定义明确预算,再决定哪些日志可以进入生产包。
可以把策略拆成四层:
| 控制点 | 主要目的 | 典型做法 |
|---|---|---|
| 日志级别 | 限制默认噪声 | 生产默认保留 INFO、WARN、ERROR |
| 采样 | 压缩高频重复事件 | 对心跳、帧统计、重复成功日志按比例保留 |
| 轮转 | 限制单文件大小 | 文件达到阈值后切换新文件 |
| 总量上限 | 防止长期占满磁盘 | 只保留最近若干文件或限定总容量 |
DEBUG 和 TRACE 适合临时诊断,不应默认长期启用。错误堆栈、关键状态迁移和失败请求应优先保留,因为它们对定位问题的价值远高于重复成功日志。

对高频日志做确定性采样
采样应优先作用于“高频且重复”的成功事件,而不是错误日志。客户端还应尽量使用确定性规则,让同一事件在多次判断时得到一致结果,避免因为随机数导致一次操作中的日志忽多忽少。
下面的 Java 示例按事件 ID 的哈希值决定是否保留普通信息日志,同时始终保留错误日志:
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");
}
}预期输出:
INFO eventId=evt-fixed heartbeat ok
ERROR eventId=evt-fixed asset load failed示例把采样率设为 100 只是为了得到确定输出。生产中可以对高频成功事件设置更低比例,但 ERROR 不应走同一采样通道,否则最需要的故障证据可能被丢弃。
在写出前完成脱敏
脱敏必须发生在日志进入文件、上传队列或远程采集 SDK 之前。不要先写原文再依赖服务器清洗,因为原始敏感信息已经落到了客户端磁盘或传输链路中。
常见需要处理的内容包括访问令牌、手机号、邮箱、身份证件、支付标识以及聊天文本中的隐私字段。更推荐“字段级日志”而不是整段序列化用户对象,这样可以从源头减少泄露面。
下面示例演示对手机号和邮箱做最小遮盖:
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"));
}
}预期输出:
138****5678
pl***@example.com对于访问令牌、会话密钥和密码,不建议“部分展示”,而应直接省略或替换成固定占位值。任何可能用于认证的秘密信息都不应依赖脱敏后继续保留。
用轮转和保留策略限制磁盘占用
轮转解决的是“单文件持续增长”,保留策略解决的是“很多旧文件累计占满磁盘”,两者不能互相替代。可以按客户端环境设定单文件上限、文件数量上限和上传成功后的清理策略。
例如目标是最多保留 5 个文件、每个不超过 10 MB,那么理论上日志目录的文件数据规模应控制在约 50 MB 以内,实际还应预留索引、压缩和临时文件空间。具体阈值应通过真机压测决定,而不是照搬桌面端或服务器配置。
验证生产策略时至少检查三件事:
- 连续制造高频日志,确认采样后写入速率明显下降。
- 人工触发轮转阈值,确认旧文件按预期被替换或删除。
- 搜索手机号、邮箱、令牌前缀等测试数据,确认落盘文件中没有原始敏感值。
生产日志的边界应该是“错误证据优先、重复成功可降采样、文件总量有上限、敏感信息不落盘”。做到这四点,才能同时保证诊断价值、客户端性能和隐私安全。