日志与分析
查看 CDN 流量、缓存命中率、状态码和地理分布,逐条查询请求日志,并运行站点诊断。
CDN 的统计数据来自边缘节点的访问日志。你可以在三个地方查看:账户级的 流量分析 页面、每个域名的 流量分析 标签页,以及防火墙中的 WAF 分析 / 事件日志。每个域名还有一个 诊断 工具,用来排查配置问题。
访问日志从边缘节点汇总到统计系统需要一段时间,最近几分钟的数据可能还没有出现。
账户级流量分析
路径:CDN管理 → 流量分析(/cdn/analytics)。
- 筛选域名:默认汇总账户下的全部 CDN 域名,也可以只看某一个域名。
- 时间范围:默认最近 7 天,可以精确到秒。
页面显示的内容:
| 区块 | 内容 |
|---|---|
| 总流量 | 时间范围内边缘返回给访客的响应体字节数 |
| 总请求数 | 边缘处理的请求总数 |
| 缓存命中率 | 由边缘缓存直接响应(HIT 或 STALE)的请求占全部请求的百分比 |
| 覆盖国家/地区 | 有访问记录的国家或地区数量 |
| 热门域名 | 各域名的流量、请求数、缓存命中率 |
| 流量分布(按地区) | 按国家或地区统计的流量和请求数 |
| 热门URL | 访问次数最多的路径(不含查询串) |
| HTTP状态码分布 | 各状态码的请求次数 |
| 浏览器分布 | 根据 User-Agent 识别出的浏览器 |
域名流量分析
路径:域名详情 → 流量分析(/cdn/domains/<域名>/traffic)。右上角可以选择时间范围,默认最近 7 天。
概览统计
- 总请求数、总流量、缓存命中率、平均响应时间(边缘处理请求的平均耗时,单位为秒)。
- 2xx 成功 / 3xx 重定向 / 4xx 客户端错误 / 5xx 服务器错误 的请求数。
- 热门URL:每个路径的访问次数和流量。
- HTTP状态码分布。
5xx 突然增多通常说明源站出了问题,可以先用下面的 诊断 工具检查源站连通性。4xx 增多时,可以到防火墙的 事件日志 确认是不是安全规则拦截了请求。
地理分布
世界地图加国家 / 地区列表,显示每个国家或地区的请求数和流量。访客所在地根据客户端 IP 判断。
请求查询
在所选时间范围内逐条查询访问日志。
- 按需填写筛选条件:Request ID(精确匹配)、URI(包含匹配)、状态码、客户端IP。
- 点击 查询。结果按时间倒序分页,每页可显示 20 / 50 / 100 / 200 条。
- 点击某条记录的 查看详情,可以看到:
- 基本信息:时间、域名、方法、状态码、完整 URL、协议、客户端 IP、请求 / 响应大小、耗时、缓存状态。
- 请求头:User-Agent、Referer、X-Forwarded-For、Accept-Language 等。
- 响应头:Content-Type、Cache-Control、ETag、Last-Modified,以及源站返回的对应值。
- 上游:回源地址、源站状态码、连接 / 首字节 / 响应耗时。
- SSL:TLS 协议版本和加密套件。
- 地理:国家、地区、城市、ISP、ASN。
- CDN:处理该请求的节点和缓存状态。
每个响应都带有 X-Request-ID 响应头,其值就是这里的 Request ID。排查问题或联系技术支持时,可以直接用它查询对应的请求。
WAF 分析与事件日志
安全事件在 防火墙 页面查看(参见 WAF 与安全):
- WAF 分析:总事件数、拦截数、攻击 IP 数、触发规则数,加上事件时间线、Top 触发规则、Top 攻击 IP。时间范围提供最近 1 小时、24 小时、7 天、30 天的快捷选项,也可以自定义。
- 事件日志:逐条列出被拦截、质询或限速的请求,可以按动作类型、IP、URI 筛选。展开一条记录可以看到规则 ID、规则类型、消息、匹配的键和值。
站点诊断
路径:域名详情 → 诊断(/cdn/domains/<域名>/diagnostics)。
- 选择要诊断的主机名。
- 点击 开始诊断,等待检查完成。
诊断会依次检查以下项目,每项结果为 通过、信息、警告 或 错误,并附带说明:
| 检查项 | 内容 |
|---|---|
| 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 只查一个域名。
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"} |
目前不支持下载原始日志文件、实时日志流或把日志推送到外部存储。需要导出数据时,可以分页调用请求日志接口。