使用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
登录日志服务控制台。
在Project列表区域,单击目标Project。
在
页签中,选择目标Logstore右侧的 。在Logstore属性页面,单击右上方的修改。
打开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。