本文介紹了前端監控中的自訂統計功能。
為協助您監控和統計輕量級的業務互動行為，ARMS前端監控提供了以下兩類自訂統計功能：
求和統計：用於統計業務中某些事件發生的次數總和，例如某個按鈕被點擊的次數、某個模組被載入的次數等。
均值統計：用於統計業務中某些事件發生的平均值，例如某個模組載入的平均耗時等。
在上述兩類自訂統計功能中，ARMS都提供了以下幾個維度統計資料（以均值統計為例）：
- 統計詳情
在統計詳情折線圖中可以看到指定時間段內該事件的均值資料及樣本量趨勢。假設統計的是某個模組的耗時資料，那麼在統計詳情中，可以看到對應時間區間的平均耗時資料和發送的樣本數量。
- PV/UV
在PV/UV折線圖中可以看到指定時間段內該事件的PV和UV統計。
- 地理分布
根據中國省市、世界國家的維度統計相應地區內該事件的上報情況。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);