Log“.NET研究”4Net 全方位跟踪程序运行

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介:   前端日子自己写了一个简单的日志跟踪程序,现在目前正在做的一个项目中使用以便于跟踪程序异常和运行状况,但是被否认了!可能是没有权威性,于是自己总结了一下Log4net日志跟踪系统,这里分享大家学习一下。

  前端日子自己写了一个简单的日志跟踪程序,现在目前正在做的一个项目中使用以便于跟踪程序异常和运行状况,但是被否认了!可能是没有权威性,于是自己总结了一下Log4net日志跟踪系统,这里分享大家学习一下。当然写这个文章的人太多了,这里不是做任何攀比,只是简单的分享供有需要的人。

  一. Log4Net 简介

  Log4net 是 Apache 下一个开放源码的项目,它是Log4j 的一个克隆版。我们可以控制日志信息的输出目的地。Log4net中定义了多种日志信息输出模式。 

  在做项目的时候令我最头疼的是在程序发布到正式环境之后出现了问题,我们不能调试而且问题很难重新,于是我们需要大量的日志数据来精确的跟踪程序的运行状况。 

  Log4net就可以帮我来解决这一个难题,对于日志的输出我们不需要人为的去干涉,它可以根据需要将日志输出到控制台,文本文件,windows 日志事件查看器中,包括数据库,邮件等等位置,以便我们快速跟踪程序bug。 

  二. Log4Net 简单使用

  使用Log4net必须引入log4net.dll 文件,因为log4net 是开源的,所以可以直接将源码添加到工程项目中去。然后生成新的dll文件。

  下面使用配置一个最简单的文件输出和控制台输出。 

  Log4Net 的配置文件,此段内容添加到App.config 或者 web.config 文件中:

 
 
< configSections >
< section name ="log4net" type ="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
</ configSections >
< log4net >
< appender name ="FileAppender" type ="log4net.Appender.FileAppender" >
< file value ="D:\a.log" ></ file >
< appendToFile value ="true" ></ appendToFile >
< 上海徐汇企业网站制作e="color: #800000;">layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="[%d]:%n%m%n" ></ conversionPattern >
</ layout >
</ appender >
< appender name ="ConsoleAppender" type ="log4net.Appender.ConsoleAppender" >
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="[%d]:%n%m%n" ></ conversionPattern >
</ layout >
</ appender >
< root >
< level value ="INFO" ></ level >
< appender-ref ref ="FileAppender" ></ appender-ref >
< appender-ref ref ="ConsoleAppender" ></ appender-ref >
</ root >
< logger name ="MyLogger" >
< level value ="ERROR" ></ level >
< appender-ref ref ="FileAppender" ></ appender-ref >
< appender-ref ref ="ConsoleAppender" ></ appender-re上海企业网站制作f >
</ logger >
</ log4net >

  控制台程序测试例子:

 
 
ILog log = LogManager.GetLogger( " MyLogger " );
static void Main( string [] args)
{
log4net.Config.XmlConfigurator.Configure();
Program program
= new Program();
program.log.Info(
" >>>>>>>>>>>>>> " );
program.log.Info(
" >>>>>>>>>>>>>>1 " );
program.log.Info(
" >>>>>>>>>>>>>>2 " );
}

  对于已经熟练使用log4net的同学们来说,这段代码自然是小儿科。但对于新手来说这段配置理解还是有一定难度的,下面逐步解说配置以及程序的使用。在实际应用中log4net可能要比更加复杂,它要根据各种环境和要求来引用生成不同的日志。上面的程序代码只是将日志以文件格式和控制格式输出。如果有兴趣,可以将上述代码拷贝到自己的程序中去运行一次看看结果。上述例子是不会输出任何日志信息的,因为配置级别的限制。 

  三. Log4Net 结构

  Log4net 主要分为5个核心组件: Logger, Appender, Filter, Layout, Object Render。 

  Logger: 

  主要用于记录日志的分类和控制日志的级别。它可以以多种格式输出日志信息,同时它也可以控制日志的输出级别。上面的简单例子我们看似做了日志输出,但是没有输出任何日志结果,因为我们在日志级别上做了限制。 

  Appender: 

  这里我们简单称之为“附着器”。意思就是说日志的输出必须依赖于它,更确切的说以文本形式输出,还是控制台格式输出都必须要依靠它来控制。Log4net定义了多种附着器:

  (1) AdoNetAppender 将日志记录到数据库中。可以采用SQL和存储过程两种方式 。

  (2) AnsiColorTerminalAppender 在ANSI 窗口终端写下高亮度的日志事件。 

  (3) AspNetTraceAppender 能用asp.net中Trace的方式查看记录的日志。

  (4) BufferingForwardingAppender 在输出到子Appenders之前先缓存日志事件。

  (5) ConsoleAppender 将日志输出到控制台。

  (6) EventLogAppender 将日志写到Windows Event Log。

  (7) FileAppender 将日志写到文件中。 

  (8) MemoryAppender 将日志存到内存缓冲区。 

  (9) NetSendAppender 将日志输出到Windows Messenger service,这些日志信息将在用户终端的对话框中显示。

  (10) RemoteSyslogAppender 通过UDP网络协议将日志写到Remote syslog service。

  (11) RemotingAppender 通过.NET Remoting将日志写到远程接收端。

  (12) RollingFileAppender 将日志以回滚文件的形式写到文件中。 

  (13) SmtpAppender 将日志写到邮件中。

  (14) TraceAppender 将日志写到.NET trace 系统。

  (15) UdpAppender 将日志connectionless UDP datagrams的形式送到远程宿主或以UdpClient的形式广播。

  Filter:

  Appender 是将日志以缺省值的方式输出,意思就是按照默认值的方式输出。而Filter 意思就是过滤器,使用Filter 可以将日志以不同格式来输出。

  Layout:

  这个用于控制日志输出显示格式。

  Object Render:

  用于按照用户自定义标准来输出日志。

  Log4net 结构图 (从其他地方截图过来)

  Log4net 的日志对象管理器LogManager:LogManager是用于来管理所有的Logger对象的,GetLogger() 可以用来查找已经存在的Logger对象,如果对象不存在它会自动创建一个Logger对象,并且管理它。

  四. Log4Net 日志级别

  Log4net 分为如下几个级别:

  FATAL  毁灭级别

  ERROR 错误级别

  WARN 警告级别

  INFO 消息级别

  DEBUG 调试级别

  这几种日志级别高低:FATAL> ERROR> WARN > INFO > DEBUG。

  只有日志输出级别大于或等于配置的级别才能输出日志信息。

  比如我的日志配置级别为INFO,那么只有log.Info(), log.Warn(), log.Error(), log.Fatal()才能输出日志信息,Debug方式就不能输出。

  Log4net中还有两种特殊的配置级别: ALL - 允许所有的日志级别输出,OFF - 拒绝所有的日志级别输出。

  五. Log4Net 配置说明

 
 
< configSections >
< section name ="log4net" 上海闵行企业网站设计与制作yle="color: #ff0000;"> type ="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
</ configSections >
< log4net >
<!-- 记录日志到数据库 -->
< appender name ="AdoNetAppender" type ="log4net.Appender.AdoNetAppender" >
< bufferSize value ="100" />
< connectionType value ="System.Data.SqlClient.SqlConnection, System.Data, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
< connectionString value ="data source=GAS-HECHEN;initial catalog=dsc141051_db;integrated security=false;persist security info=True;User ID=sa;Password=000000" />
< commandText value ="INSERT INTO Log ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date, @thread, @log_level, @logger, @message, @exception)" />
< parameter >
上海网站建设
< parameterName value ="@log_date" />
< dbType value ="DateTime" />
< layout type ="log4net.Layout.RawTimeStampLayout" />
</ parameter >
< parameter >
< parameterName value ="@thread" />
< dbType value ="String" />
< size value ="255" />
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="%thread"上海闵行企业网站制作span style="color: #ff0000;"> />
</ layout >
</ parameter >
< parameter >
< parameterName value ="@log_level" />
< dbType value ="String" />
< size value ="50" />
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="%level" />
</ layout >
</ parameter >
< parameter >
< parameterName value ="@logger" />
< dbType value ="String" />
< size value ="255" />
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="%logger" />
</ layout >
</ parameter >
< parameter >
< parameterName value ="@message" />
< dbType value ="String" />
< size value ="4000" />
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="%message" />
</ layout >
</ parameter >
< parameter >
< parameterName value ="@exception" />
< dbType value ="String" />
< size value ="2000" />
< layout type ="log4net.Layout.ExceptionLayout" />
</ parameter >
</ appender >

<!-- 输入日志到控制台 -->
< appender name ="ConsoleAppender" type ="log4net.Appender.ConsoleAppender" >
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="[时间]:%d%n[级别]:%p%n[内容]:%m%n%n" ></ conversionPattern >
</ layout >
</ appender >

< appender name ="FileAppender" type ="log4net.Appender.FileAppender" >
< param name ="file" value ="D:\a.log" ></ param >
< param name ="appendToFile" value ="true" ></ param >
< layout type ="log4net.Layout.PatternLayout" >
< conversionPattern value ="[时间]:%d%n[级别]:%p%n[内容]:%m%n%n" ></ conversionPattern >
</ layout >
</ appender >

< root >
< level value ="INFO" ></ level >
< appender-ref ref ="FileAppender" ></ appender-ref >
< appender-ref ref ="ConsoleAppender" ></ appender-ref >
</ root >
< logger name ="MyLogger" >
< level value ="INFO" ></ level >
< appender-ref ref ="FileAppender" ></ appender-ref >
< appender-ref ref ="ConsoleAppender" ></ appender-ref >
</ logger >
</ log4net >

  这个配置文件定义了三种不同的Appender,分别是ADO.NET 记录到数据,ConsoleAppender 从控制台输出, FileAppender 日志信息文件输出。

  然而Log4Net 的配置附着器远不止这些,这里上传一个比较全的附着器配置文件供大家参考 点击下载

  根据上面的日志配置文件仍然使用如下代码测试:

  这里需要注意,log4net.Config.XmlConfigurator.Configure();   这个相当于初始化Log4net, 如果是在Web程序中,我们可以将这句话添加到 Global.asax 文件的Application_Start(object sender, EventArgs e) 方法中,在程序启动的时候就初始化配置信息。

  上面的程序运行结果图,控制台输出结果为:

 

  信息记录到指定的磁盘文件中,记录的结果如下图:

  这里说明两个配置:

  这里的 root 和 logger 配置节点,root 就相当于默认的日志对象配置,而logger是指定特定的日志配置。他们可以共存。

  对于这两个节点下面都有 level 和 appender-ref 节点,分别用于指定日志的输出级别和引用哪些附着器。每个日志对象都可以使用多个appender,这里的配置同时使用文件输出和控制台输出。得到的结果就是上面两个结果图。

  下面的logger对象添加了AdoNetAppender附着器,当使用MyLogger日志对象的时候就会使用这三种不同的方式记录日志。

  上面的程序声明了两个日志对象 log 和 log1,log 是在初始化的时候存在的,它得到的是<logger name="MyLogger"> 这个日志对象,而log1 是 LogManager 中不存在的日志对象,这里它会重新创建一个并且由LogManager 管理,后面再次使用则使用这个已经存在的对象。 这里两个日志对象同时使用结果如下:

  现在我修改配置文件的日志文件输出级别:

 
 
< logger name ="MyLogger" >
< level value ="WARN" ></ level >
< appender-ref ref ="FileAppender" ></ appender-ref >
< appender-ref ref ="ConsoleAppender" ></ appender-ref >
< appender-ref ref ="AdoNetAppender" ></ appender-ref >
</ logger >

  运行得到的结果如图:

  显然MyLogger对象日志没有输出日志信息。

  六. Log4Net 参数说明 

  上面我们看到的配置文件中有类似 %m %n 等这样的符号,这些符号都是有特殊意义的。

 
 
%m [ %message ] : 输出的日志消息
%n : 换行
%d
[ %datetime ] : 输出当前语句运行的时刻
%r : 输出程序从运行到执行到当前语句时消耗的毫秒数
%d : 当前语句所在的线程ID
%p : 日志的当前优先级别
%c :当前日志对象的名称
%L : 输出语句所在的行号
%F :输出语句所在的文件名
%-数字 :表示该项的最小长度,如果不够,则用空格填充

  七. 自定义轻量级日志系统

  具体参照文章:  ORM映射框架总结--日志处理

  这里不再过多的说明,示例下载

相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
目录
相关文章
|
1月前
|
C#
一个.NET开源、轻量级的运行耗时统计库 - MethodTimer
一个.NET开源、轻量级的运行耗时统计库 - MethodTimer
|
15天前
|
算法 Java 测试技术
Benchmark.NET:让 C# 测试程序性能变得既酷又简单
Benchmark.NET是一款专为 .NET 平台设计的性能基准测试框架,它可以帮助你测量代码的执行时间、内存使用情况等性能指标。它就像是你代码的 "健身教练",帮助你找到瓶颈,优化性能,让你的应用跑得更快、更稳!希望这个小教程能让你在追求高性能的路上越走越远,享受编程带来的无限乐趣!
61 13
|
18天前
|
存储 SQL 关系型数据库
【赵渝强老师】PostgreSQL的运行日志文件
PostgreSQL的物理存储结构包括数据文件、日志文件等。运行日志默认未开启,需配置`postgresql.conf`文件中的相关参数如`log_destination`、`log_directory`等,以记录数据库状态、错误信息等。示例配置中启用了CSV格式日志,便于管理和分析。通过创建表操作,可查看生成的日志文件,了解具体日志内容。
|
21天前
|
存储 Prometheus 监控
Docker容器内进行应用调试与故障排除的方法与技巧,包括使用日志、进入容器检查、利用监控工具及检查配置等,旨在帮助用户有效应对应用部署中的挑战,确保应用稳定运行
本文深入探讨了在Docker容器内进行应用调试与故障排除的方法与技巧,包括使用日志、进入容器检查、利用监控工具及检查配置等,旨在帮助用户有效应对应用部署中的挑战,确保应用稳定运行。
30 5
|
27天前
|
前端开发 Android开发
WinForm 直接运行 Admin.NET
本文介绍了如何将 Admin.NET 以 WinForm 桌面程序模式运行,简化了手动配置 Web 服务的过程,便于演示和作为单机软件使用。通过添加特定 NuGet 包、修改 `Program.cs` 和 `Form1.cs` 文件,并调整项目配置,最终实现了在 WinForm 中嵌入 WebView 组件显示 Admin.NET 界面的效果。
22 0
WinForm 直接运行 Admin.NET
|
2月前
|
Arthas 监控 Java
JVM知识体系学习七:了解JVM常用命令行参数、GC日志详解、调优三大方面(JVM规划和预调优、优化JVM环境、JVM运行出现的各种问题)、Arthas
这篇文章全面介绍了JVM的命令行参数、GC日志分析以及性能调优的各个方面,包括监控工具使用和实际案例分析。
68 3
|
2月前
|
XML 存储 安全
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
101 0
|
3月前
|
Ubuntu 持续交付 API
如何使用 dotnet pack 打包 .NET 跨平台程序集?
`dotnet pack` 是 .NET Core 的 NuGet 包打包工具,用于将代码打包成 NuGet 包。通过命令 `dotnet pack` 可生成 `.nupkg` 文件。使用 `--include-symbols` 和 `--include-source` 选项可分别创建包含调试符号和源文件的包。默认情况下,`dotnet pack` 会先构建项目,可通过 `--no-build` 跳过构建。此外,还可以使用 `--output` 指定输出目录、`-c` 设置配置等。示例展示了创建类库项目并打包的过程。更多详情及命令选项,请参考官方文档。
235 11
|
3月前
|
存储 运维
.NET开发必备技巧:使用Visual Studio分析.NET Dump,快速查找程序内存泄漏问题!
.NET开发必备技巧:使用Visual Studio分析.NET Dump,快速查找程序内存泄漏问题!
|
3月前
|
自然语言处理 C# 图形学
使用dnSpyEx对.NET Core程序集进行反编译、编辑和调试
使用dnSpyEx对.NET Core程序集进行反编译、编辑和调试
下一篇
DataWorks