更新时间:2023-03-24 23:31:51
当您的请求经过CDN Pro节点,CDN Pro节点会打印请求访问日志,您可以对这些日志进行下载,以对日志进行分析。下载日志前,您需要先进行日志配置,日志配置完成后,我们的数据中心才会开启日志投递任务,对加速节点上产生的访问日志进行归集与保存,因此您必须先进行日志配置,才可以进行日志下载。本文将为您介绍如何在CDN Pro控制台上配置并下载您的访问日志。
进入CDN Pro控制台,点击左侧【日志报表】【日志下载】菜单,然后点击 【日志配置】”页签。在此处,您可以创建创建日志配置,还可以对日志配置进行修改和删除。
点击日志配置页面的“新增日志配置”按钮,开始填写日志配置表单。
您需填写如下信息:
域名:填写需要开启日志采集的加速域名。多个用空格或者回车分隔。可以填写:①单域名:例如:domain.com
;②带星号的通配符域名:例如 *.domain.com
;③全部域名:用单个星号(*)表示。这需要注意的是:①每个域名只有一个日志配置生效,当前以最新配置的为准。例如,您配置了*.wangsu.com
后又配置了a.wangsu.com
,则只有a.wangsu.com
对应的日志配置会生效,因为这是最新的日志配置;②配置的域名必须是已经在CDN Pro上创建了加速项目的域名。
日志描述:这是一个备注,用于填写日志的用途,便于您管理和查找您的日志配置。
存储天数:配置日志保存的天数,可选区间为1-30天。默认保存14天。
日志文件的时间跨度:配置每个日志文件归集的时间跨度。例如,配置为5分钟,则每5分钟一份日志文件;配置为1440分钟,则每天一份日志文件。目前支持选择的时间跨度包括:5分钟、15分钟、30分钟、60分钟、120分钟、240分钟、480分钟、1440分钟。
日志格式:配置日志文件保存的日志条目格式。①默认日志格式:"%cltip %rmtuser [%utctime] \"%method %url %protocol\" %statuscode %rspsize \"%referer\" \"%ua\" %rsptime"
。②自定义日志格式:您也可以使用我们提供的访问日志变量来自定义配置日志格式(支持的变量见本文:使用变量自定义日志格式)。其中,如果变量值包含不可打印的字符(ASCII 字符 <=0x1F 或 >=0x7F)、双引号或反斜杠,这些字符将被转义为\xXX
等格式。例如,双引号将变为\x22
,反斜杠将变为\x5C
。此处需要注意的是:空格不会被转义,您可以引用包含空格的变量。
到这里,您即完成了日志配置。
以下是您可以在“日志格式”中配置使用的日志变量:
变量名称 |
描述 |
---|---|
%cachestate | 缓存状态:请求命中、请求未命中 或者 请求重新校验 |
%cltip | 客户端IP地址 |
%cltisp | 客户端ISP运营商 |
%cltport | 客户端端口号 |
%cltregion | 客户端区域 |
%cpu_ns | 请求在CDN Pro上的CPU消耗时间(以纳秒为单位) |
%custom1 | 使用custom_log_field 指令自定义的日志变量,ID为1 |
%custom2 | 使用custom_log_field 指令自定义的日志变量,ID为2 |
%hostname | Host头 |
%method | HTTP请求方法(例如:GET) |
%protocol | 用户请求使用的 HTTP 版本( HTTP/1.0、HTTP/1.1 或 HTTP/2.0 ) |
%querystr | 请求的带问号参数(Query String) |
%referer | Referer请求头 |
%reqhdrsize | 请求头大小,单位为字节 |
%reqrange | 客户端请求的Range头 |
%reqsize | 请求大小,包含:请求行、请求头和请求正文,单位为字节 |
%rmtuser | 使用基本身份验证时,从Authorization 标头中提取的用户名 |
%rspsize | HTTP 响应大小,包括标头和正文,但不包括 TCP/IP/MAC,单位为字节 |
%rsptime | 响应时间,单位为毫秒 |
%samplerate | 每个日志条目对应的请求数 |
%scheme | 用户请求的协议( http 或 https ) |
%statuscode | 用户请求的 HTTP 响应状态码,例如:200 |
%svrnode | Cache节点的名称 |
%tcprtt | 服务端和客户端之间的往返时间(RTT),单位:微秒 |
%ua | User-Agent头部值 |
%uniqueid | 表示请求的唯一标识符 |
%url | 请求的完整URL,如果带查询参数则会包含查询参数 |
%utctime | 响应的时间戳,格式遵循 RFC 3339,例如,2021-10-05T12:34:56Z |
在日志配置页面下找到需要修改的日志配置,点击操作列下的省略号图标按钮(),在下拉选项中点击“修改”按钮,可以对日志配置进行修改。
在日志配置页面下找到需要删除的日志配置,点击操作列下的省略号图标按钮(),在下拉选项中点击“删除”按钮,可以对日志配置进行删除。
进入CDN Pro控制台,点击左侧【日志报表】【日志下载】菜单,然后点击 【日志下载】页签。在此处,您可以在此处搜索生成的日志文件并对其进行下载。
域名:输入加速域名,查找对应域名的访问日志。这里需要注意的是,日志查找仅支持输入单域名进行查找,并且只能输入一个域名。暂不支持多域名和通配符查找。如果您在日志配置中配置的是某个通配符域名配置,在此处无法通过通配符查找,需要搜索具体的域名。例如,您在日志配置中配置了*.wangsu.com
,您有2个域名a.wangsu.com
和b.wangsu.com
,则此处您需要输入a.wangsu.com
或者b.wangsu.com
来查找对应的文件。
时间:选择生成的日志文件的开始时间和结束时间。日志文件的命名是按照请求的时间来归集的,只有当域名有请求并生成访问日志的时候,CDN Pro才会生成对应的日志文件,否则将没有日志文件。
搜索结果。当您搜索完成后,您可以在列表中看到搜索结果。此处会显示访问日志文件的开始时间、结束时间、文件大小等信息。
下载日志文件。您可以点击所选日志记录操作列的“下载”按钮,对日志文件进行下载。
到这里,您即完成了日志下载。