内容分发网络
内容分发网络
- 文档首页
内容分发网络用户指南日志管理日志下载
文档反馈
问问助手本文档介绍火山引擎内容分发网络（CDN）提供的 "日志下载" 服务。该服务允许您下载指定域名在某个时间区间内的请求日志。关于 "日志下载" 与另外两种 CDN 日志获取方式的区别，参见 日志管理概述。
日志下载说明
- 日志包延时：CDN 默认按小时粒度，在整点对过去一小时内采集到的请求日志进行打包，生成日志包。日志包大约在生成后的 3 小时可以被下载。由于网络延时等原因，CDN 采集到的日志可能会有最长 24 小时的延迟。对于采集到的延迟日志，CDN 会将其追加到相应的日志包中。因此，日志包在生成后的 24 小时内可能会有日志的追加。
- 日志包命名规则：加速域名_日志开始时间_日志结束时间.gz，例如：
domain_20220111050000_20220111060000.gz。该日志包中包含在 2022 年 1 月 11 日 05:00:00 到 2022 年 1 月 11 日 05:59:59 之间域名的日志数据。日志打包时间粒度为 1 小时。 - 您可以下载最近 62 天内的请求日志。
若您的加速域名在某时间区间内未收到任何用户请求，则该时间段内没有日志。
日志字段说明
说明
下文展示的是 CDN 离线日志的默认字段。如果您需要在日志中追加默认字段以外的其他字段（例如指定的请求头、响应头等），请 提交工单。
日志示例:[20/Feb/2022:23:00:00 +0800] 192.0.2.1 2.932 GET HTTPS www.test.com /f/202201/10/a/5b6c70f6da8d1e0bae3e1a21eb02d5b3 HTTP/1.1 200 3610495 HIT - "-" "Dalvik/2.1.0 (Linux; U; Android 5.1.1; TAS-AN00 Build/LMY47I)" "application/vnd.android.package-archive"
字段含义：
字段编号 | 字段名称 | 字段含义 | 示例值 |
|---|---|---|---|
1 | 请求结束时间（ds_req_ts_timestamp） | 表示 CDN 完成响应请求的时间。该时间也就是 CDN 完成传输请求文件的最后一个字节的时间。 |
|
2 | 客户端 IP（client_ip） | 表示发送请求的客户端 IP 地址。 |
|
3 | 响应时间（ds_req_time） | 表示 CDN 响应用户请求的耗时，单位是秒。 对于一个用户请求，CDN 的响应耗时是以下两个时间点之间的时间跨度：
|
|
4 | HTTP Method（ds_http_method） | 表示请求使用的方法。 |
|
5 | HTTP Scheme（ds_http_scheme） | 表示请求 URL 中的 scheme。 |
|
6 | 请求域名（domain） | 表示请求 URL 中的域名，也就是您的加速域名。 |
|
7 | 请求 URL（ds_http_uri） | 表示请求 URL 中的路径和查询字符串，以斜杠（/）开头 |
|
8 | HTTP 协议标识（ds_http_protocol） | 表示请求使用的 HTTP 协议版本。 |
|
9 | HTTP 状态码（ds_http_status） | 表示 CDN 的响应状态码。 |
|
10 | 响应字节数（ds_http_resp_size） | 表示 CDN 向用户传输的数据量，单位是 bytes。 |
|
11 | 缓存命中（ds_http_bd_status_hit） | 表示请求是否命中 CDN 的缓存。 |
|
12 | 请求 Range（ds_http_range） | 表示请求中 Range 头部的值。如果请求不包含该头部，该字段的值是 |
|
13 | 请求 Referer（ds_http_referer） | 表示请求中 Referer 头部的值。如果请求不包含该头部，该字段的值是 |
|
14 | 请求 User-Agent（ds_http_ua） | 表示请求中 User-Agent 头部的值。如果请求不包含该头部，该字段的值是 |
|
15 | 响应 Content-Type（ds_http_resp_content_type） | 表示 CDN 响应中 Content-Type 头部的值。如果响应不包含该头部，该字段的值是 |
|
操作步骤
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏，点击 日志管理。
- 在 日志管理 页面，指定查询的时间区间和域名，然后点击 查询。
此时，您就可以获取每个日志包的下载链接。
说明
如果您通过提交工单启用了 中国内地 以外的加速区域，您可以额外指定一个加速区域对日志进行筛选。在查询返回的结果中，您可以通过名称来区分日志包所对应的加速区域。
- 如果日志包的名称包含
outsideChineseMainland，该日志包对应 全球（不含中国内地） 这个加速区域。 - 如果日志包的名称不包含
outsideChineseMainland，该日志包对应 中国内地 这个加速区域。
相关API
DescribeCdnAccessLog:查询域名离线日志的下载地址。