【日志】怎么打印日志


怎么打印日志

​ 開發中好的日志打印方式,可以提高我們debug速度,線上故障得時候也可以快速定位問題。

​ 怎么打印日志呢?

基本格式:

​ 1:必須使用參數化信息的方式:

logger.debug("[xxService]Processing trade with id:[{}] and symbol : [{}] ", id, symbol);

對於debug日志,必須判斷是否為debug級別后,才進行使用:
如有參數變量,應該寫成如下寫法:
日志開頭,打印當前類名,並且用[]括起來,作為關鍵字,查找日志得時候比較快。

不同級別得使用

ERROR

影響到程序正常運行、當前請求正常運行的異常情況:
1.打開配置文件失敗
2.所有第三方對接的異常(包括第三方返回錯誤碼)
3.所有影響功能使用的異常,包括:SQLException和除了業務異常之外的所有異常 (RuntimeException和Exception)

如果有Throwable信息,需要記錄完成的堆棧信息:

log.error("[DemoService]獲取用戶[{}]的用戶信息時出錯",userName,e);

1.如果進行了拋出異常操作,請不要記錄error日志,由最終處理方進行處理:

try{
    ....
}catch(Exception ex){
  String errorMessage=String.format("[DemoService]Error while reading information of user [%s]",userName);
  logger.error(errorMessage,ex);
  throw new UserServiceException(errorMessage,ex);
}
WARN

不應該出現但是不影響程序、當前請求正常運行的異常情況:

1.有容錯機制的時候出現的錯誤情況
2.找不到配置文件,但是系統能自動創建配置文件
即將接近臨界值的時候,例如:
1.緩存池占用達到警告線
業務異常的記錄,比如:
1.當接口拋出業務異常時,應該記錄此異常

INFO

系統運行信息
1.Service方法中對於系統/業務狀態的變更
2.主要邏輯中的分步驟
外部接口部分
1.客戶端請求參數(REST/WS)
2.調用第三方時的調用參數和調用結果

1.並不是所有的service都進行出入口打點記錄,單一、簡單service是沒有意義的(job除外,job需要記錄開始和結束,)。

反例(不要這么做):

ublic List listByBaseType(Integer baseTypeId) {

    log.info("開始查詢基地");
    BaseExample ex=new BaseExample();
    BaseExample.Criteria ctr = ex.createCriteria();
    ctr.andIsDeleteEqualTo(IsDelete.USE.getValue());
    Optionals.doIfPresent(baseTypeId, ctr::andBaseTypeIdEqualTo);
   log.info("查詢基地結束");
    return baseRepository.selectByExample(ex);
}

2.對於復雜的業務邏輯,需要進行日志打點,以及埋點記錄,比如電商系統中的下訂單邏輯,以及OrderAction操作(業務狀態變更)。
3.對於整個系統的提供出的接口(REST/WS),使用info記錄入參
4.如果所有的service為SOA架構,那么可以看成是一個外部接口提供方,那么必須記錄入參。
5.調用其他第三方服務時,所有的出參和入參是必須要記錄的(因為你很難追溯第三方模塊發生的問題)

DEBUG

1.可以填寫所有的想知道的相關信息(但不代表可以隨便寫,debug信息要有意義,最好有相關參數)
2.生產環境需要關閉DEBUG信息
3.如果在生產情況下需要開啟DEBUG,需要使用開關進行管理,不能一直開啟。

如果代碼中出現以下代碼,可以進行優化:

logger.debug("開始獲取員工[{}] [{}]年基本薪資",employee,year);

logger.debug("獲取員工[{}] [{}]年的基本薪資為[{}]",employee,year,basicSalary);
logger.debug("開始獲取員工[{}] [{}]年[{}]月休假情況",employee,year,month);

logger.debug("員工[{}][{}]年[{}]月年假/病假/事假為[{}]/[{}]/[{}]",employee,year,month,annualLeaveDays,sickLeaveDays,noPayLeaveDays);
logger.debug("開始計算員工[{}][{}]年[{}]月應得薪資",employee,year,month);

logger.debug("員工[{}] [{}]年[{}]月應得薪資為[{}]",employee,year,month,actualSalary);
TRACE

特別詳細的系統運行完成信息,業務代碼中,不要使用.(除非有特殊用意,否則請使用DEBUG級別替代)

規范示例說明

Override
@Transactional
public void createUserAndBindMobile(@NotBlank String mobile, @NotNull User user) throws CreateConflictException{
    boolean debug = log.isDebugEnabled();
    if(debug){
        log.debug("開始創建用戶並綁定手機號. args[mobile=[{}],user=[{}]]", mobile, LogObjects.toString(user));
    }
    try {
        user.setCreateTime(new Date());
        user.setUpdateTime(new Date());
        userRepository.insertSelective(user);
        if(debug){
            log.debug("創建用戶信息成功. insertedUser=[{}]",LogObjects.toString(user));
        }
        UserMobileRelationship relationship = new UserMobileRelationship();
        relationship.setMobile(mobile);
        relationship.setOpenId(user.getOpenId());
        relationship.setCreateTime(new Date());
        relationship.setUpdateTime(new Date());
        userMobileRelationshipRepository.insertOnDuplicateKey(relationship);
        if(debug){
            log.debug("綁定手機成功. relationship=[{}]",LogObjects.toString(relationship));
        }
        log.info("創建用戶並綁定手機號. userId=[{}],openId=[{}],mobile=[{}]",user.getId(),user.getOpenId(),mobile); // 如果考慮安全,手機號記得脫敏
    }catch(DuplicateKeyException e){
        log.info("創建用戶並綁定手機號失敗,已存在相同的用戶. openId=[{}],mobile=[{}]",user.getOpenId(),mobile);
        throw new CreateConflictException("創建用戶發生沖突, openid=[%s]",user.getOpenId());
    }
}

ps: 日志打印最好用英文,防止亂碼


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM