前提條件

• 已開(kāi)啟Logstore的WebTracking功能。WebTracking的功能介紹和開(kāi)啟步驟，請(qǐng)參見(jiàn)使用Web Tracking采集日志。

• 為了保障數(shù)據(jù)安全，各個(gè)小程序平臺(tái)要求開(kāi)發(fā)者事先在小程序的管理后臺(tái)，配置被允許與小程序進(jìn)行網(wǎng)絡(luò)通信的服務(wù)器域名（request合法域名）。您需要在小程序的request合法域名中，添加日志服務(wù)WebTracking使用的安全通信域名，格式為https://${project}.${host}，project和host的含義請(qǐng)參見(jiàn)下文。

使用限制

• 使用WebTracking 小程序端 JavaScript SDK上傳日志，每次寫(xiě)入的日志數(shù)量上限為10 MB。關(guān)于WebTracking 小程序端 JavaScript SDK的更多信息，請(qǐng)參見(jiàn)SLS WebTracking JavaScript SDK。

• WebTracking支持的小程序包括微信小程序、微信小游戲、支付寶小程序、字節(jié)跳動(dòng)小程序、釘釘小程序、QQ小程序、QQ小游戲、百度小程序。

步驟一：安裝和配置SDK

1. 已安裝Node.js。

2. 在服務(wù)器上運(yùn)行以下代碼，安裝依賴(lài)。

   npm install --save @aliyun-sls/web-track-mini

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

   重要

   開(kāi)發(fā)快應(yīng)用（quickApp小程序）時(shí)，創(chuàng)建SlsTracker對(duì)象前需要根據(jù)使用的請(qǐng)求模塊額外添加配置項(xiàng)。以使用requesttask模塊為例：

   //定義quickappSDK對(duì)象,將請(qǐng)求API封裝成對(duì)象
   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}', // 所在地域的服務(wù)入口。例如cn-hangzhou.log.aliyuncs.com
     project: '${project}', // Project名稱(chēng)。
     logstore: '${logstore}', // Logstore名稱(chēng)。
     time: 10, // 發(fā)送日志的時(shí)間間隔，默認(rèn)是10秒。
     count: 10, // 發(fā)送日志的數(shù)量大小，默認(rèn)是10條。
     topic: 'topic',// 自定義日志主題。
     source: 'source',
     tags: {
       tags: 'tags',
     },
   }
   
   const tracker = new SlsTracker(opts)  // 創(chuàng)建SlsTracker對(duì)象

   參數(shù)名稱(chēng)	是否必填	說(shuō)明
   host	是	日志服務(wù)所在地域的Endpoint。此處以杭州為例，其它地域請(qǐng)根據(jù)實(shí)際情況填寫(xiě)。更多信息，請(qǐng)參見(jiàn)服務(wù)入口。
   project	是	Project名稱(chēng)。
   logstore	是	Logstore名稱(chēng)。
   time	否	發(fā)送日志的時(shí)間間隔，默認(rèn)值為10秒。
   count	否	發(fā)送日志的數(shù)量大小，默認(rèn)值為10。
   topic	否	日志主題。您可以自定義該字段，便于識(shí)別。
   source	否	日志來(lái)源。您可以自定義該字段，以便于識(shí)別。
   tags	否	日志標(biāo)簽信息。您可以自定義該字段，便于識(shí)別。