日志规范
开发/后端 · 阅读 1792 · 点赞 0
文中列出一种常用的日志规范供参考。
异常类型
debug非常具体的信息，只能用于开发调试使用。部署到生产环境后，这个级别的信息只能保持很短的时间。这些信息只能临时存在，并将最终被关闭。要区分 DEBUG 和 TRACE 会比较困难，对一个在开发及测试完成后将被删除的 LOG 输出，可能会比较适合定义为 TRACE 级别.info重要的业务处理已经结束。在实际环境中，系统管理员或者高级用户要能理解 INFO 输出的信息并能很快的了解应用正在做什么。比如，一个和处理机票预订的系统，对每一张票要有且只有一条INFO信息描述“[Who] booked ticket from [Where] to [Where]”。另外一种对 INFO 信息的定义是：记录显著改变应用状态的每一个action，比如：数据库更新、外部系统请求。warn发生这个级别问题时，处理过程可以继续，但必须对这个问题给予额外关注。这个问题又可以细分成两种情况：
- 第一种是存在严重的问题但有应急措施（比如数据库不可用，使用 Cache）；
- 第二种是潜在问题及建议（ATTENTION）。
比如生产环境的应用运行在 Development 模式下、管理控制台没有密码保护等。系统可以允许这种错误的存在，但必须及时做跟踪检查用户参数错误。可以使用 warn 日志级别来记录用户输入参数错误的情况，避免用户投诉时，无所适从。
error系统中发生了非常严重的问题，必须马上有人进行处理。没有系统可以忍受这个级别的问题的存在。比如：NPEs（空指针异常），数据库不可用，关键业务流程中断等等。
异常规范
- 返回给前端接口统一抛出
io.choerodon.core.exception.CommonException异常，这样返回给前端的状态码为 200，前端通过 failed 是否为 true 判断成功与否。 - 内部接口(用于被其他服务通过 feign 或 ribbon 调用的)，统一抛出
io.choerodon.core.exception.FeignException异常，抛出异常时状态码为 500，方便接口调用端“感知”异常。 - 手动抛异常时应该把
exception一块抛出，可以保留异常堆栈。
try {
String input = mapper.writeValueAsString(projectEventMsg); sagaClient.startSaga(PROJECT_UPDATE, new StartInstanceDTO(input, “project”, “” + projectDO.getId()));
} catch (Exception e) {
throw new CommonException(“error.projectService.update.event”, e);
}- 允许记录日志后又抛出异常，因为这样会多次记录日志，只允许记录一次日志，应尽量抛出异常，顶层打印一次日志。
- 使用 SLF4J 中的 API 进行日志打印, 在一个对象中通常只使用一个 Logger 对象，Logger 应该是 static final 的。 private static final Logger LOGGER= LoggerFactory.getLogger(Abc.class)。
- 对 trace/debug/info 级别的日志输出，必须使用占位符的方式。 logger.debug(“Processing trade with id: “ + id + ” symbol: “ + symbol);
如果日志级别是 warn，上述日志不会打印，但是会执行字符串拼接操作，如果 symbol 是对象，会执行 toString()方法，浪费了系统资源，执行了上述操作，最终日志却没有打印。所以应该使用：logger.debug(“Processing trade with id:{} and symbol : {} “, id, symbol);
- 输出的 POJO 类必须重写 toString 方法或者使用 FastJson 等输出有意义的对象信息，否则只输出此对象的 hashCode 值（地址值），没啥参考意义。
- 输出 Exceptions 的全部 Throwable 信息。
- LOGGER.error(e.getMessage()); 错误,失掉 StackTrace 信息
- LOGGER.error(“Bad things : {}“,e.getMessage()); 错误,失掉 StackTrace 信息
- LOGGER.error(“Bad things : {}“,e); 正确
- 不允许出现 System print(包括 System.out.println 和 System.error.println)语句。
- 不允许出现 printStackTrace。堆栈打印应该 LOGGER.error(“Bad things : {}“,e)。
日志格式
- 将附件中的 logback-spring.xml 放入 src/main/resources/中。
- 系统抛出的异常不会附带 traceid，如果需要输出 traceid 应该使用如下方式输出异常信息 logger.error(“internal server error”, e)。
随机文章
