正文
前言:好久没动笔了,都有点生疏,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="data source=127.0.0.1;initial catalog=PowerMangent;user id=sa;password=123456;MultipleActiveResultSets=True;App=EntityFramework"" providerName="System.Data.EntityClient" /> </connectionStrings>
然后配置elmah节点
<elmah>
<security allowRemoteAccess="false" /> <errorLog type="Elmah.SqlErrorLog, Elmah" connectionStringName="ElmahConn" /> </elmah>
最后就是在数据库创建需要的表和存储过程,官方提供了脚本,这个不用我们担心,脚本如下
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
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