
代理支持工单常因两种情况停滞:报告只写“代理很慢”,或者直接附上暴露凭据、Cookie、客户数据和无关流量的原始日志。前者无法定位,后者会制造新的安全事件。
高质量证据包应规模小、可复现、有明确时间范围,并指出失败发生在哪个阶段。它要让供应商能够关联同一路线,同时把认证信息和业务载荷排除在工单之外。
先写一句可验证的事件描述
使用中性句式:在精确 UTC 窗口内,产品 P、地区 R 的获授权请求在阶段 S 的终态失败率高于约定基线,而控制线路仍处于正常范围。
证据不足时不要先下原因结论。“出口容量耗尽”是推测,“32% 请求在 CONNECT 后超时”才是观察结果。
限定最小必要范围
记录:
- 住宅、ISP、数据中心、轮换或静态代理产品;
- 国家、地区、城市、ASN 或运营商选择条件;
- 代理协议与规范化端点标签;
- 会话模式和轮换规则;
- 测试目标类型,而非机密目标数据;
- UTC 开始与结束时间;
- 样本量与并发;
- 客户端、运行时和 TLS 库版本;
- 问题影响所有节点还是单一环境。
不要把多个产品、国家和应用版本混进一张工单。相互独立的失败模式应分别处理。
标记第一个失败阶段
“请求失败”过于宽泛,应标记第一个没有达到预期的阶段:
- 代理端点 DNS 解析;
- 到代理的 TCP 连接;
- 与 HTTPS 代理的 TLS 握手;
- 代理认证,包括 407;
- CONNECT 隧道建立;
- 目标 TLS 握手;
- HTTP 响应头;
- 响应正文传输;
- 返回结果的业务验证。
这样可避免把目标限流报成代理认证故障,或把解析器错误当作线路问题。若首个失败阶段为认证,可参考代理认证 407 排错指南。
建立有限且可复现的样本
使用获授权测试端点和受控请求,把速率与并发控制在不会扭曲服务的范围。
- 根据基线稳定性运行 20 至 100 次。
- 固定配置和请求形状。
- 为每次尝试分配唯一关联 ID。
- 包含控制线路或上一已知正常版本。
- 原始测量轮次关闭自动重试。
- 必要时再按生产重试策略运行第二轮。
间歇性问题应使用多个短窗口,而非一次无控制突发。保留精确 UTC 区间,方便供应商关联网关和上游日志。
每行保留最小有用字段
脱敏证据行应包含关联 ID、毫秒级 UTC 时间、产品与端点标签、请求地区、会话模式、客户端版本、尝试序号、失败阶段、客户端结果码、可用时的 HTTP 状态、连接与总延迟、收发字节数、新建或复用连接、必要时哈希或截断的出口标识,以及最终验证结果。
绝不能包含代理用户名、密码、认证头、原始 Cookie、令牌、会话令牌、私钥或完整代理 URL。
脱敏不能破坏诊断价值
脱敏应保持确定性。同一敏感值在同一案件内替换为相同标签,以保留重复行为。
- 实际代理用户名替换为中性案件标签。
- 不需要完整 IP 时使用带密钥哈希或约定前缀。
- 商业敏感目标替换为目标类型标签。
- 查询参数值和请求正文非必要时全部移除。
- Cookie 与认证头完整删除。
附件至少审查两次:先自动扫描 URL、头部、令牌、邮箱、Cookie 与私钥标记,再由理解工作负载和支持受众的人员手工检查。
用统计分布代替截图
一张超时截图证据很弱。应附上终态成功率、按阶段和代码统计的失败、连接与总延迟 p50/p95、重试放大、地区匹配率、粘性会话存活率和控制线路对比。407、429 和 5xx 必须分开统计。
不要把不同性质的错误平均成一个“可用率”。大响应传输慢与 TCP 连接失败不可直接合并。
明确要求供应商做什么
工单结尾提出一个具体诉求:
- 用网关日志关联所给请求 ID;
- 判断 UTC 窗口内是否发生容量或路由事件;
- 解释认证策略变化;
- 确认正式轮换语义;
- 判断 SLA 分类;
- 提供缓解后的安全复测窗口。
目标是得到可验证的下一步,而不是笼统要求“修好全部问题”。
后续沟通也不能发送凭据
若支持人员要求真实用户名、密码、Cookie 或完整代理 URL,不要直接粘贴到聊天、邮件、截图或工单评论。应使用供应商批准的安全流程,并优先创建权限受限的临时测试凭据。
如果凭据可能泄露,应立即轮换并使相关会话失效。可按代理凭据轮换执行受控处置。
推荐证据包顺序
- 一句话事件描述;
- 不含个人数据的业务影响;
- 产品、地区、会话和 UTC 范围;
- 客户端与环境版本;
- 复现步骤;
- 汇总结果表;
- 脱敏样本行;
- 预期与实际行为;
- 控制线路结果;
- 请求供应商采取的动作;
- 附件保留与删除日期。
原始抓包应保存在受控内部存储中,工单只包含经过缩减和复核的证据包。
验证供应商处理结果
不能因为支持回复“已解决”就关闭事件。应使用相同阈值重复同一有限测试,比较相同指标并记录新的 UTC 窗口。
涉及故障切换时可执行代理故障转移恢复演练;需要合同级判断时结合代理 SLA 验证。
发送前检查清单
- 事件描述中性且可观察。
- 所有时间使用 UTC,并给出精确窗口。
- 已说明产品、地区、会话策略、样本量和并发。
- 已按阶段和代码分类失败。
- 包含控制线路或已知正常基线。
- 重试与首次尝试结果分开。
- 不含凭据、Cookie、令牌、个人数据和完整代理 URL。
- 附件通过自动与人工复核。
- 供应商动作请求具体明确。
- 已设定附件保留和删除日期。
常见问题
应该附完整 HAR 文件吗?
通常不应。HAR 常含 Cookie、认证头、查询参数和响应正文。只导出必要字段,并在脱敏和复核后提交。
应发送多少条失败请求?
发送有代表性的有限样本和汇总计数。缺少阶段、时间和配置范围时,增加原始行数也没有帮助。
是否应包含出口 IP?
仅在必要且允许时包含。优先使用案件内哈希、截断形式或供应商请求 ID。
可以发送真实代理 URL 吗?
不要在普通工单中放凭据。通过获批安全流程传递权限受限的测试凭据,调查结束后立即撤销。
合规说明
只能从获授权系统和流量中收集证据。请遵守隐私法律、合同、数据最小化要求、保留期限和供应商支持规则。证据包不得包含无关用户数据或任何秘密。