真正的热插拔开源的日志记录组件

前两天发现一个开源日志组件ELMAH，一下子就喜欢上了，喜欢他的原因是它支持“热插拔”（不需要改动任何的程序）、简单的配置（几行配置）、多 种记录方式（数据库、文件、Email）、支持多数据库（Access、SqlServer、Oracle、Sqlite、VistaDB），而且查看结 果也不需要编写（并且支持rss发布查看）。

　　ELMAH最新版本是ELMAH-1.0-BETA3，他是基于HttpModules、HttpHandlers的处理方式，只是记录错误日志不进行处理，不过这已经足够了，我们对于可能发生的异常地方肯定就会做处理的，对于意想不到的异常交给ELMAH就可以了，我们只需给用户提供一个友好的错误页面就可以了。

　　他的用法非常简单，简单的让人无法相信，下面详细介绍他的用法。

　　园子里也有朋友介绍过： 疯狂的石头    一切由.NET开始。

一、下载组件 最新组件点击这里下载ELMAH-1.0-BETA3，把bin文件加的Elmah.dll加入到项目中（他支持net-1.0、  1.1、2.0、3.5）。

二、把db文件夹下的sql脚本执行一下，我们这里选择SQLServer.sql，在你的数据库中会生成一个ELMAH_Error表。

三、配置webconfig 在<configuration>中加入：

<configSections>
    <sectionGroup name="elmah">

　<!-- 提示! ASP.NET1.x把requirePermission="false"去掉 -->
   <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>
    <security allowRemoteAccess="0" /><!--是否允许远程访问。0代表否、1代表是-->
    <errorLog type="Elmah.XmlFileErrorLog, Elmah" logPath="E:/LogHaHa/" /><!--记录到文件-->
   </elmah>

  四、在<system.web>中加入

    <httpHandlers>
        <add verb="POST,GET,HEAD" path="elmah.axd" type="Elmah.ErrorLogPageFactory, Elmah"/>
    </httpHandlers>
    <httpModules>
        <add name="ErrorLog" type="Elmah.ErrorLogModule, Elmah"/>
    </httpModules>

ok大功告成了！简单吧。这样我们就可以查看异常了，我们在程序中制造一个异常，然后输入http://localhost/elmah.axd（根目录下加上elmah.axd就可以了）,也可以在webconfig加入对此页面的权限控制，详细的做法请参考链接资料。

效果图如下：

点击Details后的详细页面：

以rss方式查看：

 

我们主要介绍下<errorLog type="Elmah.XmlFileErrorLog, Elmah" logPath="E:/LogHaHa/" />参数。这里是把日志记录到文件形式。

下面是详细介绍记录到不同地方的参数配置

1）把日志记录到SQL Server 2000 or 2005 

        <errorLog type="Elmah.SqlErrorLog, Elmah"  connectionStringName="此处为connectionString的name" /> 适应ASP.NET2.0

        <errorLog type="Elmah.SqlErrorLog, Elmah" connectionString="Data Source=.;Initial Catalog=ELMAH;Trusted_Connection=True" /> 适应ASP.NET1.x
        
2） 把日志记录到SQLite 适应ASP.NET2.0       1.x不支持
           
        <errorLog type="Elmah.SQLiteErrorLog, Elmah" connectionStringName="..." />
        
           字符串格式如下：
        <connectionStrings>
          <add name="..." connectionString="data source=data source=C:/Elmah.db或~/App_Data/Error.db" />
        </connectionStrings>
3）把日志记录到XML

        <errorLog type="Elmah.XmlFileErrorLog, Elmah" logPath="E:/LogHaHa/" />
 4）把日志记录到Oracle
            
        <errorLog type="Elmah.OracleErrorLog, Elmah" schemaOwner="xxx" />
            connectionStringName="..." />适应ASP.NET2.0

        <errorLog type="Elmah.OracleErrorLog, Elmah" 适应ASP.NET1.x
            schemaOwner="xxx" />
            connectionString="Data Source=xxxx;User ID=username;Password=password" />

5）把日志记录到Access 

　　  <errorLog type="Elmah.AccessErrorLog, Elmah" connectionStringName="..." />适应ASP.NET2.0

        <errorLog type="Elmah.AccessErrorLog, Elmah" 适应ASP.NET1.x
            connectionString="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=|DataDirectory|Elmah.mdb" />
   
6）把日志记录到VistaDB
        
        <errorLog type="Elmah.VistaDBErrorLog, Elmah"
            connectionStringName="..." />

           字符串格式： 
        <connectionStrings>
          <add name="..." connectionString="Data Source='E:/Elmah.vdb3';Open Mode=NonExclusiveReadWrite;Pooling=True" providerName="VistaDB.Provider" />
        </connectionStrings>
            
7)通过电子邮件    
      通过电子邮件发送错误报告。请注意，只有From和To属性是必需的。其余的都是可选的，并可能会被删除。如果服务器不要求身份验证，您必须删除的用户名 和密码属性或设置为空值（导致零长度字符串） 。如果您使用 NET Framework 1.x，那么到属性可能包含多个收件人地址，每个必须划定的分号（ ; ） 。如果您使用的是NET Framework 2.0或更高版本，然后到属性可能包含多个收件人地址，每个必须划定逗号（ ， ） 。

        <errorMail
            from="elmah@example.com"
            to="admin@example.com"
            subject="..."
            async="true|false"
            smtpPort="25"
            smtpServer="smtp.example.com"
            userName="johndoe"
            password="secret" />

另外介绍下载文件夹里面的一个小工具，tools/Cassini 下的Cassini.exe，他是一个虚拟的iis服务器，可以实现多个站点运行，在xp下非常有用，虽然在xp下我们可以用IISAdmin实现多个站 点运行，不过一次只能运行一个网站，这个小工具可以实现任意个站点的同时运行，我们打开文件后在Application Directory选择你的程序所在的目录，Server Port中填上一个现在的iis没有使用的端口号，然后点击start就可以查看网站了。

 PS：相比log4net个人比较喜欢这个，当然还有很多功能没有介绍，希望大家参考资料自己学习，也欢迎大家共同讨论。

参考资料：

http://msdn.microsoft.com/en-us/library/aa479332.aspx    MSDN介绍 http://dotnetslackers.com/articles/aspnet/ErrorLoggingModulesAndHandlers.aspx  作者的网站

 ELMAH-1.0-BETA3 最新版本下载及介绍