跳到主要内容

部署说明

要实现小程序的性能监控,需要在小程序包中嵌入基调听云小程序JS探针,具体操作步骤如下。

  1. 新建应用名称。

    应用概览页面,单击右上角的添加应用按钮进入新建应用页面,输入小程序名称,保存,小程序名称不可重复。

  2. 下载探针。

    点击下载探针,下载小程序JS探针后,请直接将JS探针放置在小程序程序根目录 (若放到其他目录下,后面的代码探针地址务必同步更改)。

  3. 配置代码,微信小程序、支付宝小程序、钉钉小程序、百度小程序、京东小程序等小程序都可以使用这种方式。

    a. 在项目根目录建立agent文件夹, 将探针tingyun-mp-agent.js,文件名根据实际情况进行修改,复制到agent目录下, 并新建init.js,

目录结构:

|-- agent
|-- tingyun-mp-agent.js // 文件名根据实际情况进行修改
|-- init.js

​ b. 修改init.js

const agent = require('./tingyun-mp-agent.js');
agent.config({
beacon: <数据上传服务器地址>,
key: <应用key>,
id: <账号id>,
sampleRate: 1
});

module.exports = agent;

​ c. 在app.js首行引入探针

// 根据实际路径填写
import './agent/init.js';
// ...

​ d. 如果在相关页面调用探针接口时, 可以import探针对象使用

例如, pages/index/index.js中需要调用探针接口,引入探针示例如下:

// 引入探针对象, 名称设置为Tingyun(可自定义), 路径填写实际路径
import Tingyun from '../../agent/init.js';

Page({
callTingyunAgent() {
// const action = Tingyun.newAction({
// // ...
// })
}
})

注意

  • 探针若放到其他目录下,后⾯的代码探针地址务必同步更改。
  • 探针默认开始插件监控,但微信SDK版本2.6.4以下版本不支持,若需监控,可自定义配置实现,实现方式和对插件支持一样,可查看支持文档
  1. 配置request合法域名。

    复制beacon中域名地址后,在微信小程序后台的开发设置>服务器域名>request合法域名中加入基调听云接收探针数据的服务器地址,如下图:

配置完成,小程序发布后,即可在基调听云小程序控制台看到实时性能数据。