应用系统日志规范.docx

应用系统日志规范在应用程序中添加程序日志记录可以跟踪代码运行时轨迹,作为日后审计的依据;并且担当集成开发环境中的调试器的作用,向文件打印代码的调试信息。本规定 Jave EE mons-Logging 作为日志接口封装,选用 Apache 提供的可重用组件 Log4j 作为底层实现。1. 日志命名规范根日志(root logger)位于日志层次的最顶层,它的日志级别不能指派为空;不能通过使用它的名字直接得到它, 得到它(指 root logger)。所有其他的日志可通过静态方法  来实例化并获取, 把所想要的 logger 的名字作为参数,一般取本类的名字作为参数。2. 日志信息级别规范日志信息输出的优先级从高到低至少应分为五档,分别是 Fatal、ERROR、WARN、INFO、DEBUG。这些级别用来指定这条日志信息的重要程度。在测试阶段可以打开所有级别的日志,系统上线后只允许输出 INFO以上级别(含 INFO)。各级别的日志信息作用规定如下: 致命(Fatal)严重的错误,系统无法正常运行,如硬盘空间满等。这个级别很少被用,常暗含系统或者系统的组件迫近崩溃。 错误(Error)系统可以继续运行,但最好要尽快修复的错误。这个级别用的较多,常常伴随 Java 异常,错误(Error)的环境不一定会造成系统的崩溃,系统可以继续服务接下来的请求。 警告(Warn)系统可以正常运行,但需要引起注意的警告信息。这个级别预示较小的问题,由系统外部的因素造成的,比如用户输入了不符合条件的参数。 信息(Info)系统运行的主要关键时点的操作信息,一般用于记录业务日志。但同时,也应该有足够的信息以保证可以记录再现缺陷的路径。这个级别记录了系统日常运转中有意义的事件。 调试(Debug)系统运行中的调试信息,便于开发人员进行错误分析和修正,一般用于程序日志,关心程序操作(细粒度),不太关心业务操作(粗粒度)。系统出现问题时,必须抛出异常,在处理异常时记录日志,且日志级别必须是前三个级别(Fatal\Error\Warning)中的一种。3. 日志配置规范所有的日志配置文件放在 src 目录下, 文件一同拷贝到(%webapp_HOME%)\WEB-INF\classes\目录下,这些配置文件必须采用properties 文件的编写方法, commons- mons-logging 的实现为 log4j, 文件用来配置log4j 的所有参数,日志配置信息不得配置在这两个文件以外的文件中。4. 日志对多线程的支持规范日志记录必须支持多线程。当应用程序同时处理多个客户的请求时,不同客户之间的日志信息写同一个日志文件时不应产生冲突,不同请求的日志信息能被显示并区分出来。在应用系统中,必须使用 log4jNDC(Nested Diagnostic Contexts)来处理多线程的日志记录。当程序响应请求时,通过 Log4J NDC(Nested Diagnostic Contexts)机制,将日志(logger)推入栈中,当