匿名日志采集

最近更新时间: 2026-03-13 09:03:00

CLS 日志服务支持免密通过 HTTP 协议将日志上传至 CLS。

使用场景

  • 用户使用的浏览器、操作系统、分辨率等信息。
  • 用户浏览行为记录(例如:用户在网站上的点击行为等信息)。
  • 用户在 App 中的停留时间、是否活跃等信息。

操作步骤

步骤一:日志主题开通匿名访问

注意:

使用匿名采集则表示目标投递日志主题打开匿名访问,没有经过有效鉴权,可能产生脏数据。

  1. 登录日志服务控制台。
  2. 在左侧导航栏中,单击日志主题。
  3. 在日志主题管理页中,单击创建日志主题,或找到已有日志主题并单击编辑,即可创建/编辑日志主题。
  4. 在日志主题创建或编辑弹窗中,找到匿名写入配置项, 并开启开关。

步骤二:上传日志

开通匿名写入后,您可以通过以下方法上传日志到日志主题中。

方法1:通过 HTTP GET 请求上传日志

curl --request GET 'http://data.tcloud-cls-cgi.{{regionName}}.{{domainMain}}:8028/track?topic_id=${topic_id}&key1=val1&key2=val2'
参数 是否必填 说明
${region} 日志主题所在地域。例如:ap-city
${topic_id} 日志主题 ID
key1=val1&key2=val2 您要上传到日志服务的键值对(Key-Value),支持设置多个键值对,由&隔开。请确保长度小于16KB

方法2:通过 HTTP POST 请求上传日志

GET 请求上传日志时,单个请求只能写入一条日志。如果请求的数据量比较大,可以使用 POST 方法上传数据。
接口说明

  • 适用于在网页或者客户端采集日志的场景。
  • 支持将多条日志合并为一次请求。
  • 该接口不支持同时写入多个 Topic 的日志数据。
    请求头
    该接口使用公共请求头,无特殊请求头。
    请求语法
POST http://data.tcloud-cls-cgi.{{regionName}}.{{domainMain}}:8028/tracklog?topic_id=${topic_id} HTTP/1.1
参数 是否必填 说明
${region} 日志主题的地域。例如:ap-city
${topic_id} 日志主题 ID

示例

POST /tracklog?topic_id={topic_id} HTTP/1.1
Host:data.tcloud-cls-cgi.{{regionName}}.{{domainMain}}:8028
Content-Type:application/json
# 请勿修改JSON结构, 仅需修改TODO即可
{
    "logs": [{
        # TODO:定义需要上传的key-value键值
        "contents": {
            "key1": "value1",
            "key2": "value2"
        },
        # TODO:定义上传时间戳
        "time": 123456789
    }],
    # TODO:定义来源IP
    "source": "127.0.0.1"
}