文档

使用Web Tracking采集日志

更新时间:

日志服务支持通过Web Tracking采集HTML、H5、iOS和Android平台的日志,并支持自定义维度和指标。本文介绍如何使用Web Tracking采集日志。

什么是Web Tracking采集?

日志服务Web Tracking功能用于在Web应用程序中跟踪用户行为并将行为数据上传到日志服务中,便于您分析用户行为等。您可以通过Web Tracking采集各种浏览器、iOS App或Android App的用户信息,例如:

  • 用户使用的浏览器、操作系统、分辨率等信息。

  • 用户浏览行为记录(例如:用户在网站上的单击行为、购买行为等信息)。

  • 用户在App中的停留时间、是否活跃等信息。

注意事项

  • 使用Web Tracking则表示该Logstore打开互联网匿名写入权限,没有经过有效鉴权,可能产生脏数据。

  • GET请求不支持上传16 KB以上的Body内容。

  • POST请求每次写入的日志数量上限为10 MB。更多信息,请参见PutLogs

开通Web Tracking

  1. 登录日志服务控制台

  2. 在Project列表区域,单击目标Project。

  3. 日志存储 > 日志库页签中,选择目标Logstore右侧的图标 > 修改

  4. Logstore属性页面,单击右上方的修改

  5. 打开WebTracking开关,然后单击保存

您也可使用OpenAPI完成本操作。具体操作,请参见UpdateLogStore

采集方式

开通Web Tracking后,您可以通过以下方法上传日志到Logstore。

客户端SDK

HTTP GET请求

参见如下命令上传日志,请根据实际值替换参数。

curl --request GET 'http://${project}.${host}/logstores/${logstore}/track?APIVersion=0.6.0&key1=val1&key2=val2'

参数

是否必填

说明

${project}

Project名称。

${host}

日志服务所在地域的Endpoint。更多信息,请参见服务入口

${logstore}

Logstore名称。

APIVersion=0.6.0

保留字段。

__topic__=yourtopic

指定日志主题。

key1=val1&key2=val2

您要上传到日志服务的键值对(Key-Value),支持设置多个键值对。

请确保长度小于16 KB。

HTML img标签

<img src='http://${project}.${host}/logstores/${logstore}/track.gif?APIVersion=0.6.0&key1=val1&key2=val2'/>
<img src='http://${project}.${host}/logstores/${logstore}/track_ua.gif?APIVersion=0.6.0&key1=val1&key2=val2'/>

track_ua.gif除了上传自定义的参数外,还会将HTTP头中的UserAgent、referer也作为日志中的字段。

说明

如果您需要采集HTTPS页面的referer,那么上述Web Tracking的链接也必须为HTTPS。

OpenAPI

如果请求的数据量比较大,您可以使用OpenAPI通过POST请求上传数据。具体操作,请参见PutWebtracking

  • 本页导读 (1)
文档反馈