发布时间: 2026年11月19日更新时间: 2026年11月19日

移动端代理问题需要收集哪些日志信息

代理 IP 排障日志的价值在于别人能否按同一条件复现。按必须、可选、禁止三档收字段,导出前删掉凭据与个人标识,再按时间和设备命名打包,缺一项就补一项。

排障日志的价值不在多,而在"别人能不能按同一条件复现"。手机端尤其容易丢信息:系统日志滚动快、应用日志分散,连接记录也可能包含账号标识或认证信息,导出前应先检查并脱敏。

先按"必须、可选、禁止"列出字段,收集后检查敏感信息,再按时间和设备命名打包。这样既方便排查,也能减少凭据或个人信息外泄。

移动端代理故障日志需要记录哪些关键信息

最小记录集合应包含:时间(含时区)、网络类型、目标地址与协议、错误类型或状态码、出口地区、客户端版本、设备与系统版本、失败阶段、观察来源、复现步骤,以及事件/请求关联 ID;没有服务端 ID 时可用受控的 caseID。出口保留地区和同一审查范围内稳定化名,不要求公开真实 IP。若错误表现为连接重置,可参照代理连接被重置要记录哪些证据补齐时间、错误码和链路记录。

时间和时区用于对齐事件,网络类型用于区分蜂窝与 Wi-Fi,目标地址和错误信息有助判断影响范围,复现步骤则决定接手人员能否重现现场。缺少关键字段会增加排查难度;暂时无法提供时,应标明缺失项,而不是用猜测补齐。

这些字段里最容易被忽略的是“出口地区”。同样一条失败记录,出口在国内和出口在新加坡,指向的原因完全不同。记录时写地区即可,不需要写完整 IP。

哪些日志字段有助排查,哪些信息必须删除或脱敏

档位字段来源说明
必须时间与时区、网络类型、目标域名与协议、错误码或错误类型、出口地区或稳定化名、客户端与 App 构建版本、设备与系统版本、失败阶段、观察来源、事件/请求关联 ID(无服务端 ID 时用受控 caseID)、复现步骤系统设置、客户端、目标站回显网络类型只列一次;记录是否发生切换,发生时填写时间,未发生或未知也明确标出
可选信号强度、应用前后台状态、同一时段另一台设备的对照结果系统状态、现场观察按问题类型取舍;网络切换事件统一记在必填项中
禁止Cookie、Authorization、完整查询串、手机号与邮箱、设备唯一标识、精确位置应用日志、请求记录导出前必须删除或替换

必填项应按表格逐项记录,其中“复现步骤”常被漏掉,却是他人还原问题的重要依据。

分档的意义是防止两种极端:一种是只发一句"连不上",另一种是把整个日志包原样发出去。前者无法排查,后者泄露风险。

可选字段按问题类型补充:怀疑网络切换时,记录切换时间;怀疑后台限制时,补充应用前后台状态。

导出日志前,先删除或遮盖这六类敏感信息

导出前重点检查六类信息:

  • 认证凭据:Cookie、Authorization 头、API Key 和客户端令牌,泄露后可能被用于访问账号。
  • 完整查询串:保留必要路径,去掉参数中的会话 ID、用户 ID 和签名,凭据和身份值应删除或用稳定占位符替代;经核对不敏感且有助复现的排序、分页和地区参数值可以保留。不能共享真实值时,提供等价虚构示例并标明替代关系。
  • 个人标识:手机号、邮箱、姓名和身份证件号。
  • 设备唯一标识:广告标识、硬件序列号和安装 ID。
  • 精确位置:经纬度和详细地址;通常只需保留城市或地区。
  • 业务敏感数据:订单内容、聊天记录和上传文件内容;排障通常只需要记录请求类型,不需要保留具体内容。

替换方式要统一:用 [REDACTED] 或 *** 替换凭据与身份值,不保留原值长度等可能暴露特征的信息;同时保留经核对不敏感、复现所必需的排序、分页和地区参数。无法共享真实参数时,提供等价虚构示例并说明替代关系。也不要整段删除,否则看不出请求结构。日志该记录什么、不该记录什么,可对照 OWASP 日志记录速查表。

如何命名和打包日志,方便按时间定位问题

一个包只放一次复现:时间范围、设备、版本写在文件名里,例如"时间范围-设备型号-系统版本-问题类型"。包内附一份清单,说明每个文件对应哪一段操作。整理完成后,可按代理网络故障如何制作最小复现记录检查现场是否可复现。

不要把几天的日志混在一个包里。时间跨度越大,定位越慢,也越容易把无关的账号信息带进去。

文件格式优先用原始文本或结构化导出,不要只发截图。截图可以作为补充,但不能替代原始记录——时间精度和字段完整性都会丢。

如果必须发截图,先检查状态栏、通知、账号头像、地址栏这些位置,它们经常带着身份信息。

提交日志前,用五个问题检查材料是否完整

  1. 别人拿着这份日志,能不能按写下的步骤复现一次?
  2. 时间是否带时区,是否与目标站记录能对上?
  3. 有没有哪一处还能看出账号、令牌或个人信息?
  4. 目标地址是否保留了域名和协议,去掉了敏感参数?
  5. 失败前后是否各留了一段观察窗口,而不是只有一条错误?

五个问题里有一个答不上来,就先补齐再提交。补齐的成本,通常比来回追问低。

常见问题

代理 IP 的日志可以整包发给支持方吗?

不建议。按时间窗截取,附本机时间与时区;整包既慢又扩大泄露面。

截图里哪些信息必须打码?

头像、昵称、手机号、通知内容、地址栏参数、设备名称都要打码。只提供定位问题所需的最少信息。

代理 IP 的主机和端口要不要一起提供?

默认先脱敏。确有排查需要时,只通过受控支持渠道按需提供,并限定访问范围与保留期限;账号、密码、令牌、签名及其他可用于认证的凭据必须遮盖。

时间用本地时区还是 UTC?

都行,写明是哪一个并全篇统一。与目标站记录对照时换算到同一时区。

工单里要不要附完整日志包?

先附最小复现包和清单,对方要哪段再补。一次给全反而难定位。

账号与接入问题可查看帮助中心。