標籤：

監控平台前端SDK開發實踐

01-30

監控平台

監控的重要性和必要性不必多說，這是提高故障處理能力和保障服務質量所必須的一環。

那麼監控究竟要做什麼呢？簡而言之：及時上報錯誤，收集有效信息，提供故障排查依據。

  • 及時上報錯誤：相信每個程序員都有這樣的經驗，發生線上問題後，經由運營或者產品反饋到開發人員，其中流轉過程可能是幾分鐘甚至幾十分鐘，這段時間可能直接導致公司的經濟損失。如果有一個監控系統，在線上出現問題時，監控系統能夠第一時間報警，並且通知到開發人員，那開發人員就可以第一時間修復上線，直接可以使公司損失最小化。
  • 收集有效信息：特別是移動時代，定位一個問題時，需要很多用戶信息(如用戶手機版本，網路情況，操作流程等)。如果沒有監控數據，往往只能靠猜，又或是來回找產品運營甚至出現問題的用戶去溝通定位，其中不可避免的會花費大量的時間。但是如果監控系統里記錄了設備信息，錯誤發生時的場景信息，以及用戶的操作流等程，我們就可以直接根據這些信息進行問題定位，在最短時間內完成故障修復，減小問題的影響面。
  • 提供故障排查依據：監控前端SDK所上報的錯誤信息和其他的記錄信息，其最終目的都是作為我們排查故障的依據，為我們保障服務提供堅實的依靠。

監控分類

所以我們監控平台需要包括記錄型監控和捕捉型監控：

  • 記錄型監控
    • 頁面訪問記錄：用戶訪問了哪些頁面
    • 資源載入記錄：頁面中載入了哪些資源
    • 用戶行為記錄：用戶在頁面上做了哪些操作，目前我們只記錄用戶的點擊行為
    • 介面調用相關記錄：頁面調用了哪些介面
  • 捕捉型監控
    • DNS劫持：頁面是否被劫持
    • 資源載入錯誤：哪些資源載入失敗了，為了捕獲跨域js的錯誤，需要在相應資源標籤上添加crossorigin屬性。
    • 頁面錯誤：頁面渲染過程中出現的錯誤
    • 內部邏輯錯誤：用戶特定操作出現的錯誤，通過用戶行為定位
    • 介面錯誤：調用介面失敗

場景還原法

場景還原是監控面板提供的一個非常有用的功能，它將支撐系統處理過的所有記錄和錯誤按照時間順序展示。通過場景還原的列表，我們可以還原出指定用戶在瀏覽頁面過程中發生的所有事情及其先後順序，從而判斷問題發生的時機和環境。

假設以下場景：

PM：BD反饋用戶在購物車刷不出來啦！

RD：什麼？我試試！我這裡可以看到的呀

PM：商戶反饋，店裡有的用戶可以有的用戶不行

RD：別急，告訴我shopId和打不開的用戶的賬號，我去監控平台上看一下

PM：xxx

RD在監控面板上使用場景還原功能，調出了該用戶的所有信息記錄。發現該用戶是從菜品詳情頁進入的購物車，而再查看正常的用戶都不是從這個入口進的，定位到是菜品詳情頁跳購物車的部分有問題，並立刻進行了修復

在以上這種用戶可能有多種操作的場景中，場景還原法可以針對特定用戶，還原其完整的操作路徑和頁面上發生的所有事情，幫助復現問題。

另外，一些非必現的問題，常常是由於不同機型或環境引起的，也可以在場景還原中復現問題的發生環境予以判斷。

監控平台總體分為三部分：

  • 監控前端SDK：收集用戶端錯誤和相關信息，並進行上報
  • 監控web層支撐系統：處理上報的監控信息
  • 監控面板：提供實時查看上報信息的面板，方便監控數據的便捷使用

本文主要介紹監控前端SDK的實踐經驗，仍有許多需要改進的地方，歡迎大家拍磚，幫助我們改進。

整體設計

如圖所示，整個監控平台分為前端SDK、web層支撐系統和監控面板三大部分，前端SDK運行在前端頁面中，收集監控數據上報到支撐系統里，作為監控面板上查詢的數據源。

就前端SDK來說，可以分為數據模塊、數據處理模塊、上報模塊三大部分，其中數據模塊包括各具體監控數據模塊和環境數據模塊：

  • 數據模塊
    • 各監控模塊：獲取需要上報的具體內容信息（EventData或ErrorData）
      • DNS劫持檢測
      • 資源完整性檢查
      • 資源載入錯誤
      • API監控
      • 全局錯誤
      • 用戶交互
      • 自定義上報
    • 環境模塊：獲取環境數據
  • 數據處理模塊：將環境數據和各內容數據，處理成介面對應的格式，並返回標準格式數據
  • 上報模塊：從環境模塊獲取環境數據，再和內容數據一起根據不同監控類型分發到對應的數據處理模塊。獲取標準數據後發送到node層。

    上報模塊先查看本地緩存數據，將本地數據和新產生的數據一起上報，若上報失敗則存入localStorage

詳細設計

SDK里採用單例模式，包括各監控模塊、環境模塊和上報模塊。

每個具體監控模塊獲取上報模塊實例進行上報，上報模塊內部保證同時只會有一個上報請求。

事件的監聽都在捕獲階段進行，防止因為事件冒泡被阻止而遺漏信息。

環境模塊

環境模塊收集以下環境信息：項目配置信息、web環境數據、jsbridge環境數據

其他的一些諸如UA、isp等web層可以獲取的信息由web層獲取。

該模塊暴露init和getEnv方法

  • init接收用戶配置的環境參數
  • getEnv更新頁面url，再返回當前env對象freeze的一個副本

上報模塊

採取單請求上報的方式，每個用戶同時只會有一條上報請求，每次將當前記錄到的監控信息列表一起上報，成功後再繼續上報。

上報結束之前的新上報記錄都存在localstorage，收到成功消息後刪除已上報數據，繼續上報，不成功的記錄保留在localstorage。此處需注意對localstorage存儲的上限做好控制。

在當前沒有數據正在上報的情況下觸發上報，嘗試將當前localstorage的數據和新數據全部上報，若上報記錄過多，則分條發送。全部發送完或上報失敗，本次上報結束。

各具體監控模塊

DNS劫持

HTTPS頁面被劫持後頁面資源無法獲取，劫持者無利可圖的情況下會降低劫持的動力。

若仍被劫持，前端資源未到達本地，也無法完成上報，只能從網路層去監控。

由於我司已經全量切了HTTPS，因此該模塊不在本監控系統中。

不過之前本團隊做過對HTTP域下的劫持檢測，其檢測思路為請求Node層指定域名下的樣本HTML或JS資源，對比返回結果是否符合預期。

資源完整性檢查

資源完整性檢查模塊的任務是記錄頁面載入了哪些資源，並進行上報。

當我們排查問題時，可以查看當前頁面已經載入成功了哪些資源及其載入順序，排除因為某些資源沒有載入或者載入順序不當而引起錯誤的情況。

資源載入完整性檢查的上報時機分四類，每次將開始監聽到觸發上報之間所有記錄到的已載入資源一起上報，減少上報請求數：

  1. onload：window.onload時觸發
  2. onload_timeout: onload超時（5秒）時觸發
  3. async：window.onload後一定延時（5秒）觸發，上報後停止監聽
  4. hash_change：onhashchange開始監聽，一定延時（5秒）觸發上報，上報後停止監聽

內存中維護一個已載入資源的數組，每次上報後刪除已上報的資源記錄。

資源載入錯誤監控

window上error事件代理，過濾window本身的error

根據標籤類型判斷資源類型，src或href為資源地址

為了捕獲跨域js的錯誤，需要在相應資源標籤上添加crossorigin屬性。

API錯誤監控

同樣採用XMLHttpRequest加hook方式實現。

open時記錄介面url，send後根據status判斷，介面調用失敗時進行上報。

XMLHttpRequest.prototype.open = function open(method, url, bool) {n monitor.originXHR.open.apply(this, [method, url, bool]);n // get something...n // this.ajaxUrl = url;n}nnXMLHttpRequest.prototype.send = function send(_data) {n const self = this;nn this.addEventListener(readystatechange, () => {n if (self.readyState === 4) {n if (self.status !== 200 && self.status !== 304 && this.ajaxUrl !== REPORT_URL) { // filter urlsn // report error infon // ...n // monitor.reporter.report(dataTypes.API_ERROR, error);n }n }n }, false);nn monitor.originXHR.send.apply(this, [_data]);n};n

過濾掉sdk本身的上報地址（防止上報失敗引起循環上報）和一些其他需要忽略的介面地址。

敲黑板，介面訪問url時可能是一個相對路徑，建議補全協議和domain

全局錯誤監控

監聽window上的error事件，過濾事件代理的error。

用戶交互監控

監聽window上捕獲階段的click事件，記錄點擊相關數據。

業務代碼中可以為比較關注的元素添加data屬性，每次點擊將會上報被點擊元素的指定屬性、附加信息和domPath幫助定位該元素。

記錄用戶交互信息可以明確問題發生時，該場景下用戶的具體操作路徑，結合環境數據、資源載入記錄和錯誤數據，整個問題場景就一目了然了。

接入方式

sdk的接入方式分為以下兩種：

  • 先載入sdk
    • 優點：可以記錄頁面載入完成前的情況，載入的資源，以及發生的錯誤
    • 缺點：影響頁面載入速度，直接拷貝在head中，對業務接入不友好
  • 後載入sdk
    • 優點：不影響頁面性能
    • 缺點：只能監控載入成功的頁面，但我們需要關心頁面載入失敗的場景

為了滿足功能需要，當前監控平台v1的引入方式是將壓縮後的sdk代碼直接引入到被監控頁面的head中，並由業務代碼初始化配置項目名稱等。該步操作可以藉助webpack的插件來幫助完成，減輕業務組接入的複雜度。

後續改進方向考慮採用：核心基礎庫+loaders/plugins 的方式，將必須先載入的sdk代碼引入在head中，其餘代碼等頁面載入完成後再非同步添加。

以上就是我們終端團隊監控平台前端SDK部分的實踐分享啦，歡迎大家批評指正，有好的建議也希望能提出來幫助我們改進。我們後續將不斷優化，也將繼續與大家保持討論。耐心看到這裡的讀者，表示十二萬分的感謝~~

（本文始發於稀土掘金：監控平台前端SDK開發實踐 - 掘金）


推薦閱讀：

TAG:前端开发 | 监控 |