本文介绍了前端监控中的自定义统计功能。

为帮助您监控和统计轻量级的业务交互行为，ARMS 前端监控提供了以下两类自定义统计功能：

  • 求和统计：用于统计业务中某些事件发生的次数总和，例如某个按钮被点击的次数、某个模块被加载的次数等。

  • 均值统计：用于统计业务中某些事件发生的平均值，例如某个模块加载的平均耗时等。

在上述两类自定义统计功能中，ARMS 都提供了以下三个维度的统计数据（以均值统计为例）：

  • 统计详情

    在统计详情折线图中可以看到指定时间段内该事件的均值数据及样本量趋势。假设统计的是某个模块的耗时数据，那么在统计详情中，可以看到对应时间区间的平均耗时数据和发送的样本数量。

  • 地理分布

    根据中国省市、世界国家的维度统计相应区域内该事件的上报情况。ARMS 前端监控提供区域的上报量、均值及 UV 数据，帮助业务方快速了解该事件在不同区域的差别，从而辅助业务方进行决策。

  • 终端分布

    浏览器、设备、操作系统、分辨率都可能会影响前端页面的性能、兼容性及展示问题，因此 ARMS 前端监控提供这几个维度的均值及样本量情况，让业务方了解到该事件在不同浏览器、设备、操作系统及分辨率上的分布情况。

求和统计 API

在页面中引入前端监控 SDK 后，在业务 JavaScript 文件中使用以下日志上报 API 进行求和统计。

调用参数： __bl.sum(key, value)

调用参数说明：

参数 类型 描述 是否必需 默认值
key String 事件名 是 -
value Number 单次累加上报量，默认 1 否 1

示例：

__bl.sum('event-a');
__bl.sum('event-b', 3);

求均值统计 API

在页面中引入前端监控 SDK 后，在业务 JavaScript 文件中使用以下日志上报 API 进行求均值统计。

调用参数： __bl.avg(key, value)

调用参数说明：

参数 类型 描述 是否必需 默认值
key String 事件名 是 -
value Number 统计上报量，默认 0 否 0

示例：

__bl.avg('event-a', 1);
__bl.avg('event-b', 3);