通过


使用引用字符串排查 4xx 和 5xx 错误

概要

本文提供了有关如何了解和使用参考字符串来诊断和解决Azure Front Door问题的指南。

先决条件

什么是引用字符串?

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

参考字符串可以帮助你排查和解决与 Azure Front Door 相关的问题,例如缓存未命中的情况、后端故障和延迟问题。 可以通过分析请求的引用字符串来确定根本原因并采取适当的措施来修复它。

注释

如果遇到来自 Microsoft 服务的错误页,此错误页已经包含生成该错误页的请求的引用字符串。 在这种情况下,可以直接跳到诊断步骤。

如何收集引用字符串

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

  1. 按下 或 打开浏览器的开发人员工具。

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

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

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

  5. 复制 X-Azure-Ref 标头的值,以便与 Azure 门户中的引用字符串故障排除工具一起使用。

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

如何从 Microsoft Edge 浏览器获取引用字符串的示例:

在 Microsoft Edge 浏览器中显示 RefString 示例的截图。

如何将引用字符串用于我们的一些故障排除工具

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

  1. 访问 Azure Front Door 配置文件。

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

    显示使用引用字符串诊断问题的第一步的屏幕截图。

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

    显示使用引用字符串诊断问题的第二步的屏幕截图。

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

    显示使用引用字符串诊断问题的第三步的屏幕截图。

  5. 在 4xx 和 5xx 错误 部分的框中输入您的参考字符串。 在 “跟踪引用 - RefString ”字段下,输入请求中提供的引用字符串。

    显示使用引用字符串诊断问题的第四步的屏幕截图。

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

    显示问题的结果示例:

    屏幕截图显示了使用引用字符串进行诊断的实例。

    注释

    诊断功能可能需要长达 15 分钟才能提供结果。 我们请求您耐心等待, 直到该过程完成,然后再采取进一步行动。

备用选项

如果选择不使用诊断工具,则可以在提交支持票证时包含引用字符串。 此外,还可以启用 Access Logs 功能,以直接在 Azure 门户中接收 RefString 数据的更新。

有关跟踪引用和访问日志参数的详细信息,请参阅 Azure Front Door 中的Monitor 指标和日志,其中突出显示了访问日志中有助于识别各种类型的错误的特定字段。

后续步骤

  • 若要详细了解如何解决常见问题,请参阅 Front Door 故障排除。
  • 有关常见问题的解答,请参阅 Azure Front Door FAQ