Log4Net 全方位跟踪程序运行

本文涉及的产品
日志服务 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 >
      
< 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-ref >
    
</ 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.netTrace的方式查看记录的日志

(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 的日志对象管理器LogManagerLogManager是用于来管理所有的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"  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"   />
        
</ 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日志并进行多维度分析。
相关文章
|
27天前
|
Arthas 监控 Java
JVM知识体系学习七:了解JVM常用命令行参数、GC日志详解、调优三大方面(JVM规划和预调优、优化JVM环境、JVM运行出现的各种问题)、Arthas
这篇文章全面介绍了JVM的命令行参数、GC日志分析以及性能调优的各个方面,包括监控工具使用和实际案例分析。
39 3
|
1月前
|
XML 存储 安全
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
48 0
|
2月前
|
Ubuntu 持续交付 API
如何使用 dotnet pack 打包 .NET 跨平台程序集?
`dotnet pack` 是 .NET Core 的 NuGet 包打包工具,用于将代码打包成 NuGet 包。通过命令 `dotnet pack` 可生成 `.nupkg` 文件。使用 `--include-symbols` 和 `--include-source` 选项可分别创建包含调试符号和源文件的包。默认情况下,`dotnet pack` 会先构建项目,可通过 `--no-build` 跳过构建。此外,还可以使用 `--output` 指定输出目录、`-c` 设置配置等。示例展示了创建类库项目并打包的过程。更多详情及命令选项,请参考官方文档。
180 11
|
2月前
|
存储 运维
.NET开发必备技巧:使用Visual Studio分析.NET Dump,快速查找程序内存泄漏问题!
.NET开发必备技巧:使用Visual Studio分析.NET Dump,快速查找程序内存泄漏问题!
|
2月前
|
自然语言处理 C# 图形学
使用dnSpyEx对.NET Core程序集进行反编译、编辑和调试
使用dnSpyEx对.NET Core程序集进行反编译、编辑和调试
|
3月前
|
存储 运维 监控
监控与日志管理:保障系统稳定运行与高效运维的基石
【8月更文挑战第16天】监控与日志管理是保障系统稳定运行和高效运维的基石。它们不仅能够帮助企业及时发现并解决问题,还能够为性能调优、资源优化和业务决策提供有力支持。因此,在构建系统架构时,企业应高度重视监控与日志管理的规划和实施,确保它们能够充分发挥作用,为企业的发展保驾护航。同时,随着技术的不断进步和应用场景的不断拓展,监控与日志管理也将持续演进和创新,为企业带来更多的价值和便利。
|
3月前
|
运维 分布式计算 DataWorks
DataWorks产品使用合集之运维中心中的运行日志可以保留多久
DataWorks作为一站式的数据开发与治理平台,提供了从数据采集、清洗、开发、调度、服务化、质量监控到安全管理的全套解决方案,帮助企业构建高效、规范、安全的大数据处理体系。以下是对DataWorks产品使用合集的概述,涵盖数据处理的各个环节。
|
3月前
|
数据库 Java 监控
Struts 2 日志管理化身神秘魔法师,洞察应用运行乾坤,演绎奇幻篇章!
【8月更文挑战第31天】在软件开发中,了解应用运行状况至关重要。日志管理作为 Struts 2 应用的关键组件,记录着每个动作和决策,如同监控摄像头,帮助我们迅速定位问题、分析性能和使用情况,为优化提供依据。Struts 2 支持多种日志框架(如 Log4j、Logback),便于配置日志级别、格式和输出位置。通过在 Action 类中添加日志记录,我们能在开发过程中获取详细信息,及时发现并解决问题。合理配置日志不仅有助于调试,还能分析用户行为,提升应用性能和稳定性。
53 0
|
3月前
|
开发框架 .NET 开发工具
【Azure 应用服务】App Service 的.NET Version选择为.NET6,是否可以同时支持运行ASP.NET V4.8的应用呢?
【Azure 应用服务】App Service 的.NET Version选择为.NET6,是否可以同时支持运行ASP.NET V4.8的应用呢?
|
3月前
|
开发框架 监控 .NET
【Azure 应用程序见解】在Docker中运行的ASP.NET Core应用如何开启Application Insights的Profiler Trace呢?
【Azure 应用程序见解】在Docker中运行的ASP.NET Core应用如何开启Application Insights的Profiler Trace呢?
下一篇
无影云桌面