C#组件系列———又一款日志组件：Elmah的学习和分享

前言：好久没动笔了，都有点生疏，12月都要接近尾声，可是这月连一篇的产出都没有，不能坏了“规矩”，今天还是来写一篇。最近个把月确实很忙，不过每天早上还是会抽空来园子里逛逛。一如既往，园子里每年这个时候都有大把的年终总结、回忆过去展望未来之类的文章。博主是没时间写总结了，要学的东西太多。关于Vue的系列一定要抽时间补上。最近刚用了一个日志组件Elmah，比较适合开发阶段异常信息的快速定位与追溯，有兴趣的跟着博主一起来看看吧。

本文原创地址：http://www.cnblogs.com/landeanfen/p/6221403.html

一、组件介绍

ELMAH的全称是The Error Logging Modules And Handlers，翻译过来是错误日志模块和处理。顾名思义，就是一个日志的拦截和处理组件，说到.net的日志组件，大家的第一反应该是Log4Net、NLog等这些东西，关于Log4Net和NLog，可以说是.net日志组件里面使用最为广泛的组件了，它们功能强大、使用方便。相比它们：

1、ELMAH的使用更加简单，它甚至不用写一句代码，只需要引入dll，然后在Web.config里面配置相应的节点即可；

2、按照网上的说法，ELMAH是一种“可拔插式”的组件，即在一个运行的项目里面我们可以随意轻松加入日志功能，或者移除日志功能；

3、ELMAH组件自带界面，不用写任何代码，即可查看异常日志的界面，轻松找到当前异常的详细信息；和web的结合更加紧密；

4、组件提供了一个用于集中记录和通知错误日志的机制，通过邮件的机制通知错误信息给相关人员。

二、组件安装使用

1、安装组件

Elmah的安装使用同样也很简单，我们万能的Nuget帮我们一键搞定。

安装如上图的两个组件即可在MVC项目里面应用起来。注意这里有一个依赖关系Elmah.MVC依赖Elmah.corelibrary组件。

安装成功后，项目中会添加如下两个dll的引用。

2、配置组件

组件安装成功之后，会自动在我们MVC项目的Web.config里面添加如下节点：

<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>

......

<appSettings>
   <add key="elmah.mvc.disableHandler" value="false" />
   <add key="elmah.mvc.disableHandleErrorFilter" value="false" />
   <add key="elmah.mvc.requiresAuthentication" value="false" />
   <add key="elmah.mvc.IgnoreDefaultRoute" value="false" />
   <add key="elmah.mvc.allowedRoles" value="*" />
   <add key="elmah.mvc.allowedUsers" value="*" />
   <add key="elmah.mvc.route" value="elmah" />
   <add key="elmah.mvc.UserAuthCaseSensitive" value="true" /></appSettings>

......

<httpModules>
    <add name="ErrorLog" type="Elmah.ErrorLogModule, Elmah" />
    <add name="ErrorMail" type="Elmah.ErrorMailModule, Elmah" />
    <add name="ErrorFilter" type="Elmah.ErrorFilterModule, Elmah" />
</httpModules>

......

<system.webServer>
  <modules>
    <add name="ErrorLog" type="Elmah.ErrorLogModule, Elmah" preCondition="managedHandler" />
    <add name="ErrorMail" type="Elmah.ErrorMailModule, Elmah" preCondition="managedHandler" />
    <add name="ErrorFilter" type="Elmah.ErrorFilterModule, Elmah" preCondition="managedHandler" />
  </modules>
</system.webServer>

......

<elmah>
</elmah>

除此之外，还需要手动在Web.config里面加入如下配置节点：

<elmah>
    <security allowRemoteAccess="false" />
    <!--三种存储方式：内存、xml、数据库。存储到xml里面格式如下行-->
    <!--<errorLog type="Elmah.XmlFileErrorLog, Elmah" logPath="~/Static/Log/" />-->
    <!--<errorLog type="Elmah.SqlErrorLog, Elmah" connectionStringName="ElmahConn" />-->
</elmah>
  <location path="elmah.axd" inheritInChildApplications="false">
    <system.web>
      <httpHandlers>
        <add verb="POST,GET,HEAD" path="elmah.axd" type="Elmah.ErrorLogPageFactory, Elmah" />
      </httpHandlers>
    </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>

需要说明的是在elmah节点里面可以配置组件支持的三种日志存储方式：

  • 如果elmah节点不配置任何任何东西，表示默认组件是将日志信息保存到内存中，这种方式的弊端在于一旦系统重启，所有的异常信息都会丢失；
  • <errorLog type="Elmah.XmlFileErrorLog, Elmah" logPath="~/Static/Log/" /> 表示日志保存到xml文件里面，第二个属性配置保存xml的路径；
  • <errorLog type="Elmah.SqlErrorLog, Elmah" connectionStringName="ElmahConn" /> 表示日志保存到数据库里面，第二个参数对应数据库的链接字符串的name，也就是说如果配置保存到数据库，则必须要在web.config里面配置连接字符串，这里的connectionStringName就对应我们配置的连接字符串的name，并且这个时候还需要使用脚本在数据库里面新建需要的表和存储过程，这个放在后面说。

3、测试效果

通过以上安装和配置，我们即可记录异常。首先我们采用内存的方式来记录异常，先来看看效果：

public class HomeController : Controller
{
        public ActionResult Index()
        {
            return View();
        }

        //测试异常
        public JsonResult Get()
        {
            var a = 0;
            var b = 5;
            var c = b / a;
            return Json(a, JsonRequestBehavior.AllowGet);
        }
}

然后我们前端ajax来调用

<html>
<head>
    <title>Index</title>
    <script src="~/Scripts/jquery-1.9.1.min.js"></script>
    <script type="text/javascript">
        $(function () {
            $("#btn").click(function () {
                $.ajax({
                    type: ‘get‘,
                    url: ‘/Home/Get‘,
                    data: {},
                });
            });
        });
    </script>
</head>
<body>
    <h1>首页</h1>
    <div>
        <button type="button" id="btn">测试异常</button>
    </div>
</body>
</html>

点击按钮出现异常，然后我们通过地址http://localhost:51230/elmah.axd来查看异常信息。

点击展开详细信息如下

到这一步，我们的组件就可以生效了。但是看到这个elmah.axd这个路径太恶心了，我们想要改一下，用我们自己的路径，呵呵，这个确实是可以配置的。我们再来看看web.config里面的location节点，在location节点里面其实就配置一个东西——HttpHandler，虽然有 system.web 和 system.webServer 两个节点，如果你仔细观察，其实它们是一个东西，只不过是为了兼容不同的IIS版本而写了两个配置，这一点和我们HttpHandler的配置是相同的，对于这个配置不熟悉的，可以看看博主之前的文章http://www.cnblogs.com/landeanfen/p/6000978.html。我们将location的节点改成这样：

  <location path="log.axd" inheritInChildApplications="false">
    <!--<system.web>
      <httpHandlers>
        <add verb="POST,GET,HEAD" path="log.axd" type="Elmah.ErrorLogPageFactory, Elmah" />
      </httpHandlers>
    </system.web>-->
    <system.webServer>
      <handlers>
        <add name="ELMAH" verb="POST,GET,HEAD" path="log.axd" type="Elmah.ErrorLogPageFactory, Elmah" preCondition="integratedMode" />
      </handlers>
    </system.webServer>
  </location>

然后我们通过http://localhost:51230/log.axd这个地址来访问，能达到同样的效果。博主本地使用的是IIS经典模式，所以使用的是system.webServer里面的配置，注释掉或者删掉system.web节点都不会有任何问题。

三、功能介绍

1、将日志信息保存到数据库

上述使用在内存中保存日志信息的方式，在实际项目中基本上很少会用到。除此之外，还有保存到xml和数据库两种方式。保存到xml文件这个没什么好说的，就是配置一下保存路径即可。下面就以保存到数据库的方式来看看想想介绍下。

首先我们在web.config里面加入连接字符串节点。

  <connectionStrings>
    <add name="ElmahConn" connectionString="Data source=127.0.0.1;Initial Catalog=PowerMangent;Persist Security Info=True;User ID=sa;Password=123456" providerName="System.Data.EntityClient" />
    <add name="ElmahContainer" connectionString="metadata=res://*/Elmah.csdl|res://*/Elmah.ssdl|res://*/Elmah.msl;provider=System.Data.SqlClient;provider connection string=&quot;data source=127.0.0.1;initial catalog=PowerMangent;user id=sa;password=123456;MultipleActiveResultSets=True;App=EntityFramework&quot;" providerName="System.Data.EntityClient" />
  </connectionStrings>

然后配置elmah节点

  <elmah>
    <security allowRemoteAccess="false" />
    <errorLog type="Elmah.SqlErrorLog, Elmah" connectionStringName="ElmahConn" />
  </elmah>

最后就是在数据库创建需要的表和存储过程，官方提供了脚本，这个不用我们担心，脚本如下

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]
GO

ALTER TABLE dbo.ELMAH_Error WITH NOCHECK ADD
    CONSTRAINT PK_ELMAH_Error PRIMARY KEY NONCLUSTERED
    (
        ErrorId
    )  ON [PRIMARY]
GO

ALTER TABLE dbo.ELMAH_Error ADD
    CONSTRAINT DF_ELMAH_Error_ErrorId DEFAULT (newid()) FOR [ErrorId]
GO

CREATE NONCLUSTERED INDEX IX_ELMAH_Error_App_Time_Seq ON dbo.ELMAH_Error
(
    [Application] ASC,
    [TimeUtc] DESC,
    [Sequence] DESC
) ON [PRIMARY]
GO

SET QUOTED_IDENTIFIER ON
GO
SET ANSI_NULLS ON
GO

CREATE PROCEDURE dbo.ELMAH_GetErrorXml
(
    @Application NVARCHAR(60),
    @ErrorId UNIQUEIDENTIFIER
)
AS

SET NOCOUNT ON

SELECT
    AllXml
FROM
    ELMAH_Error
WHERE
    ErrorId = @ErrorId
AND
    Application = @Application

GO
SET QUOTED_IDENTIFIER OFF
GO
SET ANSI_NULLS ON
GO

SET QUOTED_IDENTIFIER ON
GO
SET ANSI_NULLS ON
GO

CREATE PROCEDURE dbo.ELMAH_GetErrorsXml
(
    @Application NVARCHAR(60),
    @PageIndex INT = 0,
    @PageSize INT = 15,
    @TotalCount INT OUTPUT
)
AS 

SET NOCOUNT ON

DECLARE @FirstTimeUTC DateTime
DECLARE @FirstSequence int
DECLARE @StartRow int
DECLARE @StartRowIndex int

-- Get the ID of the first error for the requested page

SET @StartRowIndex = @PageIndex * @PageSize + 1
SET ROWCOUNT @StartRowIndex

SELECT
    @FirstTimeUTC = TimeUTC,
    @FirstSequence = Sequence
FROM
    ELMAH_Error
WHERE
    Application = @Application
ORDER BY
    TimeUTC DESC,
    Sequence DESC

-- Now set the row count to the requested page size and get
-- all records below it for the pertaining application.

SET ROWCOUNT @PageSize

SELECT
    @TotalCount = COUNT(1)
FROM
    ELMAH_Error
WHERE
    Application = @Application

SELECT
    errorId,
    application,
    host,
    type,
    source,
    message,
    [user],
    statusCode,
    CONVERT(VARCHAR(50), TimeUtc, 126) + ‘Z‘ time
FROM
    ELMAH_Error error
WHERE
    Application = @Application
AND
    TimeUTC <= @FirstTimeUTC
AND
    Sequence <= @FirstSequence
ORDER BY
    TimeUTC DESC,
    Sequence DESC
FOR
    XML AUTO

GO
SET QUOTED_IDENTIFIER OFF
GO
SET ANSI_NULLS ON
GO

SET QUOTED_IDENTIFIER ON
GO
SET ANSI_NULLS ON
GO

CREATE PROCEDURE dbo.ELMAH_LogError
(
    @ErrorId UNIQUEIDENTIFIER,
    @Application NVARCHAR(60),
    @Host NVARCHAR(30),
    @Type NVARCHAR(100),
    @Source NVARCHAR(60),
    @Message NVARCHAR(500),
    @User NVARCHAR(50),
    @AllXml NTEXT,
    @StatusCode INT,
    @TimeUtc DATETIME
)
AS

SET NOCOUNT ON

INSERT
INTO
    ELMAH_Error
    (
        ErrorId,
        Application,
        Host,
        Type,
        Source,
        Message,
        [User],
        AllXml,
        StatusCode,
        TimeUtc
    )
VALUES
    (
        @ErrorId,
        @Application,
        @Host,
        @Type,
        @Source,
        @Message,
        @User,
        @AllXml,
        @StatusCode,
        @TimeUtc
    )

GO
SET QUOTED_IDENTIFIER OFF
GO
SET ANSI_NULLS ON
GO

CreateElmah.sql

做了以上三步之后，程序里面的异常就能记录到数据库里面，程序再次启动的时候会自动从数据库里面去取对应的信息。

2、程序“吃掉”异常

如果你反编译elmah组件，你会它的原理其实就是通过配置的方式通过HttpModule注册应用程序的Error事件，然后统一处理记录。既然是注册的Application_Error事件，那么肯定就存在某些情况会吃掉异常。

（1）在程序里面try...catch...

这种情况很好理解，如果你再代码里面显示的声明了try...catch那么异常肯定不会进到Application_Error事件里面去，组件也不会记录异常。

（2）在异常捕获器里面处理了异常

除了使用try吃掉异常之外，很多系统里面都会使用异常捕获器去统一捕获异常，如果再异常捕获器里面设置过异常已经处理，组件也不会记录异常。比如：

　　　　protected override void OnException(ExceptionContext filterContext)
        {
            //如果加了这一句，表示异常已经处理，不会尽到应用程序的Error事件里面去
            filterContext.ExceptionHandled = true;

           //........

            base.OnException(filterContext);
        }

这就是异常捕获器统一处理异常，既然这里标识了异常已经处理过，那么组件肯定不会再次处理。可是有些情况下，我们需要处理某些自定义异常，而对于系统异常我们还是希望组件能够记录，这种情况下怎么办呢？其实很简单，这里只需要判断一下，如果是自定义异常信息，这里就加上 filterContext.ExceptionHandled = true; 这一句，而对于其他系统异常，则统一加上这一句即可。这里还是做一个简单的演示供需要的园友参考。

    public class MyException : Exception
    {
        public MyException(string message) : base(message)
        { }
    }

满足一定条件则抛出自定义异常

        public JsonResult Get()
        {
            if (DateTime.Now > Convert.ToDateTime("2016-12-15 10:00:00"))
            {
                //如果满足某些条件则抛出异常
                throw new MyException("当前时间已过期");
            }

            return Json("OK", JsonRequestBehavior.AllowGet);
        }

然后再全局异常处理里面

        protected override void OnException(ExceptionContext filterContext)
        {
            if (filterContext.Exception is MyException)
            {
                //如果加了这一句，表示异常已经处理，不会进到应用程序的Error事件里面去
                filterContext.ExceptionHandled = true;
            }

            base.OnException(filterContext);
        }

这样就能达到我们系统异常记录，自定义异常不记录的目的了。

3、组件权限问题

关于elmah组件，被人诟病的一个重要原因就是其安全问题，如果控制不好很容易招到他人入侵。大神汤姆大叔有篇文章记录这个，有兴趣可以看看。关于我们/elmah.axd路径，我们肯定是需要做一些限制，不能允许每个人都去查看，下面从以下几个方面来完善。

（1）拒绝远程访问

在web.config里面有一个节点配置不允许远程访问。

  <elmah>
    <security allowRemoteAccess="false" />
  </elmah>

（2）拒绝匿名用户访问

对于没有登录到系统的用户，拒绝访问。这个可以在IIS上面配置，当然，我们在web.config里面也要做相应的配置

<location path="log.axd" inheritInChildApplications="false">
    <system.web>
      <authorization>
           <deny users="?"/>
        </authorization>
    </system.web>
  </location>

（3）指定角色或用户访问

可以在应用程序全局配置文件Global.asax里面的认证事件里面去做判断。

protected void Application_AuthenticateRequest(object sender, EventArgs e)
        {
            HttpApplication app = (HttpApplication)sender;
            // 处理日志权限问题
            if (Request.Url.ToString().Contains("elmah.axd"))
            {
                var user = app.Context.User;
                if (user == null)
                {
                    Response.Write("无权限访问");
                    Response.End();
                }
                var userData = (UserInfo)user;
                //管理员角色才能查看
                if (!userData.UserData.IsAdmin)
                {
                    Response.Write("无权限访问");
                    Response.End();
                }

                //或者指定用户才能访问
               //if (userData.UserData.UserName!="administrator")
                //{
                   // Response.Write("无权限访问");
                   //Response.End();
                //}
            }
        }

四、总结

以上总结了组件Elmah组件的使用和一些常见问题的处理。有兴趣的可以看看。欢迎推荐！

本文原创出处：http://www.cnblogs.com/landeanfen/

欢迎各位转载，但是未经作者本人同意，转载文章之后必须在文章页面明显位置给出作者和原文连接，否则保留追究法律责任的权利

时间： 2024-10-12 19:20:49

C#组件系列———又一款日志组件：Elmah的学习和分享的相关文章

JS组件系列——又一款MVVM组件：Vue（二：构建自己的Vue组件）

阅读目录 一.为什么组件很重要 二.Vue里面的组件基础知识 1.组件的概念 2.组件原理 3.组件使用 三.封装自己的Component 1.使用Component封装bootstrapTable 2.封装select 3.查看其他Vue框架源码 四.总结 正文 前言:转眼距离上篇 JS组件系列--又一款MVVM组件:Vue(一:30分钟搞定前端增删改查) 已有好几个月了,今天打算将它捡起来,发现好久不用,Vue相关技术点都生疏不少.经过这几个月的时间,Vue的发展也是异常迅猛,不过这好像和博

C#组件系列——又一款Excel处理神器Spire.XLS，你值得拥有(一)

阅读目录 一.组件介绍 二.组件安装使用 1.官方下载安装 2.Nuget安装 三.组件功能介绍 1.Excel转PDF 2.Excel生成图表 3.其他功能介绍 四.总结 正文 前言:最近项目里面有一些对Excel操作的需求,博主想都没想,NPOI呗,简单.开源.免费,大家都喜欢!确实,对于一些简单的Excel导入.导出.合并单元格等,它都没啥太大的问题,但是这次的需求有两点是NPOI搞不定的: 导入Excel后,需要切割Excel的Sheet页,然后每个Sheet页单独生成一个PDF文件.

JS组件系列——Bootstrap文件上传组件：bootstrap fileinput

原文:JS组件系列--Bootstrap文件上传组件:bootstrap fileinput 前言:之前的三篇介绍了下bootstrap table的一些常见用法,发现博主对这种扁平化的风格有点着迷了.前两天做一个excel导入的功能,前端使用原始的input type='file'这种标签,效果不忍直视,于是博主下定决心要找一个好看的上传组件换掉它.既然bootstrap开源,那么社区肯定有很多关于它的组件,肯定也有这种常见的上传组件吧.经过一番查找,功夫不负有心人,还是被博主找到了这个组件:

C#组件系列——又一款Excel处理神器Spire.XLS，你值得拥有

前言:最近项目里面有一些对Excel操作的需求,博主想都没想,NPOI呗,简单.开源.免费,大家都喜欢!确实,对于一些简单的Excel导入.导出.合并单元格等,它都没啥太大的问题,但是这次的需求有两点是NPOI搞不定的: 导入Excel后,需要切割Excel的Sheet页,然后每个Sheet页单独生成一个PDF文件. 导出Excel的时候,项目里面需要将一些数据表格以图表的形式在Excel里面展示. 找了一圈资料,对于Excel生成pdf,网上的答案千篇一律:使用COM组件的方式,通过调用服务器

JS组件系列——两种bootstrap multiselect组件大比拼

原文:http://www.cnblogs.com/landeanfen/p/5013452.html 前言:今天继续来看看bootstrap的另一个组件:multiselect.记得在项目开始之前,博主项目组几个同事就使用哪些js组件展开过讨论,其中就说到了select组件,由于项目的整体风格使用的bootstrap风格,所以在选用select组件的时候优先考虑和bootstrap结合使用的.其中就找到了两个这种组件,大体样式和功能基本相同,经过一番讨论,项目组决定使用davidstutz的b

JS组件系列——封装自己的JS组件

前言:之前分享了那么多bootstrap组件的使用经验,这篇博主打算研究下JS组件的扩展和封装,我们来感受下JQuery为我们提供$.Extend的神奇,看看我们怎么自定义自己的组件,比如我们想扩展一个$("#id").MyJsControl({})做我们自己的组件,我们该如何去做呢,别急,我们慢慢来看看过程. 一.扩展已经存在的组件 1.需求背景 很多时候,我们使用jquery.ajax的方式向后台发送请求,型如 $.ajax({ type: "post", ur

JS组件系列——封装自己的JS组件，你也可以！

前言:之前分享了那么多bootstrap组件的使用经验,这篇博主打算研究下JS组件的扩展和封装,我们来感受下JQuery为我们提供$.Extend的神奇,看看我们怎么自定义自己的组件,比如我们想扩展一个$("#id").MyJsControl({})做我们自己的组件,我们该如何去做呢,别急,我们慢慢来看看过程. 一.扩展已经存在的组件 1.需求背景 很多时候,我们使用jquery.ajax的方式向后台发送请求,型如 $.ajax({ type: "post", ur

JS组件系列——Bootstrap Select2组件使用小结

前言:在介绍select组件的时候,博主之前分享过一篇JS组件系列——两种bootstrap multiselect组件大比拼,这两个组件的功能确实很强大,只可惜没有图文结合的效果(也就是将图片放入到select里面随着文字一起显示).前两天做一个菜单图标选择的功能,就要用到这个图文选择的功能.于是乎又是找啊找.终于不负所望,找到了我们伟大的select2组件.今天分享下这个组件的一些用法和特性. 一.组件说明以及API说明 Select2使用示例地址:https://select2.githu

JS组件系列——分享自己封装的Bootstrap树形组件：jqTree

前言:之前的一篇介绍了下如何封装自己的组件,这篇再次来体验下自己封装组件的乐趣.看过博主博客的园友应该记得之前分享过一篇树形菜单的使用JS组件系列——Bootstrap 树控件使用经验分享,这篇里面第一个Jquery Tree,只是用简单样式和js去实现了效果,没有给出一个系统的封装,这篇博主就来试试在此样式的基础上封装一个稍微完整点的树形组件. 一.组件效果预览 其实效果和之前的那个差不多,博主只是在之前的基础上加了一个选中的背景色. 全部收起 展开 全部展开 二.代码示例 其实效果很简单,重