Logger、Appender和 Layout
Logback建立于三个主要类之上:Logger、Appender 和 Layout。Logger类是logback-classic模块的一部分,而Appender和Layout接口来自logback-core。作为一个多用途模块,logback-core 不包含任何 logger。
Logger作为日志的记录器,把它关联到应用的对应的context上后,主要用于存放日志对象,也可以定义日志类型、级别。Appender主要用于指定日志输出的目的地,目的地可以是控制台、文件、远程套接字服务器、 MySQL、 PostreSQL、 Oracle和其他数据库、 JMS和远程UNIX Syslog守护进程等。Layout 负责把事件转换成字符串,格式化的日志信息的输出。
Logger context
各个logger 都被关联到一个 LoggerContext,LoggerContext负责制造logger,也负责以树结构排列各 logger。
如果 logger的名称带上一个点号后是另外一个 logger的名称的前缀,那么,前者就被称为后者的祖先。如果 logger与其后代 logger之间没有其他祖先,那么,前者就被称为子logger 之父。比如,名为 "com.foo""的 logger 是名为"com.foo.Bar"之父。root logger 位于 logger 等级的最顶端,root logger 可以通过其名称取得,如下所示:
Logger rootLogger = LoggerFactory.getLogger(org.slf4j.Logger.ROOT_LOGGER_NAME)
其他所有logger也通过org.slf4j.LoggerFactory 类的静态方法getLogger取得。 getLogger方法以 logger 名称为参数。用同一名字调用LoggerFactory.getLogger 方法所得到的永远都是同一个logger对象的引用。
有效级别与级别继承
Logger 可以被分配级别。级别包括:TRACE、DEBUG、INFO、WARN 和 ERROR,定义于 ch.qos.logback.classic.Level类。如果 logger没有被分配级别,那么它将从有被分配级别的最近的祖先那里继承级别。root logger 默认级别是 DEBUG。
打印方法与基本选择规则
打印方法决定记录请求的级别。例如,如果 L 是一个 logger 实例,那么,语句 L.info("..")是一条级别为 INFO 的记录语句。记录请求的级别在高于或等于其 logger 的有效级别时被称为被启用,否则,称为被禁用。
记录请求级别为 p,其 logger的有效级别为 q, 只有则当 p>=q时, 该请求才会被执行。
该规则是 logback 的核心。级别排序为: TRACE <DEBUG <INFO <WARN <ERROR。
Logger、Appenders及layouts的关系
一个 logger 可以被关联多个 appender。 方法 addAppender() 为指定的 logger 添加一个 appender。 对于 logger 的每个启用了的记录请求,都将被发送到 logger 里的全部 appender 及更高等级的 appender。换句话说,appender叠加性地继承了 logger 的层次等级。
Logger L的记录语句的输出会发送给 L及其祖先的全部 appender。如果 logger L的某个祖先 P设置叠加性标识为 false,那么,L的输出会发送给L 与 P之间(含P)的所有 appender,但不会发送给P的任何祖先的appender。
Logger 的叠加性默认为 true。如果希望定制输出格式。这时为 appender 关联一个 layout 即可。Layout 负责根据用户意愿对记录请求进行格式化,appender 负责将格式化化后的输出发送到目的地。
例如,转换模式"%-4relative [%thread] %-5level %logger{32} - %msg%n"在 PatternLayout里会输出形如:
176 [main] DEBUG manual.architecture.HelloWorld2 - Hello world.
第一个字段是自程序启动以来的逝去时间,单位是毫秒。
第二个地段发出记录请求的线程。
第三个字段是记录请求的级别。
第四个字段是与记录请求关联的 logger 的名称。
"-"之后是请求的消息文字。
Logback的默认配置
如果配置文件 logback-test.xml 和 logback.xml 都不存在,那么 logback 默认地会调用BasicConfigurator ,创建一个最小化配置。最小化配置由一个关联到根 logger 的ConsoleAppender 组成。输出用模式为%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n 的 PatternLayoutEncoder 进行格式化。root logger 默认级别是 DEBUG。
logback配置文件
Logback 配置文件的语法非常灵活。正因为灵活,所以无法用 DTD 或 XML schema 进行定义。尽管如此,可以这样描述配置文件的基本结构:以<configuration>开头,后面有零个或多个<appender>元素,有零个或多个<logger>元素,有最多一个<root>元素。
Logback默认配置的采用的步骤
1. 尝试在 classpath 下查找文件 logback-test.xml;
2. 如果文件不存在,则查找文件 logback.xml;
3. 如果两个文件都不存在,logback 用 Bas icConfigurator 自动对自己进行配置,这会导致记录输出到控制台。
假设配置文件 logback-test.xml 和 logback.xml 都不存在,那么 logback 默认地会调用BasicConfigurator ,创建一个最小化配置。最小化配置由一个关联到根 logger 的ConsoleAppender 组成。输出用模式为%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n 的 PatternLayoutEncoder 进行格式化。还有,根 logger 默认级别是 DEBUG。
Logback是由log4j创始人设计的一个开源日志组件。LogBack被分为3个组件,logback-core, logback-classic 和 logback-access。
Logback是要与SLF4J结合起来。这两个组件的官方网站如下:
logback官方网站: logback官方网站
SLF4J官方网站:SLF4J官方网站
小结:
编译期间,完成slf4j的绑定已经logback配置文件的加载。slf4j会在classpath中寻找org/slf4j/impl/StaticLoggerBinder.class(会在具体的日志框架如log4j、logback等中存在),找到并完成绑定;同时,logback也会在classpath中寻找配置文件,先找logback.configurationFile、没有则找logback.groovy,若logback.groovy也没有,则找logback-test.xml,若logback-test.xml还是没有,则找logback.xml,若连logback.xml也没有,那么说明没有配置logback的配置文件,那么logback则会启用默认的配置(日志信息只会打印在控制台)。
1.引入slf4j、logback相关依赖
2.添加配置文件logback.xml
就举例最近新做的项目d个X中的应用吧。因为在与前端联调阶段,api自测感觉没啥问题的,然后联调就会有各种问题,没法避免,技术还是太水了,哈哈哈哈........
调详情页的时候,听到有问题就赶紧看日志去,果然报错了。如下:
有错误信息就能当做本地控制台一样,可以直接看到错误信息。
Cause: com.mysql.jdbc.MysqlDataTruncation: Data truncation: Data too long for column 'saler_phone' at row 1
SQL []Data truncation: Data too long for column 'saler_phone' at row 1nested exception is com.mysql.jdbc.MysqlDataTruncation: Data truncation: Data too long for column 'saler_phone' at row 1
然后进一步加了log日志
传参错了,查了原因,登录失效,然后salerPhone居然还有值,而且多了一位......
logback具有以下优点:
总而言之,如果大家的项目里面需要选择一个日志框架,那么我个人非常建议使用logback。
log4j、logback、log4j2性能测试,直接引用公司的博客吧。 logback log4j log4j2 性能实测
logback日志框架由三部分组成: logback-core 、 logback-access 、 logback-classic 。使用起来也很方便需要在项目目录下增加logback.xml文件。在springboot项目,框架已经集成了logback(默认的日志框架),只需要在项目 resource 下配置 logback.xml文件 或者 logback-spring.xml 文件。这里主要记录的是logback配置文件的内容部分。
在学习logback时,我们需要了解设计者的思维方式。我们才能更好的配置出我们需要的日志策略及性能。
(1)控制台日志和写入文件日志分开
日志本身是可追加写入的,定义为 追加器 : appender ,控制台和写入文件日志分别有 ConsleAppdender 和 FileAppender 两个追加器处理。
(2)日志打印的内容可以控制参数格式
打印出的日志一定是规整的,便于开发跟踪问题。例如:问题发生的时间,由于大部分程序都是多线程运行的,则需要知道每个业务请求的线程号,出问题的使用到的类名等等.
(3)写入文件中的日志不宜过大同时考虑时间跨天问题
考虑到将文件分开(可卷起 Rolling ),则使用升级的追加器 RollingFileAppender ,同时分开规则( Policy )考虑到跨天跨时间 。则在追加器中定义拆分规则: SizeAndTimeBasedRollingPolicy
(4)日志应该可以灵活指定输出级别
针对“ com.sports ”包下的日志,控制台和日志文件都使用debug级别。
(5)必须对主体日志指定输出级别
虽然我们会对不同的包或者框架下日志设置输出级别,但不可缺少主体日志输出级别: root
(6)日志可以异步写入
通常日志是和业务应用公用同一个线程,写系统日志会有 IO 开销,会损耗性能,我们应该可以异步写日志
logback框架日志格式通过 PatternLayout 方式配置,样例:
encoder作用:①把日志信息转换成字节数组;②把字节数组写入到输出流。
PatternLayoutEncoder 是唯一有用的且默认的 encoder , encoder 下只有一个 pattern 节点。
(1) % + “转换符号”输出信息
%t : t表示线程的转换符,打印控制台" [Thread: restartedMain]"
pattern中的转换符列表
(2)格式修饰符
与转换符共同使用,可选的格式修饰符位于“%”和转换符之间
左对齐 修饰符 :符号是减号“-”;接着是可选的最小宽度 修饰符,用十进制数表示
(3)使用 slf4j 中的 MDC 新增线程参数
“ %X ”用于输出和当前线程相关联的 MDC (嵌套诊断环境),格式 %X{xxx},使用 org.slf4j.MDC 添加 key/value 即可增加新值,
其中tracId是在MDC中设置进当前线程中的参数,记得在线程运行完时清除 clear 掉。
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)