内容分发网络
内容分发网络
- 文档首页
内容分发网络用户指南日志管理实时日志投递实时日志投递概述
文档反馈
问问助手本文档介绍火山引擎内容分发网络（CDN）提供的 "实时日志投递" 服务。关于该服务与另外两种 CDN 日志获取方式的区别，参见 日志管理概述。
说明
要使用实时日志投递，参见 开通实时日志投递。
什么是实时日志投递
对于 CDN 收到的用户请求，也就是加速区域内各 CDN 节点收到用户请求，您可以配置 "实时日志投递"，将请求日志投递到您指定的目的地。
实时日志从日志生成到日志投递的时间间隔不超过 5 分钟。实时日志可用于监控数据指标、检测安全风险、洞察业务趋势等。关于实时日志中包含的字段，参见 日志字段。
版本更新（新版实时日志投递）
此前，CDN 仅支持将实时日志投递到火山引擎日志服务（TLS）下的 cdn-log 日志项目。在 2025年4月15日的 CDN 更新中，我们拓展了实时日志投递的能力。
说明
- 新版实时日志投递正在灰度发布中。如果您当前使用的是旧版，需要切换到新版，请 提交工单。
- 如果您还未开通实时日志投递，希望使用新版实时日志投递，参见 开通新版实时日志投递。
在新版实时日志投递中，我们增加了以下功能：
- 支持将实时日志投递到阿里云日志服务（SLS）中指定的 Logstore 中。
- 支持将实时日志投递到您指定的 HTTP 服务器。
- 在配置实时日志投递到 TLS 时，您可以通过 CDN 创建自定义的日志项目并指定该日志项目。
- 支持指定日志采样率。
参见：
说明
- CDN 集成了 TLS 中的日志检索功能。如果您将实时日志投递到 TLS，您无需离开 CDN 控制台即可对日志进行检索，参见 日志检索示例。
使用场景
日志管理概述 简略描述了实时日志的使用场景。本章节描述了更具体的使用场景。
实时日志可以帮助您分析加速域名遇到的问题，也可以帮助您了解用户是如何访问您的加速域名。除了对实时日志进行过滤，您还可以对日志数据进行处理，满足不同场景下的日志分析需求。
日志分析场景 | 作用描述 |
|---|---|
过滤指定条件的日志 | 指定一个或多个条件过滤日志。例如，您可以基于 URL、IP地址、时间范围过滤日志，以分析某个 IP 地址在指定时间范围内对特定 URL 的请求，以便及时定位问题。 |
监测 CDN 服务指标 | 指标数据可以帮助您了解 CDN 服务的质量以及用户的访问效率，以便您及时发现异常。访问效率包括缓存命中率、CDN 响应耗时、数据传输速度等。 |
监测 CDN 访问错误 | 如果用户在访问加速域名时出现了问题，该数据可以帮助您定位问题的原因。例如 URL 问题、源站故障、源站文件访问异常等。 |
获取热门访问 | 该数据可以帮助您了解用户请求中的热门对象。例如热门域名、热门 URI、热门访客IP、热门 Referer 等。 |
实时日志计费
实时日志功能是收费的。费用由以下部分组成：
- 日志投递的费用。CDN 对投递的日志进行计费。计费单位是万条。关于日志投递计费的详细信息，参见 CDN 计费说明。
- 日志服务（TLS）的费用。TLS 对日志存储，日志的读写流量等进行计费。关于 TLS 计费的详细信息，参见 TLS 计费说明。
开通新版实时日志投递
要开通实时日志投递，遵照以下步骤：
- 提交工单 开通实时日志投递。
- 启用实时日志计费。
- 打开 内容分发网络控制台的服务概览页面。
- 在页面右侧的 计费方式 下方，找到 实时日志计费。
- 点击 开通计费。
日志字段
CDN 投递的请求日志中包含以下字段：
字段 | 说明 | 示例 |
|---|---|---|
time | 表示 CDN 完成响应请求的时间，也就是 CDN 传输完文件最后一个字节的时间。 |
|
client_ip | 表示发送请求的客户端 IP 地址。 |
|
client_ip_country | 表示客户端 IP 地址所归属的国家。 |
|
client_ip_isp | 表示客户端 IP 地址所归属的中国网络运营商。 |
|
client_ip_province | 表示客户端 IP 地址所归属的中国省级行政区。 |
|
client_port | 表示请求使用的客户端端口。 |
|
domain | 表示请求 URL 中的域名，也就是您的加速域名。 |
|
ds_http_bd_status_hit | 表示请求是否命中 CDN 的缓存。该参数的取值如下：
|
|
ds_http_method | 表示请求使用的方法。 |
|
ds_http_protocol | 表示请求使用的 HTTP 协议版本。 |
|
ds_http_range | 表示请求中的 Range 头部的值。如果请求不包含该头部，该参数值为 |
|
ds_http_referer | 表示请求中的 Referer 头部的值。如果请求不包含该头部，该参数值为 |
|
ds_http_resp_content_length | 表示请求文件的大小。单位是 bytes。 |
|
ds_http_resp_content_type | 表示 CDN 响应中 Content-Type 头部的值。如果响应不包含该头部，该参数值为 |
|
ds_http_resp_size | 表示 CDN 向用户传输的数据量，单位是 bytes。 |
|
ds_http_scheme | 表示请求 URL 中的 scheme。 |
|
ds_http_status | 表示 CDN 的响应状态码。 |
|
ds_http_ua | 表示请求中的 User-Agent 头部的值。如果请求不包含该头部，该参数值为 |
|
ds_http_uri | 表示请求 URL 中的路径和查询字符串，以斜杠（/）开头。 |
|
ds_http_uri_path | 表示请求 URL 中的路径，以斜杠（/）开头。 |
|
ds_http_uri_query | 表示请求 URL 中的查询参数。 |
|
ds_req_time | 表示 CDN 响应用户请求所耗费的平均时间，单位是秒。 对于一个用户请求，CDN 的响应耗时是以下两个时间点之间的时间跨度：
|
|