你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 RefString 排查 4xx 和 5xx 错误

有关了解和使用 RefStrings 诊断和解决 Azure Front Door 问题的指南。

先决条件

什么是 RefString?

RefString 也称为引用字符串,是由 Azure Front Door 追加到每个请求的 HTTP 响应头的短字符串。 它提供有关请求的处理方式的详细信息,包括状态点 (POP) 和后端状态。

RefString 可帮助排查和解决 Azure Front Door 的问题,例如缓存未命中、路由错误、后端故障和延迟问题。 可以通过分析请求的 RefString 来确定根本原因并采取适当的措施来修复它。

备注

如果遇到了 Microsoft 服务的错误页,则它已包含生成错误页的请求的 RefString。 在这种情况下,可以直接跳到诊断步骤。

如何收集 RefString

若要收集 RefString,需要捕获请求的 HTTP 响应头,并查找名为 X-Azure-Ref 的标头。此标头包含以 Base64 编码的 RefString。 可以使用不同的方法来捕获 HTTP 响应头,具体取决于你的偏好和情况。 下面是关于如何从 Microsoft Edge 浏览器获取 RefString 的示例:

  1. F12Ctrl+Shift+I 打开浏览器的开发人员工具。

  2. 转到“网络”选项卡。

  3. 刷新页面或执行触发请求的操作。

  4. 在列表中找到特定请求,并在响应头部分找到 X-Azure-Ref 标头。

  5. 复制 X-Azure-Ref 标头的值,以便用于 Azure 门户中的 RefString 故障排除工具。

有关详细信息,请参阅检查网络活动 - Microsoft Edge 开发人员文档

关于如何从 Microsoft Edge 浏览器获取 RefString 的示例:

Microsoft Edge 浏览器中 RefString 示例的屏幕截图。

如何将 RefString 用于某些故障排除工具

Azure Front Door 使用 RefString 来管理 4xx 和 5xx 错误。 以下是将诊断工具与 RefString 配合使用以跟踪和诊断连接问题的步骤:

  1. 导航到你的 Azure Front Door 配置文件。

  2. 选择“诊断和解决问题”菜单。

    显示使用 RefString 诊断问题的第一步的屏幕截图。

  3. 向下滚动并选择“常见问题”部分下的“连接”。

    显示使用 RefString 诊断问题的第二步的屏幕截图。

  4. 在“你遇到了什么问题?”框中,选择“选择问题子类型”,然后在下拉菜单中选择“4xx 和 5xx 错误”,然后选择“下一步”。

    显示使用 RefString 诊断问题的第三步的屏幕截图。

  5. 在“4xx 和 5xx 错误”部分中的框中输入你的 RefString。 在“跟踪引用 - RefString”字段下,输入通过请求给你的 Restring。

    显示使用 RefString 诊断问题的第四步的屏幕截图。

  6. 最后,选择“运行诊断”以识别问题的原因,它会对故障进行解释(如果是已知问题)。

    显示问题的结果示例:

    显示使用 RefString 进行诊断的实际示例的屏幕截图。

    备注

    诊断功能可能需要最多 15 分钟来提供结果。 请耐心等待该过程完成,然后再采取进一步的行动。

备用选项

如果选择不使用诊断工具,则可以在提交支持工单时加入 RefString。 此外,还可以启用“访问日志”功能,以直接在 Azure 门户中接收 RefString 数据的更新。

有关如何跟踪引用和访问日志参数的详细信息,请参阅监视 Azure Front Door 中的指标和日志,其中重点介绍了访问日志中有助于识别各种错误类型的特定字段。

后续步骤