您的位置:首页 > 编程语言 > ASP

在ASP.NET MVC 3中使用日志记录组件Elmah和NLog

2013-03-05 12:36 881 查看
Elmah:主要针对Web应用程序,全局性地捕获应用程序中未处理的异常。

NLog:通用的日志记录组件,与Log4Net属于同类组件。相对于Elmah更通用,不局限于Web应用程序,还可以区分日志级别(详见“使用NLog”一节),但是在错误日志记录方面,需要花费比较多的工夫才能实现Elmah提供的功能。

在ASP.NET MVC应用程序中可以考虑使用这Elmah+NLog进行互补,也可以使用NLog+HandleErrorAttribute实现所有日志的记录。下面就说明一下如何使用Elmah和NLog。

使用Elmah

一、安装与基本配置

1、使用Nuget安装Elmah组件



ElMAH和ELMAH Core Library是必需的组件,如果没有安装ELMAH on MS SQL Sever组件,错误日志将被记录在内存里,一旦应用程序重启,日志就会丢失。这些组件安装之后,会在Web.Config文件中添加一些默认的配置。

2、修改ELMAH的配置。

1)修改ELMAH的数据库连接。

<connectionStrings>
<add name="elmah-sqlserver" connectionString="server=(local);Initial Catalog=PE.LayerArtitecture;Integrated Security=True;" providerName="System.Data.SqlClient" />
</connectionStrings>


2)启用自定义错误页。

在<system.web>节点下添加:

<system.web>
<httpModules>
<add name="ErrorLog" type="Elmah.ErrorLogModule, Elmah" />
<add name="ErrorMail" type="Elmah.ErrorMailModule, Elmah" />
<add name="ErrorFilter" type="Elmah.ErrorFilterModule, Elmah" />
</httpModules>
<customErrors mode="On" defaultRedirect="GenericErrorPage.html" />
</system.web>


说明: GenericErrorPage.html需要自己创建。

3)创建数据表

CREATE TABLE [dbo].[ELMAH_Error](
[ErrorId] [uniqueidentifier] NOT NULL CONSTRAINT [DF_ELMAH_Error_ErrorId]  DEFAULT (newid()),
[Application] [nvarchar](60) NOT NULL,
[Host] [nvarchar](50) NOT NULL,
[Type] [nvarchar](100) NOT NULL,
[Source] [nvarchar](60) NOT NULL,
[Message] [nvarchar](500) NOT NULL,
[User] [nvarchar](50) NOT NULL,
[StatusCode] [int] NOT NULL,
[TimeUtc] [datetime] NOT NULL,
[Sequence] [int] IDENTITY(1,1) NOT NULL,
[AllXml] [ntext] NOT NULL,
CONSTRAINT [PK_ELMAH_Error] PRIMARY KEY NONCLUSTERED
(
[ErrorId] ASC
)WITH (PAD_INDEX  = OFF, STATISTICS_NORECOMPUTE  = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS  = ON, ALLOW_PAGE_LOCKS  = ON) ON [PRIMARY]
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]


至此,即完成了ELMAH的基本配置。

二、查看错误日志

1、在视图上添加一个不存在的Action链接。

<table>
<thead>
<td>分类名称</td>
<td>描述</td>
</thead>
@Html.ActionLink("Error Handle Sample", "Index1");
</table>


2、点击链接“Error Handle Sample”,正常情况下,会出现异常黄屏页面,因为Index1这个Action并不存在。但是因为使用了Elmah进行全局异常控制,所以会跳转到错误页面,并将异常信息记录到错误日志中(需要一定的配置,后面会介绍)。





3、查看错误日志



1)点击Details,可以看到报错黄屏信息:



2)还可以查看报错时,服务器以及客户端的信息:





三、禁止非授权用户查看日志

在Web.Config中,去掉授权配置的注释:



配置完之后,非“admin”角色的用户就会被重定向到登录页。

四、替换掉ASP.NET自带的HandleErrorAttribute过滤器

在Controller的某个Action中使用"Throw new Exception("出错了!")"显示地抛出一个异常,你会发现Elmah并不会记录这个异常,这是因为ASP.NET MVC默认在Global.asax中全局注册了HandleErrorAttribute过滤器,所以程序中出现的异常都会被其捕获;但是,HandleErrorAttribute没有日志记录,所以使用Elmah替换HandleErrorAttribute也是一种常用的做法。实现步骤如下:

1、安装Nuget组件Elmah.MVC



2、确保FilterConfig.cs或者Global.asax中没有注册HandleErrorAttribute(实际上Elmah.MVC组件已经注册了,但是可以通过配置文件控制是否启用该过滤器),也就是说,没有下面这句代码:

filters.Add(new HandleErrorAttribute());


3、按以下参数值配置Web.Config文件

<appSettings>
<add key="webpages:Version" value="2.0.0.0" />
<add key="webpages:Enabled" value="false" />
<add key="PreserveLoginUrl" value="true" />
<add key="ClientValidationEnabled" value="true" />
<add key="UnobtrusiveJavaScriptEnabled" value="true" />
<add key="elmah.mvc.disableHandler" value="false" />
<add key="elmah.mvc.disableHandleErrorFilter" value="true" />
<add key="elmah.mvc.requiresAuthentication" value="false" />
<add key="elmah.mvc.allowedRoles" value="*" />
<add key="elmah.mvc.route" value="elmah" />
</appSettings>


elmah.mvc.disableHandleErrorFilter:是否“禁止使用HandleErrorAttribute”,这里应设置为true;

使用NLog

一、安装NLog组件

通过NGet安装以下三个包:



Nlog包含了日志记录的主要功能,Nlog Configuration为你创建一个Nlog需要使用的空NLog.config文件,NLog Schema for intellisense(TM)在编辑NLog.config时提供智能提示。

二、日志组件API

在日志组件中用得最多的两个类分别是NLog命名空间下的Logger和LoggerManager。Logger代表已经命名的日志来源,并且提供了发出日志信息的方法,而LoggerManager则提供了创建和管理Logger的实例。

需要理解的一点是,Logger只代表日志源信息,而不关心日志的输出位置。日志的输出位置是通过配置文件或者配置API来设置的。

三、创建Logger实例

// 方法1:
using NLog;
Logger logger = LogManager.GetLogger("MyClassName");

// 方法2:
namespace MyNamespace
{
public class MyClass
{
private static Logger logger = LogManager.GetCurrentClassLogger();
}
}


四、日志级别

每条日志消息都有与之关联的日志级别,用来表示该日志有多重要/详细。NLog能够基于Logger的名称和级别来路由(也就是说,确定哪些的日志需要记录到哪些位置)日志消息。

NLog支持以下的日志级别:

Trace - 很细节的信息。一般在开发环境中使用。

Debug - 调试信息, 用得比Trace少, 一般不会再产品环境中使用。

Info - 信息消息,一般在产品环境中启用。 information messages, which are normally enabled in production environment

Warn - 警告消息, 一般用于非关键性的问题,可以恢复或者是临时性的失败。

Error - 错误消息

Fatal - 非常严重的错误

五、发出错误消息

using NLog;

public class MyClass
{
private static Logger logger = LogManager.GetCurrentClassLogger();

public void MyMethod1()
{
logger.Trace("Sample trace message");
logger.Debug("Sample debug message");
logger.Info("Sample informational message");
logger.Warn("Sample warning message");
logger.Error("Sample error message");
logger.Fatal("Sample fatal error message");

// alternatively you can call the Log() method
// and pass log level as the parameter.
logger.Log(LogLevel.Info, "Sample fatal error message");
}
}


六、配置文件

logger.Trace()等等方法,只是在程序里发出日志消息,所以我们还需要在配置文件里设置哪些消息需要被记录下来,以及记录到什么位置(文本文件、数据库,等等)。

1、在<targets>节点下,添加:

<target name="logfile" xsi:type="File" fileName="file.txt" />


代码定义了一个目标位置,用于将日志发送到file.txt文件。

2、在<rules>节点下,添加:

<logger name="*" minlevel="Info" writeTo="logfile" />


这段代码将会将所有(name="*")级别为Info或者更高(包含Info, Warn, Error, Fatal)的日志转发到名为logfile的目标位置。

七、多个目标位置

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<targets>
<target name="logfile" xsi:type="File" fileName="file.txt" />
<target name="console" xsi:type="Console" />
</targets>

<rules>
<logger name="*" minlevel="Trace" writeTo="logfile" />
<logger name="*" minlevel="Info" writeTo="console" />
</rules>
</nlog>


八、特定Logger的路由

可以在配置文件中指定只对某一个组件的日志进行记录。

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<targets>
<target name="logfile" xsi:type="File" fileName="file.txt" />
</targets>

<rules>
<logger name="SomeNamespace.Component.*" minlevel="Trace" writeTo="logfile" final="true" />
<logger name="*" minlevel="Info" writeTo="logfile" />
</rules>
</nlog>


这段代码表示只对以SomeNamespace.Component为前缀命名的组件的日志消息进行记录,final=“true”,表示这是最后一条日志规则,后续规则不会生效。

九、包装器

ImpersonatingWrapper - Impersonates another user for the duration of the write.

AsyncWrapper - 提供异步、缓冲执行日志写入操作。

FallbackGroup - 提供日志写入出错时的反馈。

FilteringWrapper - 基于条件过滤日志记录。 Filters log entries based on a condition.

以异步操作为例:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<targets>
<target name="asyncFile" xsi:type="AsyncWrapper">
<target name="logfile" xsi:type="File" fileName="file.txt" />
</target>
</targets>

<rules>
<logger name="*" minlevel="Info" writeTo="asyncFile" />
</rules>
</nlog>


十、布局

设置日志的输出格式

<target name="logfile" xsi:type="File" fileName="file.txt" layout="${date:format=yyyyMMddHHmmss} ${message}" />


十一、在ASP.NET MVC 3中使用NLog记录用户操作

需求:使用日志记录一个访问的UserName、Controller、Action、时间戳。

1、增加名为UserTrackerLogAttribute的Filter

public class UserTrackerLogAttribute : ActionFilterAttribute, IActionFilter
{
private static Logger logger = LogManager.GetCurrentClassLogger();
public override void OnActionExecuted(ActionExecutedContext filterContext)
{
var actionDescriptor= filterContext.ActionDescriptor;
string controllerName = actionDescriptor.ControllerDescriptor.ControllerName;
string actionName = actionDescriptor.ActionName;
string userName = filterContext.HttpContext.User.Identity.Name.ToString();
DateTime timeStamp = filterContext.HttpContext.Timestamp;
string routeId=string.Empty;
if (filterContext.RouteData.Values["id"] != null)
{
routeId = filterContext.RouteData.Values["id"].ToString();
}
StringBuilder message = new StringBuilder();
message.Append("UserName=");
message.Append(userName + "|");
message.Append("Controller=");
message.Append(controllerName+"|");
message.Append("Action=");
message.Append(actionName + "|");
message.Append("TimeStamp=");
message.Append(timeStamp.ToString() + "|");
if (!string.IsNullOrEmpty(routeId))
{
message.Append("RouteId=");
message.Append(routeId);
}

logger.Log(message.ToString());
base.OnActionExecuted(filterContext);
}
}


2、在需要记录操作的Action中标记自定义的Filter

[UserTrackerLog]
public ActionResult Index()
{
return View();
}


3、配置文件沿用上文target的name属性值为“logfile”的配置。

4、使用Legit Log Viewer可视化查看~/Logs/下的日志文件。

十二、将日志记录到Sql Server

1、创建数据表

CREATE TABLE [dbo].[NLog_Error](
[Id] [int] IDENTITY(1,1) NOT NULL,
[time_stamp] [datetime] NOT NULL,
[host] [nvarchar](max) NOT NULL,
[type] [nvarchar](50) NOT NULL,
[source] [nvarchar](50) NOT NULL,
[message] [nvarchar](max) NOT NULL,
[level] [nvarchar](50) NOT NULL,
[logger] [nvarchar](50) NOT NULL,
[stacktrace] [nvarchar](max) NOT NULL,
[allxml] [ntext] NOT NULL,
CONSTRAINT [PK_NLogError] PRIMARY KEY CLUSTERED
(
[Id] ASC
)WITH (PAD_INDEX  = OFF, STATISTICS_NORECOMPUTE  = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS  = ON, ALLOW_PAGE_LOCKS  = ON) ON [PRIMARY]
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
GO
ALTER TABLE [dbo].[NLog_Error] ADD  CONSTRAINT [DF_NLogError_time_stamp]  DEFAULT (getdate()) FOR [time_stamp]
GO


2、配置Nlog.Config

<targets>
<target xsi:type="Database" name="databaselog">
<dbProvider>System.Data.SqlClient</dbProvider>
<connectionString>server=(local);Initial Catalog=PE.LayerArtitecture;Integrated Security=True;</connectionString>
<commandText>
insert into NLog_Error ([time_stamp],[level],[host],[type],[source],[logger],[message],[stacktrace],[allxml]) values(@time_stamp,@level,@host,@type,@source,@logger,@message,@stacktrace,@allxml);
</commandText>
<parameter name="@time_stamp" layout="${date}" />
<parameter name="@level" layout="${level}" />
<parameter name="@host" layout="${machinename}" />
<parameter name="@type" layout="${exception:format=type}" />
<parameter name="@source" layout="${callsite:className=true:fileName=false:includeSourcePath=false:methodName=false}" />
<parameter name="@logger" layout="${logger}" />
<parameter name="@message" layout="${message}" />
<parameter name="@stacktrace" layout="${exception:stacktrace}" />
<parameter name="@allxml" layout="${xml-encode}" />
</target>
</targets>
<rules>
<!-- add your logging rules here -->
<logger minlevel="Info" name="*" writeTo="databaselog" />
</rules>
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: