1. 集成性能监测SDK

步骤一:下载请前往 【性能监测 SDK资源下载

压缩包中提供了两种规范的脚本,您可以根据需要选择所需的脚本。下文描述的同步载入,需要使用 hinaEpm.min.js 文件,ES6模块载入需要使用 hinaEpm.esm.min.js

步骤二:载入 性能监测 SDK

您可以任意选择同步载入或者ES6模块载入的方式去使用 SDK.
在初始化 SDK 的时候需要传入一些配置参数:
serverUrl: 上传数据的 URL,需要进行配置

注意:
采集上报地址serverUrl获取方式,请参考【采集上报地址获取】;

2.载入方式

2.1 同步载入

对于同步载入或者服务端渲染方式,请使用hinaEpm.min.js,将以下代码置入 html 的<head>,在页面头部通过 script src 的方式引入,将以下代码置入初始化代码中,并配置对应参数:

<!--性能监测 SDK BEGIN-->
<script src="./hinaEpm.min.js"></script>
<script>
// 创建 SDK 全局对象
 const hinaEpm = window['hinaEpmStatistic'];
 // 用配置对象初始化 SDK

 hinaEpm.init({
    serverUrl: '数据上报地址' , // 配置采集上报地址URL(在线申请),查看如下【[采集上报地址获取] 链接
    showLog: true, // 开启日志打印
    errorCapture: true, // true表示开启,错误信息采集
    performance: true, // true表示开启,性能信息采集
    sourcemapVersion: '1.0.0', // 对应上传sourcemap的版本号
  });
</script>
<!--Hina SDK END-->

2.2 ES6模块化引入

对于ES6模块化引入,直接放入主文件中使用

import hinaEpm from './hina.esm.min.js'

hinaEpm.init({
    serverUrl: '数据上报地址' , // 配置采集上报地址URL(在线申请),查看如下【[采集上报地址获取] 链接
    showLog: true, // 开启日志打印
    errorCapture: true, // true表示开启,错误信息采集
    performance: true, // true表示开启,性能信息采集
    sourcemapVersion: '1.0.0', // 对应上传sourcemap的版本号
  });

SDK初始化参数说明

参数 默认值 说明
serverUrl 数据接收地址
showLog false 设置 true 后会在网页控制台打 logger,会显示发送的数据,设置 false 表示不显示。
errorCapture true 设置 true 后自动采集和上报页面错误信息。
errorCapture true 设置 true 后自动采集和上报页面性能信息。
sourcemapVersion 需与构建的 sourcemap 文件版本号一致,精准定位错误。
作者:张永健  创建时间:2024-04-23 10:57
最后编辑:王雅军  更新时间:2024-11-20 17:38