如何使用小程序Tracking Javascript SDK用户日志 - 日志服务

如果您需要收集和分析用户在小程序的信息，例如用户用的小程序、浏览行为记录、购买行为记录，可以使用WebTracking JavaScript SDK将用户日志直接上传到Logstore。WebTracking JavaScript SDK从小程序端直接上传日志，无需经过业务服务器，降低服务器负载。本文介绍如何使用WebTracking JavaScript SDK上传日志。

前提条件

已开启Logstore的WebTracking功能。WebTracking的功能介绍和开启步骤，请参见使用Web Tracking采集日志。
为了保障数据安全，各个小程序平台要求开发者事先在小程序的管理后台，配置被允许与小程序进行网络通信的服务器域名（request合法域名）。您需要在小程序的request合法域名中，添加日志服务WebTracking使用的安全通信域名，格式为https://${project}.${host}，project和host的含义请参见下文。

使用限制

使用WebTracking 小程序端 JavaScript SDK上传日志，每次写入的日志数量上限为10 MB。关于WebTracking 小程序端 JavaScript SDK的更多信息，请参见SLS WebTracking JavaScript SDK。
WebTracking支持的小程序包括微信小程序、微信小游戏、支付宝小程序、字节跳动小程序、钉钉小程序、QQ小程序、QQ小游戏、百度小程序。

步骤一：安装和配置SDK

已安装Node.js。
在服务器上运行以下代码，安装依赖。
```
npm install --save @aliyun-sls/web-track-mini
```

在您的程序中添加以下代码，配置SDK。

重要

开发快应用（quickApp小程序）时，创建SlsTracker对象前需要根据使用的请求模块额外添加配置项。以使用requesttask模块为例：

//定义quickappSDK对象,将请求API封装成对象
const quickappSDK = {     
      request: requesttask.request
    }

const tracker = new SlsTracker({
      ...opts,
      platformSDK: quickappSDK,
      platformRequestName: 'request',
    })

import SlsTracker from '@aliyun-sls/web-track-mini'

const opts = {
  host: '${host}', // 所在地域的服务入口。例如cn-hangzhou.log.aliyuncs.com
  project: '${project}', // Project名称。
  logstore: '${logstore}', // Logstore名称。
  time: 10, // 发送日志的时间间隔，默认是10秒。
  count: 10, // 发送日志的数量大小，默认是10条。
  topic: 'topic',// 自定义日志主题。
  source: 'source',
  tags: {
    tags: 'tags',
  },
}

const tracker = new SlsTracker(opts)  // 创建SlsTracker对象

参数名称	是否必填	说明
host	是	日志服务所在地域的Endpoint。此处以杭州为例，其它地域请根据实际情况填写。更多信息，请参见服务入口。
project	是	Project名称。
logstore	是	Logstore名称。
time	否	发送日志的时间间隔，默认值为10秒。
count	否	发送日志的数量大小，默认值为10。
topic	否	日志主题。您可以自定义该字段，便于识别。
source	否	日志来源。您可以自定义该字段，以便于识别。
tags	否	日志标签信息。您可以自定义该字段，便于识别。

步骤二：上传日志

上传单条日志时，每条日志单独作为一个对象Object。上传多条日志时，数据结构是包含多个对象Object的数组Array。

单条日志上传，类型为Object，示例：

tracker.send({
  eventType:'view_product',
  productName: 'Tablet',
  price: 500
})

单条日志立即上传（time和count参数不生效），类型为Object，示例：

tracker.sendImmediate({
  eventType:'view_product',
  productName: 'Tablet',
  price: 500
})

批量日志上传，类型为Array，示例：

tracker.sendBatchLogs([
  {
    eventType: 'view_product',
    productName: 'Tablet',
    price: 500
  },
  {
    eventType: 'view_product',
    productName: 'Laptop',
    price: 1200
  }
])

批量日志立即上传（time和count参数不生效），类型为Array，示例：

tracker.sendBatchLogsImmediate([
  {
    eventType:'view_product',
    productName: 'Tablet',
    price: 500
  },
  {
    eventType:'view_product',
    productName: 'Laptop',
    price: 1200
  }
])

步骤三：查看上传结果

日志上传到Logstore后，必须创建索引才能进行查询分析。

快速查看

如果未创建索引，可以在Logstore的查询分析页面，单击消费预览快速查看日志。

查询分析日志

调用CreateIndex创建全文索引或字段索引，如果需要使用SELECT语句，必须创建字段索引。
调用GetLogsV2 - 查询Logstore中的日志数据，返回结果是日志数组Logs，每个元素就是一条日志。

日志服务：WebTracking 小程序端 JavaScript SDK