MVC使用 Elmah 日志記錄組件

2019-11-17 02:09:35

字體：大中小

供稿：網(wǎng)友

MVC使用 Elmah 日志記錄組件

2015-06-12 16:10 by jiangys, ... 閱讀, ... 評論, 收藏, 編輯

簡介

ELMAH(ErrorLoggingModulesandHandlers)錯誤日志記錄模塊和處理程序，是一種應(yīng)用廣泛的錯誤日志工具是完全可插拔。它可以動態(tài)添加到一個正在運(yùn)行的 asp.netWeb應(yīng)用程序，甚至是一臺機(jī)器上的所有ASP.NETWeb應(yīng)用程序，而無需重新編譯或重新部署。

ELMAH既支持ASP.NETWebForms又支持ASP.NETMVC。你可以對ELMAH進(jìn)行配置來存儲各種不同的錯誤（xml文件，事件日志，access 數(shù)據(jù)庫，SQL數(shù)據(jù)庫，Oracle數(shù)據(jù)庫，或者計算機(jī)RAM。）你還可以讓ELMAH在錯誤發(fā)生的時候，把錯誤信息email給你。

在默認(rèn)情況下，在一個已經(jīng)安裝ELMAH的網(wǎng)站中，你可以通過請求的elmah.axd頁面的方式來訪問ELMAH。

使用方法

本篇來嘗試Elmah在Asp.netMVC 5使用.

第一步：安裝布署

首先Build空的Asp.netMVC 5 PRoject:

添加Elmah引用:

Elmah組建已經(jīng)配置成功.其實這個過程做了兩件事:

A:將Elmah.dll復(fù)制到程序的根目錄的Bin文件夾下.并當(dāng)前項目的引用.
B:向項目根目錄下Web.Config文件添加如下內(nèi)容

在webConfig文件中添加如下內(nèi)容:

  <configSections>    <sectionGroup name="elmah">      <section name="security" requirePermission="false" type="Elmah.SecuritySectionHandler, Elmah" />      <section name="errorLog" requirePermission="false" type="Elmah.ErrorLogSectionHandler, Elmah" />      <section name="errorMail" requirePermission="false" type="Elmah.ErrorMailSectionHandler, Elmah" />      <section name="errorFilter" requirePermission="false" type="Elmah.ErrorFilterSectionHandler, Elmah" />    </sectionGroup>  </configSections><elmah>    <!--        See http://code.google.com/p/elmah/wiki/SecuringErrorLogPages for         more information on remote access and securing ELMAH.    -->    <security allowRemoteAccess="false" />  </elmah>  <location path="elmah.axd" inheritInChildapplications="false">    <system.web>      <httpHandlers>        <add verb="POST,GET,HEAD" path="elmah.axd" type="Elmah.ErrorLogPageFactory, Elmah" />      </httpHandlers>      <!--         See http://code.google.com/p/elmah/wiki/SecuringErrorLogPages for         more information on using ASP.NET authorization securing ELMAH.      <authorization>        <allow roles="admin" />        <deny users="*" />        </authorization>      -->    </system.web>    <system.webServer>      <handlers>        <add name="ELMAH" verb="POST,GET,HEAD" path="elmah.axd" type="Elmah.ErrorLogPageFactory, Elmah" preCondition="integratedMode" />      </handlers>    </system.webServer>  </location>

第二步：測試使用

HomeController.cs

using System;using System.Collections.Generic;using System.Linq;using System.Web;using System.Web.Mvc;namespace Elmah.Demo.Controllers{    public class HomeController : Controller    {        //        // GET: /Home/        public ActionResult Index()        {            return View();        }        [HttpPost]        public ActionResult GenerateError(string error)        {            throw new ApplicationException(error);        }    }}

index.cshtml

@{    Layout = null;    ViewBag.Title = "Index";}<div>    <input type="text" id="ErrorMsg" />    <button id="GenerateError">生成錯誤日志</button>    <a href="/elmah.axd" target="_blank">在elmah中查看錯誤日志</a></div><script src="~/Scripts/jquery-1.10.2.js"></script><script type="text/javascript">    $("#GenerateError").click(function () {        $.post("/Home/GenerateError?error=" + $("#ErrorMsg").val());    });</script>

運(yùn)行效果如下:

如果不是Post方式，會報黃頁，如：

來看看Elmah是否記錄本次執(zhí)行過程中出現(xiàn)的異常：

可以看到Elmah已經(jīng)如期的撲捉到當(dāng)前應(yīng)用程序的異常.ELMAH在后臺記錄了錯誤信息，并為我們提供了查詢錯誤日志信息的界面，只需要簡單的操作，就完成了基本的需求.

存儲方式

有人可能會問，上面的自動配置中，并沒有指定存儲日志的方式啊（當(dāng)然這里還沒介紹如何配置，但是從上面配置中，似乎也看不到有哪里指定了存儲方式），那這些數(shù)據(jù)存儲在哪里了呢？答案是，NuGet安裝ELMAH后，它是沒有指定任何存儲方式。而ELMAH認(rèn)為，如果沒有指定存儲方式，那么就采用默認(rèn)的內(nèi)存存儲方式（也可以顯式的指定）。但是這種存儲方式只能作為調(diào)試階段使用，生產(chǎn)環(huán)境下不應(yīng)使用此方式，具體的缺點請看下面對內(nèi)存存儲方式的介紹。

接下來就具體介紹各種存儲方式，分別以數(shù)據(jù)庫存儲、文件存儲和內(nèi)存存儲為例，需要強(qiáng)調(diào)一點，ELMAH目前只支持一下三種方式中的任意一種，不支持同時采用多種記錄方式。（想必也沒這個必要）

1.內(nèi)存存儲方式

內(nèi)存存儲，顧名思義，將日志記錄于操作系統(tǒng)分配給應(yīng)用程序的內(nèi)存中。應(yīng)用程序的內(nèi)存是與應(yīng)用程序域相關(guān)的，這可以保證每個應(yīng)用程序只能獲取和記錄屬于自己的日志信息。但是，一旦應(yīng)用程序重啟，之前記錄的信息將會消失。最簡單的例子，如果你用這種方式調(diào)試呢，默認(rèn)是用ASP.NET Development Server作為web服務(wù)器，如果這時停止此服務(wù)器，則就滿足上述條件了（如下圖）。另外，斷電，發(fā)布后IIS的重啟等問題，都會導(dǎo)致記錄的信息丟失。因此，這種方式只能用于測試用。

其實Elmah處理原理.當(dāng)我們請求頁面報錯時.在返回黃頁錯誤時首先被 httpModules中名為ErrorLog模塊進(jìn)行攔截. 該模塊將本次請求出錯的信息保存起來.-默認(rèn)是放置在內(nèi)存中.便于即時調(diào)試.但用戶輸入elmah.axd要查看日志信息時. 首先httpHandlers捕獲到該請求.并交給專門處理elmah.axd的處理程序.該模塊把錯誤日志View返回給用戶.可見Elmah核心技術(shù) 還是基于HttpModules和HttpHandlers來實現(xiàn)的.

2.文件存儲方式

文件存儲實際上ELMAH提供了xml文件的存儲方式，每一個報錯日志信息生成一個xml文件。配置相當(dāng)簡單：

  <elmah>    <!--        See http://code.google.com/p/elmah/wiki/SecuringErrorLogPages for         more information on remote access and securing ELMAH.    -->    <security allowRemoteAccess="false" />    <!--只有這一句就行了，其中l(wèi)ogPath用于指定記錄日志的文件夾位置-->    <errorLog type="Elmah.XmlFileErrorLog, Elmah" logPath="~/Static/Log/" />  </elmah>

該配置必需確認(rèn)LogPath路徑目錄是完整存在的.測試會發(fā)現(xiàn)在本地文件中（/Elmah.Demo/Static/Log）會出現(xiàn)一個XML文件:

3. 數(shù)據(jù)庫存儲方式

在數(shù)據(jù)可視化和管理上數(shù)據(jù)庫依然是最理想的選擇.這里采用SQlServer2008 版本測試.在構(gòu)建Elmah支持SQLServer數(shù)據(jù)支持需要如下三個操作：

a)告訴ELMAH使用哪種數(shù)據(jù)庫作為存儲數(shù)據(jù)庫;
b)告訴ELMAH如何連接到數(shù)據(jù)庫;
c)指定的數(shù)據(jù)庫里，要包含ELMAH需要的表、視圖和存儲過程等（嵌入式數(shù)據(jù)庫不需要此過程）。

其中a和b步驟需要在web.config中指定，c則需要在數(shù)據(jù)庫中添加相關(guān)對象。

web.config配置如下（httpModules以及httpHandlers就不貼了，這里只給出ELMAH記錄日志于sqlserver數(shù)據(jù)庫的配置）：

  <connectionStrings>    <add name="elmah-sqlserver" connectionString="server=.;database=MvcTest;user id=sa;passWord=111111@a" providerName="System.Data.SqlClient" />  </connectionStrings>  <elmah>    <!--        See http://code.google.com/p/elmah/wiki/SecuringErrorLogPages for         more information on remote access and securing ELMAH.    -->    <security allowRemoteAccess="false" />    <!--只有這一句就行了，其中l(wèi)ogPath用于指定記錄日志的文件夾位置-->    <!--<errorLog type="Elmah.XmlFileErrorLog, Elmah" logPath="~/Static/Log/" />-->    <!-- 告訴elmah，我要采用sqlserver來記錄我的日志，連接那個數(shù)據(jù)庫的字符串名為myconnectionString。-->    <errorLog type="Elmah.SqlErrorLog, Elmah" connectionStringName="elmah-sqlserver" />  </elmah>

創(chuàng)建數(shù)據(jù)庫，在該數(shù)據(jù)執(zhí)行如下SQL語句.請參考官方的連接.

Elmah SQL Server Script File:http://code.google.com/p/elmah/source/browse/src/Elmah/SQLServer.sql

腳本：

CREATE TABLE dbo.ELMAH_Error(    ErrorId     UNIQUEIDENTIFIER NOT NULL,    Application NVARCHAR(60) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL,    Host        NVARCHAR(50) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL,    Type        NVARCHAR(100) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL,    Source      NVARCHAR(60) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL,    Message     NVARCHAR(500) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL,    [User]      NVARCHAR(50) COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL,    StatusCode  INT NOT NULL,    TimeUtc     DATETIME NOT NULL,    Sequence    INT IDENTITY (1, 1) NOT NULL,    AllXml      NTEXT COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL ) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]GOALTER TABLE dbo.ELMAH_Error WITH NOCHECK ADD     CONSTRAINT PK_ELMAH_Error PRIMARY KEY NONCLUSTERED    (        ErrorId    )  ON [PRIMARY] GOALTER TABLE dbo.ELMAH_Error ADD     CONSTRAINT DF_ELMAH_Error_ErrorId DEFAULT (newid()) FOR [ErrorId]GOCREATE NONCLUSTERED INDEX IX_ELMAH_Error_App_Time_Seq ON dbo.ELMAH_Error(    [Application] ASC,    [TimeUtc] DESC,    [Sequence] DESC) ON [PRIMARY]GOSET QUOTED_IDENTIFIER ON GOSET ANSI_NULLS ON GOCREATE PROCEDURE dbo.ELMAH_GetErrorXml(    @Application NVARCHAR(60),    @ErrorId UNIQUEIDENTIFIER)ASSET NOCOUNT ONSELECT     AllXmlFROM     ELMA

上一篇：在Gridview如何進(jìn)行每行單元格比較

下一篇：利用IIS應(yīng)用請求轉(zhuǎn)發(fā)ARR實現(xiàn)IIS和tomcat整合共用80端口