Log4Net最简单的使用配置_AX

【引】
最近听朋友说起Log4Net不好配置,正好项目中用到了,于是有了这篇blog.貌似官方不再进行维护了.

【基础】

官方网站的配置例子: http://logging.apache.org/log4net/release/config-examples.html

配置节点是由logger和appender组成的.

logger说明要使用哪些appender. appender说明日志怎样存储,如写入系统日志,文本,数据库,邮件等...具体参见上面的链接.

appender节里有两个重要的子节点.

filter负责过滤你想要得到的日志级别或包含特殊的字符串

layout负责日志输出的样式.

【配置】

分三步:

Ⅰ.创建一个网站,引入log4net.dll

这里可以下载log4net源码  http://logging.apache.org/log4net/download.html

Ⅱ.项目里新建一个配置文件Log4Net_AX.config,删除自动生成的代码,Copy下列代码到该文件.

 

<log4net>
  <logger name="loggerAX">
    <!--control log level: ALL|DEBUG|INFO|WARN|ERROR|FATAL|OFF-->
    <!--如果没有定义LEVEL的值，则缺省为DEBUG-->
    <level value="ALL" />
    <appender-ref ref="SmtpAppenderAX"></appender-ref>
    <appender-ref ref="FileAppenderAX"></appender-ref>
  </logger>

  <appender name="SmtpAppenderAX" type="log4net.Appender.SmtpAppender">
    <to value="AXzhz@163.com"></to>
    <from value="AXzhz@163.com" />
    <subject value="AX'Test Log Message" />
    <smtpHost value="smtp.163.com" />
    <username value="AXzhz" />
    <password value="110" />
    <bufferSize value="2048" />
    <!--超长部分是否丢弃-->
    <lossy value="false" />

    <!--evaluator时好时坏,靠不住,还是用filter实在-->
    <!--<evaluator type="log4net.Core.LevelEvaluator">
      <threshold value="ERROR"/>
    </evaluator>-->
    <!--<evaluator type="log4net.Core.LevelEvaluator,log4net">
      <threshold value="WARN" />
    </evaluator>-->
    <!--将导致不能写日志-->
    <!--<filter type="log4net.Filter.DenyAllFilter" />-->

    <!--输出级别在WARN和OFF之间的日志-->
    <filter type="log4net.Filter.LevelRangeFilter">
      <param name="LevelMin" value="WARN" />
      <param name="LevelMax" value="OFF" />
    </filter>

    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%newline%date [%thread] %-5level %logger [%property{NDC}] : %newline%message%newline" />
    </layout>
  </appender>

  <appender name="FileAppenderAX" type="log4net.Appender.RollingFileAppender">
    <!--绝对路径-->
    <file value="D:\\AX.txt"></file>
    <!--相对路径,在项目的根目录下-->
    <!--以最后一个路径为准,所以上面的绝对路径下不会写日志-->
    <file value="./Log/AX.txt"></file>
    <!--防止多线程时不能写Log,官方说线程非安全-->
    <!--实际使用时,本地测试正常,部署后有不能写日志的情况-->
    <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
    <appendToFile value="true" />
    <!--可以为:Once|Size|Date|Composite-->
    <!--Composite为Size和Date的组合-->
    <rollingStyle value="composite" />
    <!--日志最大个数,都是最新的-->
    <!--rollingStyle节点为Date时,该节点不起作用-->
    <!--rollingStyle节点为Size时,只能有value个日志-->
    <!--rollingStyle节点为Composite时,每天有value个日志-->
    <maxSizeRollBackups value="10" />
    <!--当备份文件时,为文件名加的后缀-->
    <!--后缀为*.txt时,例:AX.txt_2008-07-24.PxP  应该是程序上的一个bug-->
    <!--后缀为*.TXT时,例:AX.txt_2008-07-25.TXT-->
    <datePattern value="_yyyy-MM-dd.TXT" />
    <!--可用的单位:KB|MB|GB-->
    <!--不要使用小数,否则会一直写入当前日志-->
    <maximumFileSize value="1KB" />
    <!--置为true,当前最新日志文件名永远为file节中的名字-->
    <staticLogFileName value="true" />
    <!--输出级别在INFO和ERROR之间的日志-->
    <filter type="log4net.Filter.LevelRangeFilter">
      <param name="LevelMin" value="INFO" />
      <param name="LevelMax" value="ERROR" />
    </filter>
    <!--必须结合起来用,第一个只过滤出WARN,第二个拒绝其它其它日志输出-->
    <filter type="log4net.Filter.LevelMatchFilter">
      <param name="LevelToMatch" value="WARN" />
    </filter>
    <filter type="log4net.Filter.DenyAllFilter" />

    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%date [%thread] %-5level %logger [%ndc] - %message%newline" />
    </layout>
  </appender>
</log4net>


<!--==================================layout节点的配置说明==================================-->
<!--                                                                        Made By AX      -->
<!--        %m(message):输出的日志消息，如ILog.Debug(…)输出的一条消息                          -->
<!--        %n(new line):换行                                                                   -->
<!--        %d(datetime):输出当前语句运行的时刻                                                 -->
<!--        %r(run time):输出程序从运行到执行到当前语句时消耗的毫秒数                           -->
<!--        %t(thread id):当前语句所在的线程ID                                                  -->
<!--        %p(priority): 日志的当前优先级别，即DEBUG、INFO、WARN…等                           -->
<!--        %c(class):当前日志对象的名称，例如：                                                -->
<!--               模式字符串为：%-10c -%m%n                                                    -->
<!--               代码为：                                                                     -->
<!--        ILog log=LogManager.GetLogger(“Exam.Log”);                                        -->
<!--        log.Debug(“Hello”);                                                               -->
<!--            则输出为下面的形式：                                                            -->
<!--        Exam.Log       - Hello                                                              -->
<!--        %L：输出语句所在的行号                                                              -->
<!--        %F：输出语句所在的文件名                                                            -->
<!--        %-数字：表示该项的最小长度，如果不够，则用空格填充                                  -->
<!--        例如，转换模式为%r [%t]%-5p %c - %m%n 的 PatternLayout 将生成类似于以下内容的输出： -->
<!--        176 [main] INFO  org.foo.Bar - Located nearest gas station.                         -->
<!--                                                                                        -->
<!--========================================================================================-->

 

Ⅲ.在Default.aspx.cs的Page_Load里添加如下代码.

 

    protected void Page_Load(object sender, EventArgs e)
    {
        //下面两句应该放在网站刚刚启动时加载,并放在一个静态方法里方便调用
        log4net.Config.XmlConfigurator.ConfigureAndWatch(new System.IO.FileInfo(Server.MapPath("Log4Net_AX.config")));
        ILog logAX = LogManager.GetLogger("loggerAX");

        //写日志
        logAX.Error("Error AX");
        logAX.Info("Info AX");
    }

 

F5,在项目目录下找到Log文件夹的AX.txt ,这个就是刚刚生成的日志文件.

 

【写日志的原则】

Ⅰ.在catch后,把异常写入日志.

Ⅱ.在调用第三方控件的开始和结束处.

Ⅲ.在连接数据库的开始结束处.

Ⅳ.除非必要,不要在循环体中加入日志,否则一旦出问题可能导致日志暴增.

Ⅴ.在自己认为很重要的逻辑处写入日志.

 

【注意】

发现有重要问题时最好用邮件日志,但不要指望上面的邮件配置节能发日志.

要使用能用的smtp服务器,163的只有部分用户能用.我的就不能用,很是郁闷.

要合理配置下列参数.

Ⅰ.日志文件的大小

Ⅱ.备份的日志名样式,最好时间精确到分