应用系统日志规范.docx

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