帮助中心 > 技术文档 > 客户端SDK > Web 性能监控 SDK > SDK配置

1. 单独使用

1.1. 模块化引入

1.1.1. 安装

安装命令:

npm i hina-cloud-js-monitor
# or
yarn add hina-cloud-js-monitor
# or
pnpm i hina-cloud-js-monitor

1.1.2. 初始化

准备工作:获取数据接收地址,用于上报采集的数据,以下是性能监控的极简配置:

import hinaEpm from 'hina-cloud-js-monitor'

hinaEpm.init({
  serverUrl: '数据接收地址',
})

// 将 SDK 实例赋给全局变量 hinaEpm
window["hinaEpm"] = hinaEpm;

具体配置参数请查看SDK接入

1.2. 离线引入

下载 hina-cloud-js-monitor,文件结构:

├── epm.esm.full.js    # 用于 import 方式
├── epm.full.js        # 用于 CommomJS 方式
└── epm.iife.js        # 用于 Script 标签方式

初始化,以 Script 标签方式为例:

<script src="./hina.iife.js"></script>

<script>
  const hinaEpm = window.hinaEpmStatistic.default;
  // 初始化同1.1.2
  hinaEpm.init(...);
</script>

2. 基于Web JS SDK使用

如果您的项目中已经集成了Web JS SDK,且版本为4.0.2或更高,并且您希望进一步添加性能监控功能,那么您需要额外引入性能监控SDK,引入方法参考1.1.和1.2.章节。以下是一个以性能监控模块化引入的极简配置示例:

import hina from 'hina-cloud-js-sdk'
import { Monitor } from 'hina-cloud-js-monitor'

hina.init({
  serverUrl: '数据接收地址',
  plugins:[
    Monitor
  ],
  performanceErrorConfig: {
    errorCapture: true, // 开启错误信息上报
    performance: true, // 开启性能监控功能
  },
  // 其他属性...
});
作者:张永健  创建时间:2024-04-23 10:57
最后编辑:史志前  更新时间:2025-04-01 16:17