移动端代理问题需要收集哪些日志信息
代理 IP 排障日志的价值在于别人能否按同一条件复现。按必须、可选、禁止三档收字段,导出前删掉凭据与个人标识,再按时间和设备命名打包,缺一项就补一项。
排障日志的价值不在多,而在"别人能不能按同一条件复现"。手机端尤其容易丢信息:系统日志滚动快、应用日志分散,连接记录也可能包含账号标识或认证信息,导出前应先检查并脱敏。
先按"必须、可选、禁止"列出字段,收集后检查敏感信息,再按时间和设备命名打包。这样既方便排查,也能减少凭据或个人信息外泄。
移动端代理故障日志需要记录哪些关键信息
最小记录集合应包含:时间(含时区)、网络类型、目标地址与协议、错误类型或状态码、出口地区、客户端版本、设备与系统版本、失败阶段、观察来源、复现步骤,以及事件/请求关联 ID;没有服务端 ID 时可用受控的 caseID。出口保留地区和同一审查范围内稳定化名,不要求公开真实 IP。若错误表现为连接重置,可参照代理连接被重置要记录哪些证据补齐时间、错误码和链路记录。
时间和时区用于对齐事件,网络类型用于区分蜂窝与 Wi-Fi,目标地址和错误信息有助判断影响范围,复现步骤则决定接手人员能否重现现场。缺少关键字段会增加排查难度;暂时无法提供时,应标明缺失项,而不是用猜测补齐。
这些字段里最容易被忽略的是“出口地区”。同样一条失败记录,出口在国内和出口在新加坡,指向的原因完全不同。记录时写地区即可,不需要写完整 IP。
哪些日志字段有助排查,哪些信息必须删除或脱敏
| 档位 | 字段 | 来源 | 说明 |
|---|---|---|---|
| 必须 | 时间与时区、网络类型、目标域名与协议、错误码或错误类型、出口地区或稳定化名、客户端与 App 构建版本、设备与系统版本、失败阶段、观察来源、事件/请求关联 ID(无服务端 ID 时用受控 caseID)、复现步骤 | 系统设置、客户端、目标站回显 | 网络类型只列一次;记录是否发生切换,发生时填写时间,未发生或未知也明确标出 |
| 可选 | 信号强度、应用前后台状态、同一时段另一台设备的对照结果 | 系统状态、现场观察 | 按问题类型取舍;网络切换事件统一记在必填项中 |
| 禁止 | Cookie、Authorization、完整查询串、手机号与邮箱、设备唯一标识、精确位置 | 应用日志、请求记录 | 导出前必须删除或替换 |
必填项应按表格逐项记录,其中“复现步骤”常被漏掉,却是他人还原问题的重要依据。
分档的意义是防止两种极端:一种是只发一句"连不上",另一种是把整个日志包原样发出去。前者无法排查,后者泄露风险。
可选字段按问题类型补充:怀疑网络切换时,记录切换时间;怀疑后台限制时,补充应用前后台状态。
导出日志前,先删除或遮盖这六类敏感信息
导出前重点检查六类信息:
- 认证凭据:Cookie、Authorization 头、API Key 和客户端令牌,泄露后可能被用于访问账号。
- 完整查询串:保留必要路径,去掉参数中的会话 ID、用户 ID 和签名,凭据和身份值应删除或用稳定占位符替代;经核对不敏感且有助复现的排序、分页和地区参数值可以保留。不能共享真实值时,提供等价虚构示例并标明替代关系。
- 个人标识:手机号、邮箱、姓名和身份证件号。
- 设备唯一标识:广告标识、硬件序列号和安装 ID。
- 精确位置:经纬度和详细地址;通常只需保留城市或地区。
- 业务敏感数据:订单内容、聊天记录和上传文件内容;排障通常只需要记录请求类型,不需要保留具体内容。
替换方式要统一:用 [REDACTED] 或 *** 替换凭据与身份值,不保留原值长度等可能暴露特征的信息;同时保留经核对不敏感、复现所必需的排序、分页和地区参数。无法共享真实参数时,提供等价虚构示例并说明替代关系。也不要整段删除,否则看不出请求结构。日志该记录什么、不该记录什么,可对照 OWASP 日志记录速查表。
如何命名和打包日志,方便按时间定位问题
一个包只放一次复现:时间范围、设备、版本写在文件名里,例如"时间范围-设备型号-系统版本-问题类型"。包内附一份清单,说明每个文件对应哪一段操作。整理完成后,可按代理网络故障如何制作最小复现记录检查现场是否可复现。
不要把几天的日志混在一个包里。时间跨度越大,定位越慢,也越容易把无关的账号信息带进去。
文件格式优先用原始文本或结构化导出,不要只发截图。截图可以作为补充,但不能替代原始记录——时间精度和字段完整性都会丢。
如果必须发截图,先检查状态栏、通知、账号头像、地址栏这些位置,它们经常带着身份信息。
提交日志前,用五个问题检查材料是否完整
- 别人拿着这份日志,能不能按写下的步骤复现一次?
- 时间是否带时区,是否与目标站记录能对上?
- 有没有哪一处还能看出账号、令牌或个人信息?
- 目标地址是否保留了域名和协议,去掉了敏感参数?
- 失败前后是否各留了一段观察窗口,而不是只有一条错误?
五个问题里有一个答不上来,就先补齐再提交。补齐的成本,通常比来回追问低。
常见问题
代理 IP 的日志可以整包发给支持方吗?
不建议。按时间窗截取,附本机时间与时区;整包既慢又扩大泄露面。
截图里哪些信息必须打码?
头像、昵称、手机号、通知内容、地址栏参数、设备名称都要打码。只提供定位问题所需的最少信息。
代理 IP 的主机和端口要不要一起提供?
默认先脱敏。确有排查需要时,只通过受控支持渠道按需提供,并限定访问范围与保留期限;账号、密码、令牌、签名及其他可用于认证的凭据必须遮盖。
时间用本地时区还是 UTC?
都行,写明是哪一个并全篇统一。与目标站记录对照时换算到同一时区。
工单里要不要附完整日志包?
先附最小复现包和清单,对方要哪段再补。一次给全反而难定位。
账号与接入问题可查看帮助中心。
