网站建设完工后在什么科目核算,中国建设银行招聘网站通知,定制企业网站建设制作,手机网站建设市场0、引言
在上一篇文章中我们简单介绍了 Log4Net 及其核心的三大组件。本文将在上一篇文章的基础上继续探讨与 Log4Net 配置相关的内容。
1、配置
将日志请求插入到应用程序代码中需要进行大量的计划和工作。观察表明#xff0c;大约4%的代码专门用于日志记录。因此#xf…0、引言
在上一篇文章中我们简单介绍了 Log4Net 及其核心的三大组件。本文将在上一篇文章的基础上继续探讨与 Log4Net 配置相关的内容。
1、配置
将日志请求插入到应用程序代码中需要进行大量的计划和工作。观察表明大约4%的代码专门用于日志记录。因此即使是中等规模的应用程序也会在其代码中嵌入数千条日志记录语句。考虑到它们的数量必须管理这些日志语句而不需要手动修改它们。
log4net 环境是完全可编程配置的。但是使用配置文件配置 log4net 要灵活得多。目前配置文件是用 XML 编写的。
让我们在使用 log4net 的虚拟应用程序 MyApp 的帮助下体验一下如何实现这一点。
using Com.Foo;// 导入 log4net 类。
using log4net;
using log4net.Config;public class MyApp
{// 定义一个静态 logger 变量其引用名为 MyApp 的 Logger 实例private static readonly ILog log LogManager.GetLogger(typeof(MyApp));static void Main(string[] args) {// 设置一个简单的配置在控制台进行日志记录。BasicConfigurator.Configure();log.Info(Entering application.);Bar bar new Bar();bar.DoIt();log.Info(Exiting application.);}
}MyApp 首先导入 log4net 相关的类。然后它定义了一个名为 MyApp 的静态 logger 变量该变量恰好是类的完全限定名。
MyApp 使用了下面的 Bar 类:
// 导入 log4net 类。
using log4net;namespace Com.Foo
{public class Bar {private static readonly ILog log LogManager.GetLogger(typeof(Bar));public void DoIt(){log.Debug(Did it again!);}}
}调用 BasicConfigurator.Configure() 方法创建一个相当简单的 log4net 设置。这个方法被硬编码为向 root logger 中添加一个 ConsoleAppender。输出将使用设置为模式 “%-4timestamp [%thread] %-5level %logger %ndc - %message%newline” 的 PatternLayout 来格式化。 注意默认情况下root logger 被分配给 Level.DEBUG。 MyApp 的输出为
0 [main] INFO MyApp - Entering application.
36 [main] DEBUG Com.Foo.Bar - Did it again!
51 [main] INFO MyApp - Exiting application.顺便提一下在 log4net 中子 loggers 只链接到它们现有的祖先。特别的名为 Com.foo.bar 的 logger 直接链接到 root logger从而绕过了未使用的 Com 或 Com.Foo loggers。这将显著提高性能并减少 log4net 的内存占用。
MyApp 类通过调用 BasicConfigurator.Configure() 方法配置 log4net。其他类只需要导入 log4net 命名空间检索它们希望使用的 loggers然后记录日志即可。
前面的示例始终输出相同的日志信息。幸运的是我们可以很容易地修改 MyApp以便在运行时控制日志输出。下面一个稍微修改过的版本。
using Com.Foo;// 导入 log4net 类。
using log4net;
using log4net.Config;public class MyApp
{private static readonly ILog log LogManager.GetLogger(typeof(MyApp));static void Main(string[] args) {// BasicConfigurator 被 XmlConfigurator 取代。XmlConfigurator.Configure(new System.IO.FileInfo(args[0]));log.Info(Entering application.);Bar bar new Bar();bar.DoIt();log.Info(Exiting application.);}
}这个版本的 MyApp 指示 XmlConfigurator 解析配置文件并相应地设置日志记录。配置文件的路径在命令行中指定。
下面是一个示例配置文件其输出与前面基于 BasicConfigurator 的示例完全相同。
log4net!-- A1 被设置为 ConsoleAppender --appender nameA1 typelog4net.Appender.ConsoleAppender!-- A1 使用 PatternLayout --layout typelog4net.Layout.PatternLayoutconversionPattern value%-4timestamp [%thread] %-5level %logger %ndc - %message%newline //layout/appender!-- 将 root logger 级别设置为 DEBUG并将其唯一的 appender 设置为 A1 --rootlevel valueDEBUG /appender-ref refA1 //root
/log4net假设我们不再对查看属于 Com.Foo 包的任何组件的输出感兴趣。下面的配置文件展示了实现这一目标的一种可能方法。
log4net!-- A1 被设置为 ConsoleAppender --appender nameA1 typelog4net.Appender.ConsoleAppender!-- A1 使用 PatternLayout --layout typelog4net.Layout.PatternLayout!-- 以 ISO 8601 格式打印日期 --conversionPattern value%date [%thread] %-5level %logger %ndc - %message%newline //layout/appender!-- 将 root logger 级别设置为 DEBUG并将其唯一的 appender 设置为 A1 --rootlevel valueDEBUG /appender-ref refA1 //root!-- 只打印 Com.Foo 包中 WARN 或更高级别的消息 --logger nameCom.Foolevel valueWARN //logger
/log4net使用该文件配置的 MyApp 的输出如下所示。
2000-09-07 14:07:41,508 [main] INFO MyApp - Entering application.
2000-09-07 14:07:41,529 [main] INFO MyApp - Exiting application.由于 logger Com.Foo.Bar 没有指定的级别因此它从 Com.Foo 处继承其级别Com.Foo 的级别在配置文件中被设置为 WARN。来自 Bar.DoIt 方法的日志语句的级别是 DEBUG低于 logger 的级别 WARN。因此DoIt() 方法的日志请求被抑制。
下面是另一个使用多个 appenders 的配置文件。
log4netappender nameConsole typelog4net.Appender.ConsoleAppenderlayout typelog4net.Layout.PatternLayout!-- 输出调用者的文件名和行号的模式 --conversionPattern value%5level [%thread] (%file:%line) - %message%newline //layout/appenderappender nameRollingFile typelog4net.Appender.RollingFileAppenderfile valueexample.log /appendToFile valuetrue /maximumFileSize value100KB /maxSizeRollBackups value2 /layout typelog4net.Layout.PatternLayoutconversionPattern value%level %thread %logger - %message%newline //layout/appenderrootlevel valueDEBUG /appender-ref refConsole /appender-ref refRollingFile //root
/log4net使用此配置文件调用增强的 MyApp 将在控制台上输出以下内容。 INFO [main] (MyApp.cs:16) - Entering application.
DEBUG [main] (Bar.cs:12) - Doing it again!INFO [main] (MyApp.cs:19) - Exiting application.此外由于 root logger 已经分配了第二个 appender因此输出也将定向到 example.log 文件。该文件将在达到 100KB 时进行滚动覆盖。当滚动覆盖发生时旧版本的 example.log 会自动移动到 example.log.1。
注意要获得这些不同的日志记录行为我们不需要重新编译代码。我们同样可以轻松地将日志记录到电子邮件地址将所有 Com.Foo 的输出重定向到 NT 事件记录器或者将日志事件转发到远程 log4net 服务器该服务器会根据本地服务器策略进行日志记录。
有关使用 XmlConfigurator 配置 Appender 的更多示例请参阅示例 Appender 配置文档。 2、配置属性
可以使用程序集级别assembly-level的属性来配置 log4net而不是以编程方式指定。 XmlConfiguratorAttribute log4net.Config.XmlConfiguratorAttribute 允许使用以下的属性配置 XmlConfigurator ConfigFile 如果指定了该属性这是要与 XmlConfigurator 一起使用的配置文件的文件名。该文件路径相对于应用程序基目录AppDomain.CurrentDomain.BaseDirectory。 此属性不能与 ConfigFileExtension 属性一起使用。 ConfigFileExtension 如果指定了该属性这是配置文件的扩展名。使用程序集文件名作为基本名然后附加这个扩展名。例如如果程序集是从 TestApp.exe 文件加载的并且 ConfigFileExtension 属性设置为 log4net那么配置文件名就是 TestApp.exe.log4net。这等同于将 ConfigFile 属性设置为 TestApp.exe.log4net。 配置文件的路径是通过使用应用程序基目录AppDomain.CurrentDomain.BaseDirectory、程序集文件名和配置文件扩展名来构建的。 此属性不能与 ConfigFile 属性一起使用。 Watch 如果指定了该标志并将其设置为 true则框架将监视配置文件并在每次修改配置文件时重新加载配置。 如果没有指定 ConfigFile 或 ConfigFileExtension 属性则应用程序配置文件例如 TestApp.exe.config将被用作 log4net 配置文件。 使用示例 // 使用 .config 文件配置 log4net
[assembly: log4net.Config.XmlConfigurator(Watchtrue)]
// 这将导致 log4net 在应用程序基目录
//即包含 TestApp.exe 的目录中查找一个
// 名为 TestApp.exe.config 的配置文件。
// 该配置文件将被监视以查看更改。// 使用 .log4net 文件配置 log4net
[assembly: log4net.Config.XmlConfigurator(ConfigFileExtensionlog4net,Watchtrue)]
// 这将导致 log4net 在应用程序基目录
//即包含 TestApp.exe 的目录中查找一个
// 名为 TestApp.exe.log4net 的配置文件。
// 该配置文件将被监视以查看更改。每个程序集只能使用此属性一次。
使用属性可以更清晰地定义应用程序的配置将从何处加载。然而值得注意的是属性是纯粹被动的。它们只是信息。因此如果你使用配置属性你必须调用 log4net 以便它读取属性。一个简单的对 LogManager.GetLogger 的调用将导致读取和处理调用程序集上的属性。因此在应用程序启动的尽可能早的阶段进行日志记录调用是至关重要的当然在加载和调用任何外部程序集之前就更是如此。
3、appSettings
如果你使用属性来配置 log4net则可以使用应用程序配置文件的 appSettings 节的两个设置来覆盖程序集属性中给定的值。
带有 “log4net.Config” 键的设置会覆盖配置文件名并被认为是相对于您的应用程序的基目录带有 “log4net.Config.Watch” 键的设置决定是否应监视文件的更改。
即便程序集属性
[assembly: log4net.Config.XmlConfigurator(Watchfalse)]将应用程序配置为使用配置文件 “TestApp.exe.config” 并且不监视它的更改。但您可以通过在应用程序的配置文件中添加
appSettingsadd keylog4net.Config valuelog4net.config/add keylog4net.Config.Watch valueTrue/
/appSettings来覆盖此设置以使用文件 “log4net.config” 并监视它。 4、配置文件
通常使用文件指定 log4net 配置。该文件可以通过以下两种方式读取
使用 .NET System.Configuration API直接读取文件内容
4.1、.config 文件
System.Configuration API 只有当配置数据在应用程序的配置文件中才可用也就是名为 MyApp.exe.config 或 Web.config 的文件。由于 System.Configuration API 不支持重新加载配置文件因此无法使用 log4net.Config.XmlConfigurator.ConfigureAndWatch 方法来监视配置设置。使用 System.Configuration API 读取配置数据的主要优点是它比直接访问配置文件需要的权限更少。
使用 System.Configuration API 配置应用程序的唯一方法是调用 log4net.Config.XmlConfigurator.Configure() 方法或 log4net.Config.XmlConfigurator.Configure(ILoggerRepository) 方法。
为了在 .config 文件中嵌入配置数据必须使用 configSections 元素将节名称标识给 .NET 配置文件解析器。该节必须指定将用于解析配置节的 log4net.Config.Log4NetConfigurationSectionHandler。这种类型必须完全由程序集限定因为它是由 .NET 配置文件解析器加载的而不是由 log4net 加载的。必须指定 log4net 程序集的正确程序集名称。以下是一个简单的配置文件示例它指定了用于 log4net 节的正确节处理程序。
?xml version1.0 encodingutf-8 ?
configurationconfigSectionssection namelog4net typelog4net.Config.Log4NetConfigurationSectionHandler, log4net //configSectionslog4netappender nameConsoleAppender typelog4net.Appender.ConsoleAppender layout typelog4net.Layout.PatternLayoutconversionPattern value%date [%thread] %-5level %logger [%ndc] - %message%newline //layout/appenderrootlevel valueINFO /appender-ref refConsoleAppender //root/log4net
/configuration在上述示例中指定了 log4net 程序集。该程序集必须位于 .NET 运行时可以找到的位置。例如它可以位于与应用程序相同的目录中。如果 log4net 程序集存储在 GAC 中则必须指定完全限定的程序集名称包括文化、版本和公钥。
当使用 .config 文件指定配置时节名和 XML 元素名必须是 log4net。
4.2、直接读取文件
XmlConfigurator 可以直接读取任何 XML 文件并使用它来配置 log4net。这包括应用程序的 .config 文件也就是名为 MyApp.exe.config 或 Web.config 的文件。不直接读取配置文件的唯一原因是如果应用程序没有足够的权限来读取该文件那么必须使用 .NET 配置 APIs见上文来加载配置。
可以使用接受 System.IO.FileInfo 对象的任何 log4net.Config.XmlConfigurator 方法来指定读取配置的文件。因为可以监视文件系统以获取文件更改通知所以可以使用 ConfigureAndWatch 方法来监视配置文件的修改并自动重新配置 log4net。
此外还可以使用 log4net.Config.XmlConfiguratorAttribute 来指定读取配置的文件。
配置是从文件中的 log4net 元素中读取的。文件中只能指定一个 log4net 元素但它可以位于 XML 层次结构的任何位置。例如它可以是根元素
?xml version1.0 encodingutf-8 ?
log4netappender nameConsoleAppender typelog4net.Appender.ConsoleAppender layout typelog4net.Layout.PatternLayoutconversionPattern value%date [%thread] %-5level %logger [%ndc] - %message%newline //layout/appenderrootlevel valueINFO /appender-ref refConsoleAppender //root
/log4net或者它可以嵌套在其他元素中
?xml version1.0 encodingutf-8 ?
configurationconfigSectionssection namelog4net typeSystem.Configuration.IgnoreSectionHandler //configSectionslog4netappender nameConsoleAppender typelog4net.Appender.ConsoleAppender layout typelog4net.Layout.PatternLayoutconversionPattern value%date [%thread] %-5level %logger [%ndc] - %message%newline //layout/appenderrootlevel valueINFO /appender-ref refConsoleAppender //root/log4net
/configuration上述示例展示了如何将配置数据嵌入到 .config 文件中即使该文件是由 log4net 直接读取的。一个重要的注意事项是如果 .NET 配置文件解析器找到了一个没有使用 configSections 元素注册的元素它将抛出一个异常。因此在上述示例中注册了 log4net 节的名称但指定来处理该节的类型是 System.Configuration.IgnoreSectionHandler。这是一个内置类表示将采用另一种方法来读取配置节。
5、配置语法
log4net 包含一个解析 XML DOM 的配置读取器即 log4net.Config.XmlConfigurator。本节定义了配置器接受的语法。
下面是一个有效的 XML 配置示例。根元素必须是 log4net。注意这并不意味着这个元素不能嵌入到另一个 XML 文档中。有关如何在配置文件中嵌入 XmlConfigurator XML 的更多信息请参见上面的配置文件部分。
log4netappender nameConsoleAppender typelog4net.Appender.ConsoleAppender layout typelog4net.Layout.PatternLayoutconversionPattern value%date [%thread] %-5level %logger [%ndc] - %message%newline //layout/appenderrootlevel valueINFO /appender-ref refConsoleAppender //root
/log4netlog4net 元素支持以下属性
属性描述debug可选属性。值必须为 true 或者 false。默认值为 false。将此属性设置为 true 以启用此配置的内部 log4net 调试。update可选属性。值必须为 “Merge”(合并) 或者 “Overwrite”(覆盖)。默认值为 “Merge”。将此属性设置为 “Overwrite”以便在应用此配置之前重置正在配置的存储库的配置。threshold可选属性。值必须是在存储库上注册的级别的名称。默认值为 ALL。设置此属性以限制在整个存储库中记录的消息而不管消息被记录到哪个 logger。
log4net 元素支持以下子元素
元素描述appender允许 0 个或多个元素。定义一个 appender。logger允许 0 个或多个元素。定义一个 logger 的配置。renderer允许 0 个或多个元素。定义一个 object renderer。root可选元素最多允许一个。定义 root logger 的配置。param允许 0 个或多个元素。存储库特定参数。
6、Appenders
Appender 只能被定义为 log4net 元素的子元素。每个 Appender 必须具有唯一的名称。必须指定 Appender 的实现类型。
下面这个例子展示了一个类型为 log4net.Appender.ConsoleAppender 的 Appender 被定义。这个 Appender 将被称为 ConsoleAppender。
appender nameConsoleAppender typelog4net.Appender.ConsoleAppender layout typelog4net.Layout.PatternLayoutconversionPattern value%date [%thread] %-5level %logger [%ndc] - %message%newline //layout
/appenderappender 元素支持以下属性
属性描述name必要属性。值必须是此 appender 的字符串名称。在此配置文件中定义的所有 appender 中名称必须是唯一的。logger 的 appender-ref 元素使用此名称来引用 appender。type必要属性。值必须是此 appender 的类型名称。如果 appender 没有在 log4net 程序集中定义那么此类型名称必须是完全程序集限定的。
appender 元素支持以下子元素
元素描述appender-ref允许 0 个或多个元素。允许 appender 引用另外的 appenders。并非所有的 appenders 都支持。filter允许 0 个或多个元素。定义此 appender 使用的 filters。layout可选元素最多允许一个。定义此 appender 使用的 layout。param允许 0 个或多个元素。appender 特定参数。
有关配置 appender 的示例请参见示例 Appender 配置文档。
7、Filters
Filters 元素只能定义为 appender 元素的子元素
filter 元素支持以下属性
属性描述type必要属性。值必须是此 filter 的类型名称。如果 filter 没有在 log4net 程序集中定义那么此类型名称必须是完全程序集限定的。
filter 元素支持以下子元素
元素描述param允许 0 个或多个元素。filter 特定参数。
filters 形成了一个事件必须通过的链条。沿途的任何 filter 都可以接受事件并停止过滤处理拒绝事件并停止过滤处理或者允许事件传递到下一个过滤器。如果事件在没有被拒绝的情况下到达过滤器链的末端那么它将被隐式接受并将被记录。
filter typelog4net.Filter.LevelRangeFilterlevelMin valueINFO /levelMax valueFATAL /
/filter上面这个过滤器将拒绝那些级别低于 INFO 或高于 FATAL 的事件。所有在 INFO 和 FATAL 之间的事件都将被记录。
如果我们只想让包含特定子字符串例如 ‘database’的消息通过那么我们需要指定以下 filters
filter typelog4net.Filter.StringMatchFilterstringToMatch valuedatabase /
/filter
filter typelog4net.Filter.DenyAllFilter /第一个过滤器将在事件的消息文本中查找子字符串 ‘database’。如果找到了文本过滤器将接受消息并停止过滤处理消息将被记录。如果没有找到子字符串事件将被传递给下一个过滤器进行处理。如果没有下一个过滤器事件将被隐式接受并将被记录。但是因为我们不希望记录不匹配的事件我们需要使用 log4net.Filter.DenyAllFilter它将拒绝所有到达它的事件。这个过滤器只在过滤器链的末尾有用。
如果我们想允许消息文本中包含 ‘database’ 或 ‘ldap’ 的事件通过我们可以使用以下 filters
filter typelog4net.Filter.StringMatchFilterstringToMatch valuedatabase/
/filter
filter typelog4net.Filter.StringMatchFilterstringToMatch valueldap/
/filter
filter typelog4net.Filter.DenyAllFilter /8、Layouts
Layout 元素只能定义为 appender 元素的子元素。
layout 元素支持以下属性
属性描述type必要属性。值必须是此 layout 的类型名称。如果 layout 没有在 log4net 程序集中定义那么此类型名称必须是完全程序集限定的。
layout 元素支持以下子元素
元素描述param允许 0 个或多个元素。layout 特定参数。
下例展示了如何配置一个使用 log4net.Layout.PatternLayout 的 layout。
layout typelog4net.Layout.PatternLayoutconversionPattern value%date [%thread] %-5level %logger [%ndc] - %message%newline /
/layout9、Root Logger
只能定义一个 root logger 元素它必须是 log4net 元素的子元素。root logger 是 logger 层次结构的根。所有的 logger 最终都从这个 logger 继承。
一个 root logger 示例
rootlevel valueINFO /appender-ref refConsoleAppender /
/rootroot 元素不支持任何属性。
root 元素支持以下子元素
元素描述appender-ref允许 0 个或多个元素。允许 logger 通过名称引用 appenders。level可选元素最多允许一个。定义此 logger 的日志级别。此 logger 只会接受此级别或以上的事件。param允许 0 个或多个元素。logger 特定参数。
10、Loggers
Logger 元素只能定义为 log4net 元素的子元素。
一个 logger 示例
logger nameLoggerNamelevel valueDEBUG /appender-ref refConsoleAppender /
/loggerlogger 元素支持以下属性
属性描述name必要属性。值必须是 logger 的名称。additivity可选属性。值可以为 true 或者 false。默认值为 true。将此属性设置为 false 以防止此 logger 继承父 loggers 上定义的 appenders。
logger 元素支持以下子元素
元素描述appender-ref允许 0 个或多个元素。允许 logger 通过名称引用 appenders。level可选元素最多允许一个。定义此 logger 的日志级别。此 logger 只会接受此级别或以上的事件。param允许 0 个或多个元素。logger 特定参数。
11、Renderers
Renderer 元素只能定义为 log4net 元素的子元素。
一个 renderer 示例
renderer renderingClassMyClass.MyRenderer renderedClassMyClass.MyFunkyObject /renderer 元素支持以下属性
属性描述renderingClass必要属性。值必须是此 renderer 的类型名称。如果该类型没有在 log4net 程序集中定义那么此类型名称必须是完全程序集限定的。这是将负责渲染 renderedClass 的对象的类型。renderedClass必要属性。值必须是此 renderer 的目标类型的类型名称。如果该类型没有在 log4net 程序集中定义那么此类型名称必须是完全程序集限定的。这是此 renderer 将渲染的类型的名称。
renderer 元素不支持任何子元素。
12、Parameters
Parameter 元素可以是许多元素的子元素。有关详细信息请参阅上面的特定元素。
一个 param 示例
param nameConversionPattern value%date [%thread] %-5level %logger [%ndc] - %message%newline /param 元素支持以下属性
属性描述name必要属性。值必须是要在父对象上设置的参数的名称。value可选属性。必须指定 value 或 type 属性之一。该属性的值是一个字符串可以转换为参数的值。type可选属性。必须指定 value 或 type 属性之一。此属性的值是要创建并设置为参数值的类型名称。如果类型没有在 log4net 程序集中定义那么此类型名称必须是完全程序集限定的。
param 元素支持以下子元素
元素描述param允许 0 个或多个元素。Parameter 特定参数。
一个使用嵌套 param 元素的 param 示例
param nameevaluator typelog4net.spi.LevelEvaluatorparam nameThreshold valueWARN/
param13、扩展参数
配置参数直接映射到对象上的可写属性。可用的属性取决于正在配置的对象的实际类型。log4net SDK 文档包含了 log4net 程序集中所有组件的 API 参考。
对于第三方组件请参阅其相关 API 参考以获取可用属性的详细信息。
14、紧凑参数语法
所有参数也可以通过使用参数名称作为元素名称来指定而不是使用 param 元素和 name 属性。
例如一个 param
param nameevaluator typelog4net.spi.LevelEvaluatorparam nameThreshold valueWARN/
param也可以写成
evaluator typelog4net.spi.LevelEvaluatorthreshold valueWARN/
evaluator
