CDN访问日志_操作指南_日志服务平台-文档中心

本文为您介绍平台原生数据之CDN访问日志及字段说明。

Basic

编号	字段名称	字段编码	数据类型	字段描述
1	日志版本	log_version	LONG	用于标识日志的版本信息。
2	日志采样率	log_sampling_rate	INT	值为`N`代表每`N`个请求会生产`1`条实时日志。
3	内容代码	content_code	STRING	用于标记不同请求以便分类的标识符。可用于分类报告、计费和请求处理。
4	加速域名	hostname	STRING	服务于该请求的配置在加速平台的主机名。如果加速域名为泛域名，日志记录以’.'开头。
5	请求ID	request_id	STRING	请求的唯一标识符，在平台内具有全局唯一性。有助于调试。
6	日志记录时间（毫秒）	log_timestamp_ms	LONG	生成此条日志的毫秒级时间戳。

Client

编号	字段名称	字段编码	数据类型	字段描述
1	真实客户端IP	client_real_ip	STRING	真实客户端IP。优先取Cdn-Src-Ip头部的值，没有则取remote-ip。
2	真实客户端端口	client_real_port	INT	真实客户端端口。优先取Cdn-Src-Port头部的值，没有则取remote-port。
3	建连客户端IP	client_ip	STRING	与加速节点进行TCP建连的对端IP。取remote-ip。
4	建连客户端端口	client_port	INT	与加速节点进行TCP建连的对端口。取remote-port。
5	HTTP鉴权用户名	client_remote_auth_user	STRING	HTTP基础鉴权的认证用户名，从Authorization请求头中提取。
6	真实客户端IP版本	client_ip_version	INT	真实客户端IP协议版本。`4`表示IPv4，`6`表示IPv6。
7	真实客户端大洲	client_continent	STRING	真实客户端IP所属大洲。支持中文和英文。
8	真实客户端国家或地区	client_country	STRING	真实客户端IP所属国家（例如美国、中国、俄罗斯等）或地区（例如中国大陆港澳台等）。支持编码、中文和英文。其中，编码数据标准使用ISO 3166二字码。
9	真实客户端区域（省份/州）	client_region	STRING	真实客户端IP所属的区域。例如：中国大陆省份、美国州。支持编码和中文。其中，编码数据标准使用ISO 3166二字码。
10	真实客户端运营商	client_isp	STRING	真实客户端IP所属运营商。支持中文和英文。
11	真实客户端纬度	client_latitude	STRING	真实客户端IP所属纬度。
12	真实客户端经度	client_longitude	STRING	真实客户端IP所属经度。
13	客户端User Agent	client_user_agent	STRING	请求头`User-Agent`的值。
14	客户端浏览器名称	client_browser	STRING	请求客户端的浏览器名称。从请求头`User-Agent`中提取。
15	客户端设备名称	client_device	STRING	请求客户端的设备名称。从请求头`User-Agent`中提取。
16	客户端操作系统名称	client_os	STRING	请求客户端的操作系统名称。从请求头`User-Agent`中提取。

Request

编号	字段名称	字段编码	数据类型	字段描述
1	请求开始时间（毫秒）	request_timestamp_ms	LONG	节点接收到客户请求首个字节的毫秒级时间戳，用于表示请求开始时间。
2	SNI主机名	request_tls_server_name	STRING	客户端请求TLS握手包中SNI携带的Server Name。
3	SSL协议版本	request_ssl_protocol	STRING	请求连接的SSL/TLS协议版本。包括：SSLv3、TLSv1、TLSv1.1、TLSv1.2、TLSv1.3。
4	SSL复用标记位	request_ssl_reuse	INT	客户端请求的SSL/TLS连接复用标记位，用于表示是否SSL Session复用。`1`表示复用，`0`表示未复用。
5	请求HOST	request_host	STRING	客户端请求的请求头`Host`的值。注意：若请求端口非80或443端口，则该字段会带上端口号。
6	HTTP协议版本	request_http_protocol	STRING	客户端请求的HTTP协议版本。例如：HTTP/1.0、HTTP/1.1、HTTP/2.0、HTTP/3.0。
7	请求协议类型	request_scheme	STRING	客户端请求的Scheme请求协议，包括：`http`、`https`。
8	请求方法	request_method	STRING	客户端请求的请求方法，例如：GET、POST、PUT、DELETE、PATCH、HEAD、OPTION等。
9	请求URL	request_url	STRING	客户端请求的完整URL。
10	请求URL完整查询参数	request_url_query_string	STRING	请求URL携带的完整查询参数。注意，不以问号开头。例如：`deviceFamily=iPhone&domain=apps,books&storefrontId=143465&userId=16694213637`。
11	请求URI路径	request_url_path	STRING	请求的URI路径，不包含查询参数。以’/'开头。
12	请求头Referer	request_referer	STRING	客户端请求的请求头`Referer`的值。
13	请求头Content-Type	request_content_type	STRING	客户端请求的请求头`Content-Type`的值。
14	请求头Range	request_range	STRING	客户端请求的请求头`Range`的值。
15	请求大小	request_bytes	LONG	请求的流量大小，包括请求行、请求头和请求体。单位：字节。
16	请求头大小	request_header_bytes	LONG	请求头的流量大小，包括请求行、请求头，不包含请求体。单位：字节。
17	请求传输速率	request_tcp_delivery_rate	LONG	本次请求中由 TCP 协议栈统计到的数据传输速率。单位：字节/秒。
18	请求最小RTT	request_tcp_min_rtt	LONG	本次请求中由 TCP 协议栈统计到的最小 RTT。单位：微秒。
19	请求平均RTT	request_tcp_rtt	LONG	本次请求中由 TCP 协议栈统计到的平均 RTT。单位：微秒。
20	TCP连接首个请求	request_tcp_initial_request	INT	本次请求是否为当前TCP连接上的首个请求。`1`表示首个请求，`0`表示非首个请求。
21	请求接收时长	request_receive_duration	DOUBLE	接收完整客户端请求的时长，即节点从接收到客户请求首个字节并准备好处理/转发它所需的时间。单位：秒。

EdgeServer

编号	字段名称	字段编码	数据类型	字段描述
1	边缘节点服务器IP	edge_server_ip	STRING	加速节点服务器IP地址。
2	边缘节点服务器国家或地区	edge_server_country	STRING	加速节点服务器IP所属国家（例如美国、中国、俄罗斯等）或地区（例如中国大陆港澳台等）。支持编码、中文和英文。其中，编码数据标准使用ISO 3166二字码。
3	边缘节点服务器区域（省份/州）	edge_server_region	STRING	加速节点服务器IP所属的区域。例如：中国大陆省份、美国州。支持编码和中文。其中，编码数据标准使用ISO 3166二字码。
4	边缘节点服务器运营商	edge_server_isp	STRING	加速节点服务器IP所属运营商。支持中文和英文。
5	边缘节点服务器纬度	edge_server_latitude	STRING	加速节点服务器IP所属纬度。
6	边缘节点服务器经度	edge_server_longitude	STRING	加速节点服务器IP所属经度。
7	边缘节点服务器端口	edge_server_port	INT	加速节点服务器端口。

Cache

编号	字段名称	字段编码	数据类型	字段描述
1	边缘节点缓存命中状态	cache_status_edge	STRING	该字段表示请求在边缘节点的缓存命中状态。`MISS`表示缓存未命中，`HIT`表示缓存命中。
2	缓存命中状态	cache_status	STRING	该字段表示请求的缓存命中状态。`MISS`表示缓存未命中，`HIT`表示缓存命中。注意，这一状态反映了请求在整个加速节点链路中的命中情况。因此，如果在边缘节点为`MISS`但在父节点为`HIT`，则标记为`HIT`。

Response

编号	字段名称	字段编码	数据类型	字段描述
1	响应发送时长	response_send_duration	DOUBLE	发送完整响应的时长。即节点将完整的响应正文（直到最后一个字节）发送到系统缓冲区所需的时间。单位：秒。
2	节点响应状态码	response_status_code	LONG	加速节点服务器发送给客户端的HTTP状态码。例如：200、302、403、500等。
3	响应大小	response_bytes	LONG	加速节点服务器发送给客户端的流量大小，包括响应头、响应体。单位字节。
4	响应体大小	response_body_bytes	LONG	加速节点服务器发送给客户端的响应体流量大小，不包括响应头。单位字节。
5	响应头Content-Type	response_content_type	STRING	加速节点服务器发送给客户端的响应头`Content-Type`的值。
6	响应头Content-Length	response_content_length	STRING	加速节点服务器发送给客户端的响应头`Content-Length`的值。
7	响应头Via	response_via	STRING	加速节点服务器发送给客户端的响应头`Via`的值。
8	响应开始标记	response_first_byte_sent	INT	本次请求的第一个响应体字节是否已发送给客户端，若已发送则表示响应开始。`1`表示已发送，`0`表示未发送。 - 对于200响应，发送响应头后该值为`1`。 - 对于206响应，如果请求头`Range`值以’0’开头，则发送响应头后该值为`1`。 - 如果没有响应体，则响应头发送后该值为`1`。
9	响应结束标记	response_last_byte_sent	INT	本次请求的最后一个响应体字节是否已发送给客户端，若已发送则表示响应结束。`1`表示已发送，`0`表示未发送。 - 在正常传输的情况下，如果所有数据都已响应给客户端则值为`1`，否则值为`0`。 - 在Chunked分块传输编码的情况下，如果最后一个块成功响应给客户端，则值为`1`。
10	响应时间（毫秒）	response_time_ms	LONG	完整的请求处理时间，标记加速节点服务器从客户端读取第一个字节到发送最后一个字节给客户端所经过的时间，即包含请求接收时长和响应处理时长。其中，如果是长连接分段请求，则表示每个分段内的请求处理时间。单位：毫秒。

Custom

编号	字段名称	字段编码	数据类型	字段描述
1	自定义日志字段	custom_field	STRING	若通用日志字段无法满足日志上报需求，可在加速域名上配置添加自定义日志字段。自定义日志将以Key-Value格式输出，多个KV对之间使用英文逗号分隔。

注意：

日志字段的可用性可能会根据实际配置有所不同，建议结合自身业务场景合理选择。

目前不含直播业务相关的日志。

Media Delivery

Cloud Security

Web Performance

Network Acceleration

Infrastructure

Edge Computing

Console Guide

开发者工具

管理与服务

CDN访问日志

Basic

Client

Request

EdgeServer

Cache

Response

Custom

相关文章

目录