前言
@microsoft/applicationinsights-dependencies-js
是微软提供的一款用于浏览器端监控的 JavaScript 库,它可以帮助开发者收集应用程序在浏览器端运行中的性能数据和异常信息,以便于快速定位问题和优化性能。本文将介绍这款 npm 包的使用教程及实际应用场景。
安装
在 npm 环境中安装 @microsoft/applicationinsights-dependencies-js
包可以使用以下命令:
npm install @microsoft/applicationinsights-dependencies-js
使用
引入
在需要记录浏览器端运行信息的页面中,可以将库引入:
import { ApplicationInsights } from '@microsoft/applicationinsights-dependencies-js';
或兼容老版浏览器:
const ApplicationInsights = require('@microsoft/applicationinsights-dependencies-js').ApplicationInsights;
初始化
在引入库后,需要进行初始化配置。可以通过以下参数来完成:
-- -------------------- ---- ------- ----- ----------- - --- --------------------- ------- - ------------------- --------------------------------------------- ---------------------- ----- -- ------- ----- ---------- --------------- -- ---- --- ------- -- -------- --------- --- --------- ---- ------ --- ---- -------- --- ----- --------------------------- ----- -- ------- ----- --------------------- ------ -- ------- ----- ----------- --------- -- ------ ----- -- ---- ----- ----- ------- -- -- - ---
instrumentationKey
是必须的参数,需向 Azure Portal 申请获取:
<script type="text/javascript" src="//az416426.vo.msecnd.net/scripts/a/ai.0.js"></script>
accountId
可选设置,用于设置不同 APP 在同一账户下的不同端点。
enableSessionStorageBuffer
可选设置,开启此选项将在用户浏览器上存储一个缓冲区,是在浏览器关闭并重新打开后持久化事件队列。如果未启用此选项,由于离线存储机制的限制,离线事件将被丢弃。
调用
当参数配置完毕后,就可以开始调用方法了。以下是一些用户行为记录和性能记录的示例代码:
appInsights.trackPageView(); // 记录页面访问事件 appInsights.trackEvent({name: "buttonClick", properties: {color: "blue",}}); // 用户点击事件,携带自定义属性 color 为 blue。 appInsights.trackMetric({name: "user_age", average: 36, sampleCount: 101, min: 21, max: 63}, {user_group: "marketing"}); // 追踪度量指标、平均值和分布计数,还可以结合用户分组信息统计 appInsights.startTrackEvent("buttonTimer"); // 计时器开始 setTimeout(() => {appInsights.stopTrackEvent("buttonTimer", {color: "green"});}, 5000); // 计时器结束,并记录计时时间和自定义属性 appInsights.trackException({exception: new Error("testError")}); // 记录异常事件,捕捉到错误时会自动上报 appInsights.trackTrace({message: "this is a trace message"});// 记录跟踪消息,以供调试时使用
使用场景
@microsoft/applicationinsights-dependencies-js
可以应用于 Web 应用程序的监控与运维,具体场景如下:
性能监控
应用 @microsoft/applicationinsights-dependencies-js
的性能监控功能可以收集浏览器端运行信息,比如页面资源加载时间、用户交互性能、HTTP 请求响应时间等。通过数据抽象和聚合,可有效发现性能瓶颈和优化方案。
异常捕获
@microsoft/applicationinsights-dependencies-js
可以对页面运行过程中抛出的异常自动上报,并在 Azure Portal 上进行展示,开发人员可根据异常信息快速定位问题。
用户行为分析
@microsoft/applicationinsights-dependencies-js
可以记录用户行为数据,如页面访问、按钮点击、滚动行为等,还可以自定义数据集中分析,以便于开发人员深度挖掘用户需求和行为场景。
结语
以上是关于 @microsoft/applicationinsights-dependencies-js
应用的使用方法和场景介绍,希望对前端同学们有所帮助。在实际使用过程中,要注意安全性和合规性问题,并避免使用带有敏感信息的数据进行记录。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/5eedabf6b5cbfe1ea06108f8