【引】
最近听朋友说起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的只有部分用户能用.我的就不能用,很是郁闷.
要合理配置下列参数.
Ⅰ.日志文件的大小
Ⅱ.备份的日志名样式,最好时间精确到分