[翻译]ASP.NET 2.0中的健康监测系统（Health Monitoring）(1) - 基本应用

原文地址：http://aspnet.4guysfromrolla.com/articles/031407-1.aspx
[原文源码下载]
[译者改后源码下载]

[align=center][翻译]ASP.NET 2.0中的健康监测系统（Health Monitoring）(1) - 基本应用
[/align]

原文发布日期：2007.03.14
作者：Scott Mitchell
翻译：webabcd

介绍
在程序部署之前，要经历许多软件工程中定义的重要阶段，如需求分析、设计、编码和测试等。 但是，并不是说一旦程序部署并使用之后就脱离软件工程的各个阶段了。 不管一个web程序有多好的设计、多好的编码、多好的测试，它总是会有掉链子的时候。 如数据库服务器掉线，web站点比你凭经验预期的有更大的负载，或者你的web服务器本身的硬件出现问题等。 除非你的程序是很轻量级的或者是上帝给你写的，否则它总是会时不时地蹦出一些问题。

为了发现和诊断这些问题，非常重要的一步就是监视web程序并记录日志。 有很多开源的软件和微软开发的类库可以帮助你记录未处理的异常并通知给开发人员。 如何记录未处理的异常可以参看人性化地响应未处理异常 – 处理未经处理的异常。

ASP.NET 1.x不包括任何内嵌的日志和通知系统，所以需要开发人员写一些代码或者做一些配置。 然而，ASP.NET 2.0提供了内嵌的“健康监测”工具，你可以方便快捷地通过配置来把web站点的一些事件记录到事件日志、数据库、WMI、email或ASP.NET页面跟踪系统。 另外，健康监测系统是使用Provider设计模式（译者注：可以看一下我写的ASP.NET 2.0中实现Provider设计模式的文章）开发的，这样我们就可以实现自己的记录日志的逻辑了。

本文是研究ASP.NET 2.0的健康监测系统的系列文章的第一篇。 我们将在此学一学健康监测系统的基础知识，以及如何建立一个健康监测系统，从而将日志记录到SQL Server数据库。 继续往下看，你会知道得更多！

健康监测系统概述
ASP.NET 2.0的健康监测系统是用来监测运营环境中ASP.NET程序的运行状况的。 它可以记录事件信息到一个指定的日志源中。 例如，它可以记录像程序开始和停止、登录的成功和失败、未处理的异常信息等到一个像Windows事件日志或SQL Server数据库这样的日志源。 配置健康监测系统是非常容易的，只用在Web.config中增加一些配置信息从而指定事件监测者和要发往的日志源即可。

虽然.NET 2.0框架提供了一些内嵌的健康监测事件和日志源，但是当你需要增加自定义事件或换成另一个日志源的时候并不需要更改这些东西。 你可以通过扩展WebBaseEvent类来创建新的事件，通过扩展WebEventProvider类来创建自定义的日志源。 健康监测系统可以在设计模式中使用，并且允许你通过对配置信息的一些改变，从而在程序里添加自定义事件和自定义日志源。

在这个系列文章的未来的内容里，我们将会探讨一下如何创建自定义事件和自定义日志源。 而本文中，我们将只使用内嵌的事件和日志源来做示例。

配置健康监测系统
通过Web.config的<healthMonitoring>元素可以配置健康监测系统，该元素用于指定事件映射、事件订阅规则和日志源。 它们中的每一项都是作为<healthMonitoring>元素的子元素被定义的。 让我们来分别看看这些子元素：
·Event Mappings (<eventMappings>) – 顾名思义，就是一套事件。 它的name会在其它节点中被引用。
·Log Sources (<providers>) - 顾名思义，就是能作为日志源的类型。
·Event Subscription Rules (<rules>) – 与定义在<eventMappings>节点的事件和定义在<providers>节点的日志源相关联。

接下来的这个示例演示了如何将这三个节点结合起来使用。 首先我们定义了一个名为“All Errors”的事件影射，它表示的是所有从WebBaseErrorEvent类继承的事件类。 接下来，定义了一个名为“EventLogProvider”的日志源，它会映射到EventLogWebEventProvider类，其意味着事件信息要被记录到Windows的事件日志中。 最后的名为“All Errors Default”的事件规则描述用来关联“All Errors”事件，并把相关日志记录到“EventLogProvider”日志源中。 像这样定义完Web.config后，如果发生任何未处理异常或明显的错误事件，都将记录到Windows的事件日志中。

<configuration>
<system.web>
<healthMonitoring enabled="true">
<eventMappings>
<clear />
<add name="All Errors" type="System.Web.Management.WebBaseErrorEvent"
startEventCode="0" endEventCode="2147483647" />
</eventMappings>

<providers>
<clear />
<add name="EventLogProvider" type="System.Web.Management.EventLogWebEventProvider" />
</providers>

<rules>
<clear />
<add name="All Errors Default" eventName="All Errors" provider="EventLogProvider"
profile="Default" minInstances="1" maxLimit="Infinite" minInterval="00:00:00" />
</rules>
</healthMonitoring>
</system.web>
</configuration>

在你的Web.config中做了如上配置后，一旦遇到未处理异常，健康监测系统就会自动地将错误的详细信息记录到Windows的事件日志中。 请注意<rules>节点中设置的minInterval属性。 该属性的值用于指定相同的事件在多长时间的间隔后才能被再次记录。 在上面的示例中，我把minInterval的值设置为_00:00:00，其意味着即使发生了相同的事件也都会被记录，打个比方说，如果10秒内某一事件发生了5次，那么这5个事件都会被记录。 当然，你也可以修改这个值。 如果你把minInterval的值设为“00:00:30”，那么首次被触发的事件会被记录。 如果相同的事件在10秒后再次被触发，那么该事件是不会被记录的，因为还没有到我们设置的30秒的间隔时间。 如果要求一旦有事件发生就需要记录的话，那么就要确保minInterval的值为“00:00:00”， 否则可以给minInterval设置成一个较高的合适的值。

本文结束后会有一个web示例程序提供下载，其内有一个网页，网页中有一个按钮，当你单击这个按钮的时候就会触发ApplicationException。 当你访问了这个网页并单击了这个按钮后，就会出现著名的“黄页”，其意味着发生了一个未处理的异常。 之后，该异常信息就会记录到Windows的事件日志中。

发生了未处理异常后所显示的“黄页”



未处理异常的详细信息被记录到了Windows的事件日志中。



健康监测系统的默认配置
默认情况下，ASP.NET 2.0程序已经启用了健康监测系统，并且会记录所有的错误事件和失败的请求到Windows的事件日志中。 所有web程序都需要读取machine级别的Web.config，你可以在该文件中查看或修改健康监测系统的默认功能，此文件的具体位置在“%WINDOWS%\Microsoft.NET\Framework\版本号\CONFIG\”文件夹内。 在上面的示例中，我使用了<clear />，它的作用是在指定我自己的配置之前移除默认设置。

除了指定的“EventLogProvider”日志源外，默认配置中还包括其他两个Provider，如下所示：
·“SqlWebEventProvider” – 使用SqlWebEventProvider类把事件信息记录到SQL Server数据库中。 其默认连接使用的是“LocalSqlServer”所指的连接字符串，它会映射到“App_Data”文件夹内的擜SPNETDB.MDF数据库。 默认情况下，Membership使用的也是这个数据库。 （关于Membership的更多信息请参看Examining ASP.NET 2.0's Membership, Roles, and Profile）
·“WmiWebEventProvider” – 使用WmiWebEventProvider类把事件信息记录到Windows Management Instrumentation(WMI）

虽然在.NET框架中附加了这3个日志源的Provider，但是默认情况下它们并没有包含在<providers>节点内。 如果你想添加这些Provider或是自定义的Provider，那么你需要像我们上面的示例那样在Web.config里添加<prviders>元素。

另外，在<eventMappings>节点下还有一些预定义事件可以让你设置。 我们查看一下machine级别的Web.config文件。

本文接下来的部分将研究一下如何使用“SqlWebEventProvider”日志源，它可以把错误日志记录到SQL Server数据库中。
·配置web程序的健康监测系统，使其记录日志到SQL Server数据库。
·为数据库添加必需的结构信息，使其可以作为日志源而被使用。

如果你给“SqlWebEventProvider”日志源使用的是默认数据存储的话（App_Data文件夹内的ASPNETDB.MDF数据库），那么该数据库会在健康监测系统首次记录事件的时候被自动地创建。 如果你想使用其它数据库，那么就需要用到ASP.NET SQL Server注册工具（aspnet_regsql.exe）了。 你可以在命令行中运行它，如下所示：
aspnet_regsql.exe -E -S serverName -d database -A w
aspnet_regsql.exe -U userID -P password -S serverName -d database -A w

aspnet_regsql.exe程序放置在“%WINDOWS%\Microsoft.NET\Framework\版本号\”文件夹内。 同样在这个文件夹内，你也会发现一个名为“InstallWebEventSqlProvider.sql”的文件，该文件就是创建健康监测系统的数据库结构的T-SQL脚本。

它的结构非常地简单易懂，就是一个表 – aspnet_WebEvent_Events和一个存储过程 – aspnet_WebEvent_LogEvent。 就是这些东西，很简单吧。 当健康监测系统监测到发生了某一事件，并且你已经配置了记录日志到“SqlWebEventProvder”日志源，那么存储过程aspnet_WebEvent_LogEvent将会被执行，从而在aspnet_WebEvent_Events表中添加一条新记录。

未完待续>>