# 实时日志
在使用CDN对资源进行加速时，CDN会产生大量日志数据，每一次终端用户访问都会产生对应的日志，以便分析业务情况。华为云CDN通过与云日志服务（LTS）融合，将实时采集到的日志推送至云日志服务进行分析。
#### 为什么要看实时日志
实时日志可以帮助您分析加速域名遇到的异常问题，也可以帮助您了解用户的访问情况。实时日志的优势如下：
1. 当前CDN控制台可为用户展示的离线日志是延时了6个小时的日志，而实时日志延时较小，可以帮助您更快速对终端用户访问日志进行分析。
2. 传统离线日志需要您先将离线日志包下载、解压再对日志进行分析处理，过程比较繁琐。华为云已打通与云日志服务间的通信链路，采用流式传输，免去了传统日志繁琐的下载分析流程。
3. 云日志服务已部署CDN专属的可视化仪表盘，您可以一键开启，将CDN原始日志可视化呈现。
4. 离线日志目前默认提供访问时间、状态码等14个字段，实时日志默认提供日志分析常用的26个字段，详见[实时日志字段]。
 
#### 注意事项
1. CDN目前仅支持推送中国大陆节点（域名服务范围为中国大陆或全球）的日志到云日志服务的**华北-北京四**region。CDN其余地区节点的日志推送功能正在规划，请关注产品动态。
2. CDN节点实时日志推送暂不收费（后续是否会收费请关注产品动态），基础存储与分析相关费用由云日志服务（LTS）收取。
3. 受网络、节点物理硬件等的影响，引起的部分日志有延迟属于正常波动，实时日志也会存在小概率的延迟。
4. 实时日志不可用于计费、对账等场景。
5. 对接LTS后，如果您的域名上量超过20%，请提前5天提交工单请运维人员介入，以免影响正常使用。
6. 如果您将某域名迁移到了当前IAM用户没有查询权限的企业项目中，在该IAM用户下修改日志推送规则时将会下发失败。
   - 示例：IAM用户A拥有企业项目test的查询权限，域名example.com的企业项目归属也是test。IAM用户A创建了一条域名example.com的日志推送，后续因业务需要将域名example.com迁移到了企业项目test1中，此时用户登录账号A修改域名example.com的日志推送时将报错无权限。
   
   - 解决方案：登录主域名或者其他有企业项目test1查询权限的IAM用户修改。
    
 
#### 操作步骤
1. 登录[CDN控制台](https://console.huaweicloud.com/cdn/?locale=zh-cn#/cdn/overview)。
2. 在左侧菜单栏中，选择"运维工具 \> 日志管理"。
3. 选择"实时日志"页签，单击"创建实时日志推送"，进入配置页面。
   图1创建实时日志推送   
   ![](https://support.huaweicloud.com/usermanual-cdn/zh-cn_image_0000002628295618.png "点击放大")
   表1参数说明 
   | 参数        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                |
   |:---|:---|
   | 名称        | 推送规则的名称，需以cdn_log_lts_开头，字符长度为1-32。                                                                                                                                                                                                                                                                                                                                                                                               |
   | 日志生成区域    | 当前仅支持推送**中国大陆节点产生的日志**到"华北-北京四"区域。                                                                                                                                                                                                                                                                                                                                                                                                |
   | 域名        | 选择需要将实时日志推送到LTS的域名，一个域名只能对应一个日志推送规则。 说明： 不支持选择已配置实时日志和"服务范围"仅包含"中国大陆境外"的域名。                                                                                                                                                                                                                                                                                             |
   | QPS阈值     | 当前配置中所有域名的总QPS，如果超出阈值，可能会被限流或者停止上传实时日志。 - 取值范围1-20000，超出20000时需提交工单申请。                                                                                                                                                                                                                                      |
   | 状态码过滤（可选） | 当客户端收到的指定的响应码时，才会上报实时日志，置空时默认上报所有实时日志。 - 支持状态码（如502、403等）或状态码段（如4xx、401\~409）。  - 多个状态码/状态码段之间用","分隔，最多输入3个状态码/状态码段。  - 不支持重复的状态码或状态码段，例如不支持400\~499,404或500\~502,501\~504。   |
   | 日志对接LTS   | **日志组**（LogGroup）是云日志服务进行日志管理的基本单位，可以创建日志流以及设置日志存储时间，此处可选择存量日志组或创建新的日志组。                                                                                                                                                                                                                                                                                                                                                          |
   | 日志对接LTS   | **日志流**（LogStream）是日志读写的基本单位，日志组中可以创建日志流，将不同类型的日志分类存储，方便对日志进一步分类管理。此处可选择存量日志流或创建新的日志流。                                                                                                                                                                                                                                                                                                                                            |
      
   
4. 配置相关规则，单击"确定"完成日志推送规则创建。 **日志推送规则创建1小时后**，可前往LTS服务控制台查看CDN服务日志，查看路径"云日志服务 \> 日志管理"，选择对应的日志组和日志流，即可查看相关日志信息。
   
 
 #### 实时日志字段
表2实时日志字段说明 
| 字段                 | 字段含义                                   | 是否一定有值 | 缺省值 |
|:---|:---|:---|:---|
| request_time       | 请求时间戳，单位：毫秒                            | 是      | 无   |
| domain             | 请求的域名                                  | 是      | 无   |
| method             | 请求方法                                   | 是      | 无   |
| scheme             | 请求协议                                   | 是      | 无   |
| uri                | 请求资源                                   | 是      | 无   |
| uri_param          | 请求参数                                   | 否      | "-" |
| client_ip          | 用户真实IP                                 | 是      | 无   |
| client_port        | 和CDN节点建连客户端端口                          | 是      | 无   |
| refer_protocol     | HTTP refer中的协议                         | 否      | "-" |
| refer_domain       | HTTP refer中domain信息                    | 否      | "-" |
| refer_uri          | HTTP refer中uri信息                       | 否      | "-" |
| refer_param        | HTTP refer中的参数信息                       | 否      | "-" |
| request_size       | 请求大小                                   | 是      | 无   |
| response_time      | 请求响应时长，单位：毫秒                           | 是      | 无   |
| response_size      | 请求返回大小，单位：字节                           | 是      | 无   |
| http_code          | 请求响应码                                  | 是      | 无   |
| response_range     | 应答头里表示的range信息（由源站创建），如bytes：0\~99/200 | 是      | 无   |
| request_range      | 用户请求中Header头中range字段取值，如bytes：0\~100   | 是      | 无   |
| request_body_bytes | 实际发送body大小，单位：字节                       | 是      | 无   |
| content_type       | 请求的资源类型                                | 是      | 无   |
| hit_info           | 命中信息，取值为HIT（命中）、MISS（未命中）              | 是      | 无   |
| user_agent         | UA                                     | 否      | "-" |
| uuid               | 请求唯一标识（全网唯一请求ID，即traceid）              | 是      | 无   |
| via_info           | via头信息                                 | 否      | "-" |
| X-Forwarded-For    | 请求头中X-Forwarded-For字段                  | 否      | "-" |
| server_ip          | 服务端IP：CDN服务端响应IP                       | 是      | 无   |