新用户新用户即享 DNS 与 CDN 免费套餐。立即注册

日志与分析

查看 CDN 流量、缓存命中率、状态码和地理分布,逐条查询请求日志,并运行站点诊断。

7 分钟阅读 更新于 2026年10月6日

CDN 的统计数据来自边缘节点的访问日志。你可以在三个地方查看:账户级的 流量分析 页面、每个域名的 流量分析 标签页,以及防火墙中的 WAF 分析 / 事件日志。每个域名还有一个 诊断 工具,用来排查配置问题。

Note

访问日志从边缘节点汇总到统计系统需要一段时间,最近几分钟的数据可能还没有出现。

账户级流量分析

路径:CDN管理 → 流量分析(/cdn/analytics)。

  • 筛选域名:默认汇总账户下的全部 CDN 域名,也可以只看某一个域名。
  • 时间范围:默认最近 7 天,可以精确到秒。

页面显示的内容:

区块内容
总流量时间范围内边缘返回给访客的响应体字节数
总请求数边缘处理的请求总数
缓存命中率由边缘缓存直接响应(HIT 或 STALE)的请求占全部请求的百分比
覆盖国家/地区有访问记录的国家或地区数量
热门域名各域名的流量、请求数、缓存命中率
流量分布(按地区)按国家或地区统计的流量和请求数
热门URL访问次数最多的路径(不含查询串)
HTTP状态码分布各状态码的请求次数
浏览器分布根据 User-Agent 识别出的浏览器

域名流量分析

路径:域名详情 → 流量分析(/cdn/domains/<域名>/traffic)。右上角可以选择时间范围,默认最近 7 天。

概览统计

  • 总请求数、总流量、缓存命中率、平均响应时间(边缘处理请求的平均耗时,单位为秒)。
  • 2xx 成功 / 3xx 重定向 / 4xx 客户端错误 / 5xx 服务器错误 的请求数。
  • 热门URL:每个路径的访问次数和流量。
  • HTTP状态码分布。
Tip

5xx 突然增多通常说明源站出了问题,可以先用下面的 诊断 工具检查源站连通性。4xx 增多时,可以到防火墙的 事件日志 确认是不是安全规则拦截了请求。

地理分布

世界地图加国家 / 地区列表,显示每个国家或地区的请求数和流量。访客所在地根据客户端 IP 判断。

请求查询

在所选时间范围内逐条查询访问日志。

  1. 按需填写筛选条件:Request ID(精确匹配)、URI(包含匹配)、状态码、客户端IP。
  2. 点击 查询。结果按时间倒序分页,每页可显示 20 / 50 / 100 / 200 条。
  3. 点击某条记录的 查看详情,可以看到:
    • 基本信息:时间、域名、方法、状态码、完整 URL、协议、客户端 IP、请求 / 响应大小、耗时、缓存状态。
    • 请求头:User-Agent、Referer、X-Forwarded-For、Accept-Language 等。
    • 响应头:Content-Type、Cache-Control、ETag、Last-Modified,以及源站返回的对应值。
    • 上游:回源地址、源站状态码、连接 / 首字节 / 响应耗时。
    • SSL:TLS 协议版本和加密套件。
    • 地理:国家、地区、城市、ISP、ASN。
    • CDN:处理该请求的节点和缓存状态。
Tip

每个响应都带有 X-Request-ID 响应头,其值就是这里的 Request ID。排查问题或联系技术支持时,可以直接用它查询对应的请求。

WAF 分析与事件日志

安全事件在 防火墙 页面查看(参见 WAF 与安全):

  • WAF 分析:总事件数、拦截数、攻击 IP 数、触发规则数,加上事件时间线、Top 触发规则、Top 攻击 IP。时间范围提供最近 1 小时、24 小时、7 天、30 天的快捷选项,也可以自定义。
  • 事件日志:逐条列出被拦截、质询或限速的请求,可以按动作类型、IP、URI 筛选。展开一条记录可以看到规则 ID、规则类型、消息、匹配的键和值。

站点诊断

路径:域名详情 → 诊断(/cdn/domains/<域名>/diagnostics)。

  1. 选择要诊断的主机名。
  2. 点击 开始诊断,等待检查完成。

诊断会依次检查以下项目,每项结果为 通过、信息、警告 或 错误,并附带说明:

检查项内容
DNS 解析主机名是否已正确解析到 CDN
源站连通性边缘能否连接到源站
源站重定向检测源站的 HTTP→HTTPS 跳转是否会与当前 SSL 模式形成重定向循环
SSL 模式一致性SSL 模式与回源协议、端口的配置是否匹配
源站 SSL 证书源站证书是否有效、是否匹配主机名
强制 HTTPS 配置强制 HTTPS 与证书状态是否冲突
混合内容风险HTTPS 页面引用 HTTP 资源的风险
协议开关一致性HTTP / HTTPS 开关组合是否合理

页面顶部还会显示当前的 SSL 模式、强制 HTTPS、HTTP 和 SSL 状态,方便对照。

API

所有统计接口都需要 startTime 和 endTime(格式为 YYYY-MM-DD HH:mm:ss),可以用 domain_id 只查一个域名。

bash
curl -G "https://api.yeap.cloud/api/user/traffic/stats" \
  -H "Authorization: Bearer <token>" \
  --data-urlencode "startTime=2026-10-01 00:00:00" \
  --data-urlencode "endTime=2026-10-07 23:59:59" \
  --data-urlencode "domain_id=123"

返回 total_requests、total_traffic、avg_response_time、cache_hit_rate。其他接口:

接口内容
GET /api/user/traffic/map按国家 / 地区统计
GET /api/user/traffic/top-urls热门 URL
GET /api/user/traffic/status-codes状态码分布
GET /api/user/traffic/browsers浏览器分布
GET /api/user/traffic/top-domains热门域名
GET /api/user/cdn/domains/{domain}/traffic单个域名的概览和时间序列
GET /api/user/traffic/logs请求日志(支持 request_id、uri、status、client_ip、page、pageSize,pageSize 最大为 200)
POST /api/user/cdn/diagnostics/run运行诊断,请求体为 {"hostname": "www.example.com"}
Note

目前不支持下载原始日志文件、实时日志流或把日志推送到外部存储。需要导出数据时,可以分页调用请求日志接口。

本页内容是否有帮助?