說來有趣,ASP.NET 2.0 那套診斷服務一直沒什麼人討論,用的人更少。可是真正在靠它盯站點的人,心裡大概都盤算著同一件事:能不能把瀏覽器端的 JavaScript 錯誤也一起收進診斷日誌?有了這塊拼圖,分析站點不穩定因素時才有足夠的資料可用。
先別急著看微軟的答案。假如由你動手寫一套客戶端診斷服務,思路大概跑不掉這三步:一個 Web Service 負責收錯誤、把它寫進資料庫、再一段 JS 在瀏覽器裡攔下異常並往外送。Futures(May CTP)裡那套客戶端診斷服務本質相同,只是介面抽象得更通用、擴充點留得更多。
使用方式很簡單:在頁面上放一個 Diagnostics 控制項,它唯一的工作就是往客戶端輸出攔截異常用的那段 JS。熟悉 ASP.NET Ajax 控制項設計的人看到這裡應該會心一笑——它理所當然是個 ScriptControl。反過來說,如果你手上有個客戶端元件想以控制項的形式落地到 Page 上,這正是 IScriptControl 介面的用武之地。
新增一支名為 DiagnosticsService.asmx 的 Web Service,並把它的 code-behind 宣告改寫為:
<%@ WebService Language="C#" Class="Microsoft.Web.Preview.Diagnostics.DiagnosticsService, Microsoft.Web.Preview" %>
這行的意思很直接:服務不使用你寫的 code-behind,而是直接指向 DiagnosticsService 這個類別,所需函式全在裡面,你不需要補任何程式碼。那麼記錄資訊的邏輯寫在哪裡?往下看就知道了。
這裡有個風格上的小突兀值得注意:Futures 沒有沿用 ASP.NET Ajax 慣用的 HttpHandler 直接暴露服務,而是要求開發者自己部署 asmx 檔。這個環節未來應該會調整,屆時手動部署的步驟就能省下。
細看 DiagnosticsService,會發現它掛了一個 OnClientException 事件,這才是你要盯的地方。想確保所有客戶端異常都被記錄下來,就在 Global.asax 的 Application_Start 裡綁定它,用 HttpModule 綁也一樣有效。
事件處理函式中,你會從 EventArgs 取得一個 ExceptionServerInfo 型別,其中包含這些欄位:
有了檔名、行號、訊息、來源 IP、時間與瀏覽器資訊,日誌要寫到哪裡就看你——自有資料庫,或 ASP.NET 2.0 的 health monitor 都可以。
先註冊設定區段:
<configSections>
<sectionGroup name="microsoft.web.preview" type="Microsoft.Web.Preview.Configuration.PreviewSectionGroup, Microsoft.Web.Preview">
<section name="diagnostics" type="Microsoft.Web.Preview.Configuration.DiagnosticsSection, Microsoft.Web.Preview"/>
</sectionGroup>
</configSections>
再把服務打開:
<microsoft.web.preview> <diagnostics enabled="true"/> </microsoft.web.preview>
三段設定、一個控制項、一支 asmx,瀏覽器裡那些原本無聲無息消失的腳本錯誤,就變成可以查詢、可以統計、可以追版本的伺服器端記錄了。