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

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

有关了解和使用引用字符串诊断和解决 Azure Front Door 问题的指南。

先决条件

什么是引用字符串?

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

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

注意

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

如何收集引用字符串

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

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

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

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

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

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

有关详细信息,请参阅检查网络活动 - 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 分钟来提供结果。 请耐心等待该过程完成,然后再采取进一步的行动。

备用选项

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

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

后续步骤