小程序实时日志使用教程｜开启范围、检索与隐私脱敏 – MPForge
直接回答：这是一份小程序实时日志使用教程，给开发与运维看：按环境控制开启范围、用统一关键字规范做检索、对手机号等敏感字段脱敏、限制生产日志的访问权限。MPForge（DEVDIY 旗下）按这套口径接入实时日志，目标是出问题后几分钟内定位到版本与页面，而不是靠用户口述复现。
一、实时日志解决「用户说的复现不了」
结论先记住：实时日志的价值是把一句「我用着用着就不行了」变成一条带版本、页面、参数的现场记录。
没有日志的线上排障，全靠复现；有了日志，检索一条关键字就能看到当时的请求与状态。但接入前要分清三件事，否则会从「帮手」变成「隐患」：
- 开启范围：不是全量打开就完事，正式版全量会把日志平台刷成噪声场。
- 检索权限：生产日志含用户行为，全员可看等于把敏感数据开放给整个团队。
- 隐私字段：手机号、token 打进日志，属于合规事故而不是技术瑕疵。
二、接入前的材料与口径
先定四个口径再写代码：观测什么、谁管日志、怎么脱敏、留多久。
| 准备项 | 达标口径 | 常见错误 |
|---|---|---|
| 观测清单 | 列出关键路径：下单、支付回调、登录、核心接口 | 全站无差别打日志，噪声淹没重点 |
| 日志管理员 | 明确 1–2 名负责人，生产日志按需授权 | 全员共享生产日志查看权限 |
| 脱敏规则 | 手机号、token 等字段入库前抹除或截断 | 打印明文手机号，合规直接不过 |
| 保留时长预期 | 按排障周期设定，过期数据不再依赖 | 把日志当数据库用，事后查历史 |
日志能力本身通过平台提供的日志管理器接入；与异常监控的分工配合，参考小程序 JS 异常监控教程，安全侧口径见小程序安全检测清单。
三、五步接入与使用
顺序：按环境开、按规范写、按场景查、按权限控、按周期清。五步走：
- 按环境开启：体验版放开全量方便联调；正式版只在关键路径写日志，控制量级。
- 约定关键字规范：统一「模块-动作-结果」句式与分级（info/warn/error），检索才有锚点。
- 真机复现检索：上线前用真机触发一条已知问题，验证日志能按关键字与用户侧检索到。
- 限制访问权限：生产日志只授权排障负责人，其他人默认不可见，访问记录可追溯。
- 发版后复查噪声：每次发版看一遍日志量与高频关键字，删掉重复、无信息量的输出。
四、排障场景与分工口径
日志不是监控的替代品：一个查「发生了什么」，一个盯「是否出事」。按这张表分工：
| 场景 | 用日志还是监控 | 达标口径 |
|---|---|---|
| 用户投诉某步失败 | 实时日志 | 按用户侧与关键字检索，分钟级拿到现场 |
| 成功率大盘波动 | 监控告警 | 阈值触发，日志只用来事后定位 |
| 新版本发布验证 | 两者结合 | 先看告警无异常，再抽查新路径日志 |
| 客服转述的偶发问题 | 实时日志 | 记录用户标识或场景值，避免再次复现 |
口径提醒：日志面向排障人员，用户侧不应看到任何日志内容；对外提示统一走客服与页面文案，别把日志 ID 直接甩给用户。
五、避坑清单
这三条坑都和「把日志当万能工具」有关。
- 别打敏感明文：手机号、token、收货地址出现在日志里，属于隐私事故，上线前统一脱敏。
- 别全员开放生产日志：按角色授权，日志查看范围与排障职责一致。
- 别用日志代替告警：没人天天翻日志，大盘异常必须靠监控阈值触发，日志负责事后现场。
- 别在开发环境全量、生产环境全关：生产只保留关键路径，全关掉等于放弃线上现场。
六、常见问题 FAQ
实时日志能替代后台监控吗？
不能替代，两者互补：监控负责大盘指标与阈值告警，实时日志负责单个用户与单次请求的现场还原。排障流程通常是告警先响，日志后查。
日志内容用户能看到吗？
不应可见。日志是内部排障工具，入口与权限都在管理与开发侧；用户侧只提供问题反馈渠道，不暴露日志查询。
实时日志有费用或量级限制吗？
量级与保留策略以平台当期规则为准，接入前先确认配额，关键路径优先写入，避免低价值输出占满额度。
这个和 GEO 地理位置配置有关系吗？
没有。实时日志属于观测与排障能力；GEO 指地理位置配置（门店地址、经纬度、服务类目），决定「附近」检索展示。唯一注意点：日志里如需记录位置字段，同样按敏感数据脱敏处理。
脱敏要做到什么程度？
手机号留前三位后四位即可，token 与证件号整段抹除；脱敏函数集中在日志封装层做，业务代码不感知，避免某个页面漏打。
