Layouts控制日志显示的格式样式。日志的显示格式如下:
"%timestamp [%thread] %-5level %logger - %message%newline"
Timestamp: 表示程序已经开始执行的时间。 单位[毫秒]。
Thread:执行当前代码的线程。
Level:日志的级别。
Logger:日志相关请求的名称。
Message: 日志消息。
%m(message):输出的日志消息,如ILog.Debug(…)输出的一条消息
%n(new line):換行
%d(datetime):输出当前语句运行的时刻
%r(run time):输出程序从运行到执行到当前语句时消耗的毫秒数
%t(thread id):当前语句所在的线程ID
%p(priority): 日志的当前优先级别,即DEBUG、INFO、WARN…等
%c(class):当前日志对象的名称
%L:输出语句所在的行号
%F:输出语句所在的文件名
%-数字:表示该项的最小长度,如果不够,则用空格填充
1PatterLayout格式化字符表
转换字符
效果
a
等价于appdomain
appdomain
引发日志事件的应用程序域的友好名称。(使用中一般是可执行文件的名字。)
c
等价于 logger
C
等价于 type
class
等价于 type
d
等价于 date
date
发生日志事件的本地时间。 使用 DE>%utcdate 输出UTC时间。date后面还可以跟一个日期格式,用大括号括起来。DE>例如:%date{HH:mm:ss,fff}或者%date{dd MMM yyyy HH:mm:ss,fff}。如果date后面什么也不跟,将使用ISO8601 格式 。
日期格式和.Net中DateTime类的ToString方法中使用的格式是一样。
另外log4net还有3个自己的格式Formatter。 它们是 "ABSOLUTE", "DATE"和"ISO8601"分别代表 AbsoluteTimeDateFormatter, DateTimeDateFormatter和Iso8601DateFormatter。例如:%date{ISO8601}或%date{ABSOLUTE}。
它们的性能要好于ToString。
exception
异常信息
日志事件中必须存了一个异常对象,如果日志事件不包含没有异常对象,将什么也不输出。异常输出完毕后会跟一个换行。一般会在输出异常前加一个换行,并将异常放在最后。
F
等价于 file
file
发生日志请求的源代码文件的名字。
警告:只在调试的时候有效。调用本地信息会影响性能。
identity
当前活动用户的名字(Principal.Identity.Name).
警告:会影响性能。(我测试的时候%identity返回都是空的。)
l
等价于 location
L
等价于 line
location
引发日志事件的方法(包括命名空间和类名),以及所在的源文件和行号。
警告:会影响性能。没有pdb文件的话,只有方法名,没有源文件名和行号。
level
日志事件等级
line
引发日志事件的行号
警告:会影响性能。
logger
记录日志事件的Logger对象的名字。
可以使用精度说明符控制Logger的名字的输出层级,默认输出全名。
注意,精度符的控制是从右开始的。例如:logger 名为 "a.b.c", 输出模型为%logger{2} ,将输出"b.c"。
m
等价于 message
M
等价于 method
message
由应用程序提供给日志事件的消息。
mdc
MDC (旧为:ThreadContext.Properties) 现在是事件属性的一部分。 保留它是为了兼容性,它等价于 property。
method
发生日志请求的方法名(只有方法名而已)。
警告:会影响性能。
n
等价于 newline
newline
换行符
ndc
NDC (nested diagnostic context)
p
等价于 level
P
等价于 property
properties
等价于 property
property
输出事件的特殊属性。例如: %property{user} 输出user属性。属性是由loggers或appenders添加到时间中的。 有一个默认的属性"DE>log4net:HostName"总是会有。DE>
%property将输出所有的属性 。
(扩展后可以使用)
r
等价于 timestamp
t
等价于 thread
timestamp
从程序启动到事件发生所经过的毫秒数。
thread
引发日志事件的线程,如果没有线程名就使用线程号。
type
引发日志请求的类的全名。.
可以使用精度控制符。例如: 类名是 "log4net.Layout.PatternLayout", 格式模型是%type{1} 将输出"PatternLayout"。(也是从右开始的。)
警告:会影响性能。
u
等价于 identity
username
当前用户的WindowsIdentity。(类似:HostName/Username)
警告:会影响性能。
utcdate
发生日志事件的UTC时间。DE>后面还可以跟一个日期格式,用大括号括起来。DE>例如:%utcdate{HH:mm:ss,fff}或者%utcdate{dd MMM yyyy HH:mm:ss,fff}。如果utcdate后面什么也不跟,将使用ISO8601 格式 。
日期格式和.Net中DateTime类的ToString方法中使用的格式是一样。
另外log4net还有3个自己的格式Formatter。 它们是 "ABSOLUTE", "DATE"和"ISO8601"分别代表 AbsoluteTimeDateFormatter, DateTimeDateFormatter和Iso8601DateFormatter。例如:%date{ISO8601}或%date{ABSOLUTE}。
它们的性能要好于ToString。
w
等价于 username
x
等价于 ndc
X
等价于 mdc
%
%%输出一个百分号