You need to enable JavaScript to run this app.
导航
内容分发网络
  • 文档首页
    • /内容分发网络/用户指南/诊断工具/自助排障工具
自助排障工具
最近更新时间：2025.07.08 15:42:12首次发布时间：2025.07.08 15:42:12
我的收藏
有用
有用
无用
无用

火山引擎内容分发网络（CDN）自助排障工具是一款协助定位资源访问异常的工具。当用户反馈站点访问问题时，您可通过该工具进行问题诊断与排查，提升问题解决效率。

该工具通过客户端向资源 URL 发送诊断请求，采集并分析各指标数据，以识别 DNS 异常、客户端网络问题、CDN 节点故障、源站异常等常见问题，并提供详细的诊断报告。

诊断场景

该工具适用于以下场景：

  • 域名访问异常排查：当用户在访问您的站点页面时，遇到页面加载缓慢或访问错误等问题，您可以使用该工具定位问题。
  • 区域性访问问题分析：针对特定地区用户反馈的访问异常，您可以使用该工具分析区域网络和节点状况。
  • 域名健康状态检查：您可以使用该工具对站点资源的可访问性进行定期检查，以了解域名的 DNS 解析状况、站点资源的缓存状况、源站状况等。

使用须知

  • 诊断请求模拟真实的用户请求。因此，诊断请求产生的用量会被计费。
  • 对于诊断请求，如果请求文件尚未缓存，CDN 将不会缓存请求文件。
  • 如果诊断 URL 指向的文件大于 10MB，则诊断请求仅请求文件的前 10MB 分片。
  • 子账号也可以创建诊断任务。每个账号只能查看本账号创建的任务。主账号无法查看子账号创建的任务。
  • 每个账号每天最多只能创建 20 个诊断任务。

操作步骤

  1. 登录 火山引擎内容分发网络控制台。
  2. 在左侧导航栏，点击 诊断工具 > 自助排障工具。
  3. 在 自助排障工具 页面，点击 创建诊断任务。
    alt
  4. 在 创建诊断任务 页面，输入您要诊断的 URL，然后点击 确定。关于 URL 的输入要求，参见 下方说明。
    alt
  5. 任务创建后，在 操作 列，点击 分享诊断链接 以复制诊断链接至剪贴板。复制的内容样例如下：

感谢您协助我们进行网络诊断，请点击以下链接进入诊断页面：http://cdn-diagnose.volcbiz.com/static/diagnose?taskid=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

  1. 将内容中的链接分享给遇到访问异常的用户。
  2. 指导用户访问该链接，让用户在诊断页面中点击 开始诊断 并等待诊断完成。
    alt
  3. 在任务的 操作 列，点击 查看诊断报告。参见 诊断报告。

URL 输入要求

  • URL 中的主机名必须是域名并且域名不能是泛域名。
  • 必须以 http:// 或 https:// 开头。
  • 长度不超过 4,096 个字符。
  • 对于 URL 中的域名，该域名在 CDN 中的状态是 "正常运行"。
  • 匹配 CDN 支持的协议。例如，您的域名在 CDN 中尚未启用 HTTPS。在这个情况下，URL 只能以 http:// 开头。

诊断额度

  • 每个诊断任务有 20 次诊断额度。
  • 每个诊断任务的有效期是 24 小时。
  • 每次点击 开始诊断 后，只要诊断开始，无论诊断是否完成，都会消耗一个诊断额度。

在诊断任务列表中，您可以查看每个任务的状态以及诊断额度的消耗情况。任务列表中各字段的描述如下：

字段名称描述
任务 ID表示任务的 ID，格式是 UUID。
诊断 URL表示被诊断的 URL。

任务状态

表示诊断任务的状态。该字段有以下取值：

  • 生效中：表示诊断任务处于有效期内且诊断次数未用尽。
  • 已结束：诊断任务已过期或诊断次数已用尽。
正常诊断结果表示未发现问题的诊断次数。
异常诊断结果表示发现问题的诊断次数。
未完成诊断次数表示因请求超时、服务器繁忙等原因导致诊断未完成的次数。
剩余诊断次数表示该任务的剩余诊断次数。
创建时间表示任务的创建时间。
操作表示该任务可用的操作。如果任务状态是 已结束，分享诊断链接 这个操作会置灰。

诊断报告

对于一个诊断任务，您可以在 操作 列点击 查看诊断报告 打开 诊断报告 页面。

alt

诊断报告 页面以表格形式显示每次已完成诊断的基本信息。表格中各字段的描述如下。

字段描述
客户端 IP表示执行诊断的客户端 IP 地址、IP 地址的归属地以及归属的运营商。
操作系统表示客户端运行的操作系统，基于诊断请求中 User-Agent 头部识别。
浏览器表示客户端使用的浏览器，基于诊断请求中 User-Agent 头部识别。

诊断结果

表示诊断结果。该字段有以下取值：

  • 正常: 表示未发现问题。
  • 异常: 表示发现了问题。
诊断时间表示诊断的发起时间。
操作表示可用的操作。当前可用的操作是 查看详情。

诊断详情

在诊断报告中，您可以在 操作 列点击查看详情 查看某次诊断的详情。
alt

诊断详情 页面按模块展示相关的诊断详细信息。

基本信息

alt

该模块展示了诊断 URL、本次诊断的发起时间、以及诊断结果。

客户端信息

alt

该模块展示了发起诊断的客户端信息，包含以下信息。

字段描述
客户端IP表示执行诊断的客户端 IP 地址、IP 地址的归属地以及归属的运营商。
操作系统表示客户端运行的操作系统，基于诊断请求中 User-Agent 头部识别。
浏览器表示客户端使用的浏览器，基于诊断请求中 User-Agent 头部识别。
User-Agent表示诊断请求中的 User-Agent 请求头的值。
JavaScript 状态表示客户端浏览器是否启用了 JavaScript。
LocalStorage 状态表示客户端浏览器是否启用了 LocalStorage。
Cookie 状态表示客户端浏览器是否启用了 Cookies。
Flash 状态表示客户端浏览器是否启用了 Flash 插件。

DNS 信息

alt

该模块展示了 DNS 解析相关的信息。

字段名称描述
Local DNS表示客户端使用的 Local DNS 服务器的 IP 地址、服务器所在的地区以及相应的 DNS 服务提供商。
加速域名表示诊断 URL 中的域名。
CNAME表示加速域名的 CNAME。

网络链路信息

alt

该模块展示了请求处理相关的指标数据，包含以下信息。

字段名称描述
服务器处理请求耗时表示从 CDN 收到诊断请求的第一个字节到 CDN 完成响应最后一个字节之间的时间，单位是毫秒 (ms) 。该指标数据是在 CDN 节点统计的。
首字节时间（TTFB）表示从客户端发起诊断请求到收到 CDN 响应的第一个字节之间的时间，单位是毫秒（ms）。该指标数据是在客户端统计的。
总耗时表示从客户端发起诊断请求到收到 CDN 响应的最后一个字节之间的时间，单位是毫秒（ms）。该指标数据是在客户端统计的。
访问其他站点的成功率表示客户端访问一些热门站点小文件的成功率，精确到小数点后两位。如果客户端请求一个热门站点的总耗时超过 1 秒或者出现请求异常，该请求就被判定为失败。请求异常的情况包括请求超时或者响应状态码为 4xx 或 5xx 等。

CDN 节点信息

alt

该模块展示了处理诊断请求的 CDN 节点的信息。

字段名称描述
加速节点表示处理诊断的请求 CDN 节点的 IP 地址、IP 地址的归属地以及归属的运营商。
状态码表示 CDN 响应诊断请求的状态码。
命中状态表示该诊断请求是否命中 CDN 缓存。
文件大小表示请求文件的实际大小。页面会根据文件实际大小自动选择合适的单位（如 KB、MB、GB、TB 等）。
下载速度表示 CDN 响应诊断请求时的平均数据传输速度。页面会根据实际传输速度自动选择合适的单位（如 B/s、KB/s、MB/s 等）。

访问控制策略

该字段的说明如下：

  • 如果诊断请求由于匹配某个访问控制特性（例如下载限速、Referer 黑白名单、URL 鉴权等）的条件而被 CDN 阻止，则此字段显示该访问控制特性的名称。
  • 如果诊断请求没有匹配任何访问控制特性的条件，该字段值为 "未命中访问控制策略"。

缓存信息

alt

该模块展示了诊断请求的缓存相关信息。

字段描述
资源是否可缓存表示请求的文件是否会被 CDN 缓存，基于 节点缓存规则 的配置而判定。
缓存键如果请求的文件已被 CDN 缓存，该字段表示该文件的缓存键。缓存键受 缓存键值 配置的影响。
资源可缓存时长如果请求的文件已被 CDN 缓存，该字段表示文件的缓存时长，单位是秒（s）。缓存时长受 节点缓存规则 配置的影响。
资源首次缓存时间如果请求的文件已被 CDN 缓存，该字段表示该文件被 CDN 缓存的时间。时间格式采用格林威治标准时间（GMT），示例为：Wed, 21 Aug 2024 07:33:47 GMT。北京时间（UTC+8）需在此基础上加 8 小时。

源站信息

alt

该模块展示了源站相关的信息。如果诊断请求未触发 CDN 回源，则该模块中的字段值显示为 "-"。

字段描述
源站 IP表示 CDN 访问的源站 IP 地址。
状态码表示源站的响应状态码。
回源 Host表示源站的 "回源 Host" 配置。
回源 URL表示回源请求中的 URL。该字段值主要受 回源 URL 改写 和 URL 重定向改写 配置的影响。
回源端口表示 CDN 访问的源站端口。
回源协议表示回源请求使用的协议，字段值有 HTTP 和 HTTPS。该字段值主要受 强制跳转设置 和 URL 重定向改写 配置的影响。

原始响应头信息

alt

该模块展示了 CDN 对诊断请求的响应中包含的响应头，其中包含源站响应中的头部。

说明

诊断请求是跨域请求。但在 "原始响应头信息" 模块中，与跨域资源共享（CORS）相关的以下头部不会展示：

  • Access-Control-Allow-Origin
  • Timing-Allow-Origin
  • Access-Control-Allow-Methods
  • Access-Control-Allow-Headers
  • Access-Control-Expose-Headers