API 文档

实时日志

最近更新时间:2021-01-14 16:03:30

功能介绍

内容分发网络(CDN)通过对 CDN 访问日志的实时采集与推送,可实现对日志数据的快速检索与分析。您可通过 CDN 控制台一站式快捷接入,享受从日志采集、日志存储到日志检索等全方位稳定可靠的日志服务。

说明:

  • 实时日志服务已全量发布。您可通过控制台,使用主账号自助开通并使用。使用前需先授权并开通 日志服务(CLS)
  • 实时日志服务暂不支持中国境外日志的投递。
  • 实时日志服务仅支持主账号开通。

适用场景

实时查看 / 分析用户访问情况。

基本概念

日志集

日志集(Logset)是日志服务的项目管理单元,用于区分不同项目的日志,一个日志集对应一个项目或应用。CDN 日志集有以下基本属性信息:

  • 日志集名称:cdn_logset
  • 地区:日志集所属 地域
  • 保存时间:当前日志集里数据的保存时间周期
  • 创建时间:日志集创建时间

日志主题

日志主题(Topic)是日志服务的基本管理单元,一个日志集可以包含多个日志主题。一个日志主题对应一类应用或服务,建议将不同机器上的同类日志收集到同一个日志主题中。例如,一个业务项目有三种日志:操作日志、应用程序日志、访问日志,每种类型可以创建一个日志主题。

日志服务系统以日志主题为单位,区分管理用户不同的日志数据,每个日志主题都可以配置不同的数据源、不同的索引规则和投递规则。因此,日志主题是日志服务配置、管理日志数据的基本单元,创建日志主题后需配置相关规则,才能如期有效地进行日志采集,并使用检索分析和投递等功能。

从场景功能上理解,日志主题主要提供:

  • 采集日志到日志主题。
  • 以日志主题为单元存储管理日志。
  • 以日志主题为单元检索分析日志。
  • 以日志主题为单元投递日志到其他平台。
  • 从日志主题下载、消费日志。

操作指南

登录 CDN 控制台,单击左侧目录的【日志服务】,选择【实时日志】,即可进入实时日志页面,开始创建实时日志投递。

新建日志主题

单击【新建】,创建日志主题。

注意:

一个日志集下至多可创建10个主题。

配置日志主题

填写新增日志主题名称,绑定域名到该日志主题下。

注意:

  • 新建日志主题名称不可与现存日志主题名称相同。
  • 一个域名只能绑定到一个日志主题下,不可绑定多个日志主题。
  • 配置信息保存后,配置生效时间大约为15分钟。

管理日志主题

成功配置日志主题后,您可对日志主题进行管理:停止 / 启动日志投递到该日志主题、以该日志主题为单元检索日志、管理该日志主题和删除该日志主题。

停止 / 启动日志投递

您可手动停止 / 启动日志投递到日志主题。

注意:

  • 停止后,所有绑定该日志主题域名的日志将不再继续投递至该主题,已经投递的日志将会继续保留。生效时间约为5- 15分钟。
  • 启动后,所有绑定该日志主题域名的日志将继续投递至该主题。生效时间约为5 - 15分钟。

检索

以日志主题为单元进行日志检索。选择您需要检索的日志主题,单击【检索】,进入日志检索页面

  • 时间区间选择:支持检索今天,24小时(可选近7天中的某一天),近7天的日志数据。
  • 排列展示:支持按照日志时间进行降序 / 升序排列。
  • 检索:支持全文检索、键值检索和模糊关键字检索。详细内容见 检索语法。更多检索分析功能可前往 日志服务(CLS) 进行使用。

管理

您可管理已创建的日志主题,更新该主题下绑定的域名列表。

说明:

新配置生效时间约为5 - 15分钟。

删除

您可手动删除日志主题。

注意:

删除后,所有该日志主题下绑定域名的日志将不再继续投递至该主题,已经投递的日志将会被全部清空。生效时间约为5 - 15分钟。

日志数据说明

日志字段 原始日志类型 日志服务类型 说明
app_id Integer long 腾讯云账号 APPID
client_ip String text 客户端 IP
file_size Integer long 文件大小
hit String text 缓存 HIT / MISS,在 CDN 边缘节点命中、父节点命中均标记为 HIT
host String text 域名
http_code Integer long HTTP 状态码
isp String text 运营商
method String text HTTP Method
param String text URL 携带的参数
proto String text HTTP 协议标识
prov String text 运营商省份
referer String text Referer 信息,HTTP 来源地址
request_range String text Range 参数,请求范围
request_time Integer long 响应时间(毫秒),指节点从收到请求后响应所有回包再到客户端所花费的时间
rsp_size Integer long 返回字节数
time Integer long 请求时间,UNIX 时间戳
ua String text User-Agent 信息
url String text 请求路径
uuid String text 请求的唯一标识
version Integer long CDN 实时日志版本
目录