tencent cloud

日志服务

动态与公告
产品动态
公告
新手指引
产品简介
产品概述
产品优势
地域和访问域名
规格与限制
基本概念
购买指南
计费概述
产品定价
按量计费(后付费)
欠费说明
清理日志服务资源
成本优化
常见问题
快速入门
一分钟入门指南
入门指南
使用 Demo 日志快速体验 CLS
操作指南
资源管理
权限管理
日志采集
指标采集
日志存储
指标存储
检索分析(日志主题)
检索分析(指标主题)
仪表盘
数据处理
投递与消费
监控告警
云产品中心
DataSight 独立控制台
历史文档
实践教程
日志采集
检索分析
仪表盘
监控告警
投递和消费
成本优化
开发者指南
通过 iframe 内嵌 CLS(旧方案)
通过 Grafana 使用 CLS
API 文档
History
Introduction
API Category
Making API Requests
Topic Management APIs
Log Set Management APIs
Index APIs
Topic Partition APIs
Machine Group APIs
Collection Configuration APIs
Log APIs
Metric APIs
Alarm Policy APIs
Data Processing APIs
Kafka Protocol Consumption APIs
CKafka Shipping Task APIs
Kafka Data Subscription APIs
COS Shipping Task APIs
SCF Delivery Task APIs
Scheduled SQL Analysis APIs
COS Data Import Task APIs
Data Types
Error Codes
常见问题
健康监测问题解释
采集相关
检索分析相关
其他问题
服务等级协议
CLS 政策
隐私协议
数据处理和安全协议
联系我们
词汇表

匿名日志采集

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 15:32:33
CLS 日志服务支持通过 Web Tracking 采集 HTML,H5,小程序,IOS 和 Android 等客户端的日志。

使用场景

匿名写入适用于采集各种浏览器,小程序,IOS/Android App 的用户信息。
用户使用的浏览器、操作系统、分辨率等信息。
用户浏览行为记录(例如:用户在网站上的点击行为、购买行为等信息)。
用户在 App 中的停留时间、是否活跃等信息。

操作步骤

步骤1:开通匿名写入

注意:
使用匿名写入则表示目标投递日志主题打开互联网匿名写入权限,没有经过有效鉴权,可能产生脏数据。
1. 登录 日志服务 控制台。
2. 在左侧导航栏中,单击日志主题,在日志主题管理页中,单击创建日志主题,或找到已有日志主题并单击编辑,即可创建/编辑日志主题。
3. 在日志主题创建或编辑弹窗中,找到匿名写入配置项, 并开启开关,即可开启匿名写入。

步骤2:上传日志

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

方法1:通过浏览器 JavaScript SDK 上传日志

详细信息您可参见 通过浏览器 JavaScript SDK 上传日志

方法2:通过小程序 JavaScript SDK上传日志

详细信息您可参见 通过小程序 JavaScript SDK 上传日志

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

参见如下命令上传日志,请根据实际值替换参数。
curl --request GET 'http://{host}/track?topic_id={topic_id}&key1=val1&key2=val2'
参数
是否必填
说明
${host}
日志服务所在地域的 Endpoint。更多信息,请参见 可用地域
${topic_id}
topic id
key1=val1&key2=val2
您要上传到日志服务的键值对(Key-Value),支持设置多个键值对。请确保长度小于16KB

方法4:通过 HTML img 标签上传日志

注意:
Notice: track.gif 除了上传自定义的参数外,还会将 HTTP 头中的 UserAgent 也作为日志中的字段。
<img src='http://${host}/track.gif?topic_id={topic_id}&key1=val1&key2=val2'/>

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

如果请求的数据量比较大,可以使用 POST 方法上传数据。
接口说明
适用于在网页或者客户端采集日志的场景。
使用 Web Tracking 采集日志时,单个请求只能写入一条日志。
针对日志量较大的场景,可以调用 PutWebTracking 接口将多条日志合并为一次请求。
该接口不支持同时写入多个Topic 的日志数据。
请求头
该接口使用公共请求头,无特殊请求头,详情可参见 公共请求参数 文档。
请求语法
POST http://${host}/tracklog?topic_id=${topic_id} HTTP/1.1
参数
是否必填
说明
${host}
日志服务所在地域的 Endpoint。更多信息,请参见 可用地域
${topic_id}
topic id
示例
POST /tracklog?topic_id={topic_id} HTTP/1.1
Host:ap-guangzhou.cls.tencentcs.com
Content-Type:application/json
{
"logs": [{
"contents": {
"key1": "value1",
"key2": "value2"
},
"time": 123456789
}],
"source": "127.0.0.1"
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈