CLS 日志服务支持免密通过 JS、HTTP 和 Kafka 协议将日志上传至 CLS。
使用场景
用户使用的浏览器、操作系统、分辨率等信息。
用户浏览行为记录(例如:用户在网站上的点击行为、购买行为等信息)。
用户在 App 中的停留时间、是否活跃等信息。
操作步骤
步骤一:日志主题开通匿名访问
注意:
使用匿名采集则表示目标投递日志主题打开匿名访问,没有经过有效鉴权,可能产生脏数据。
1. 登录 日志服务 控制台。
2. 在左侧导航栏中,单击日志主题,在日志主题管理页中,单击创建日志主题,或找到已有日志主题并单击编辑,即可创建/编辑日志主题。
3. 在日志主题创建或编辑弹窗中,找到匿名访问配置项, 并开启开关。
4. 开启开关后,在匿名操作中选择日志匿名上传方式。 当前支持的匿名上传操作为:JS/HTTP 日志上传、Kafka 协议上传。
步骤二:上传日志
开通匿名访问后,基于步骤一中日志主题配置的匿名操作,您可以通过以下方法上传日志到日志主题中。
方法1:通过浏览器 JavaScript SDK 上传日志
方法2:通过小程序 JavaScript SDK上传日志
方法3:通过 HTTP GET 请求上传日志
# 支持httpscurl --request GET 'http://${region}.cls.tencentcs.com/track?topic_id=${topic_id}&key1=val1&key2=val2'
参数 | 是否必填 | 说明 |
${region} | 是 | |
${topic_id} | 是 | 日志主题 ID |
key1=val1&key2=val2 | 是 | 您要上传到日志服务的键值对(Key-Value),支持设置多个键值对,由&隔开。请确保长度小于16KB |
方法4:通过 HTTP POST 请求上传日志
GET 请求上传日志时,单个请求只能写入一条日志。如果请求的数据量比较大,可以使用 POST 方法上传数据。
接口说明
适用于在网页或者客户端采集日志的场景。
支持将多条日志合并为一次请求。
该接口不支持同时写入多个 Topic 的日志数据。
请求头
请求语法
# 支持httpsPOST http://${region}.cls.tencentcs.com/tracklog?topic_id=${topic_id} HTTP/1.1
参数 | 是否必填 | 说明 |
${region} | 是 | |
${topic_id} | 是 | 日志主题 ID |
示例
POST /tracklog?topic_id={topic_id} HTTP/1.1Host:ap-guangzhou.cls.tencentcs.comContent-Type:application/json# 请勿修改JSON结构, 仅需修改TODO即可{"logs": [{# TODO:定义需要上传的key-value键值"contents": {"key1": "value1","key2": "value2"},# TODO:定义上传时间戳"time": 123456789}],# TODO:定义来源IP"source": "127.0.0.1"}
方法5:通过 Kafka 协议上传日志
说明:
通过 Kafka 协议匿名上传,在生产端配置中, password 需以
topic_id#${日志主题 ID}
的格式写入,例如:topic_id#76c63473-c496-466b-XXXX-XXXX。