線上排障技巧-動(dòng)態(tài)修改Logger級(jí)別
前言
大多數(shù)情況下，我們會(huì)在打印日志時(shí)定義日志的LOGGER級(jí)別，用來(lái)控制輸出的信息范圍。
一方面，過(guò)多的輸出會(huì)影響查看日志的效率，另一方面，過(guò)少的日志讓問(wèn)題定位變得困難。
但當(dāng)線上出現(xiàn)問(wèn)題時(shí)，線上容器通常定義在info級(jí)別，發(fā)生一些疑難問(wèn)題時(shí)，光靠info級(jí)別的日志很難定位問(wèn)題。
一個(gè)典型的場(chǎng)景：在一些需要打印MySQL語(yǔ)句的場(chǎng)景，如果你正在使用MyBatis框架，由于MyBaits中SQL語(yǔ)句是DEBUG級(jí)別的信息，通常在線上容器就沒(méi)法看到。
一個(gè)丑陋的解決辦法就是在沙箱/預(yù)發(fā)環(huán)境，將log4j.xml中的info改為debug：
- <Root level="info">
- <AppenderRef ref="detail"/>
- <AppenderRef level="error" ref="error"/>
- </Root>
然后重新打包部署，再發(fā)起請(qǐng)求來(lái)調(diào)試代碼。
甚至在一些無(wú)法模擬請(qǐng)求的場(chǎng)景下，還需要將修改灰度至線上環(huán)境，大量的debug信息會(huì)對(duì)線上服務(wù)造成實(shí)質(zhì)性的影響。
「本文簡(jiǎn)要介紹如何使用阿里巴巴開(kāi)源Java調(diào)試工具Arthas，實(shí)時(shí)修改線上服務(wù)的LOGGER級(jí)別，從而免去打包再部署的繁雜手續(xù)，更快的定位線上問(wèn)題?！?/p>
「效果演示：」
「本文內(nèi)容重點(diǎn)：」
- Arthas工具簡(jiǎn)介
- 本地測(cè)試：實(shí)時(shí)修改LOGGER級(jí)別
- 線上實(shí)戰(zhàn)：實(shí)時(shí)打印MyBatis SQL語(yǔ)句
- 總結(jié)
Arthas工具簡(jiǎn)介Arthas是阿里開(kāi)源的Java診斷工具，它的功能可以大致參考下圖：
它運(yùn)行的原理是通過(guò)字節(jié)碼生成工具(ASM字節(jié)碼增強(qiáng))，將代理邏輯編織到原來(lái)的類里，實(shí)現(xiàn)對(duì)應(yīng)的監(jiān)控調(diào)試等功能。
關(guān)于Arthas這個(gè)工具，之前「我寫(xiě)了一篇完整的總結(jié)文章」，包括所有功能的使用和原理初探，可以去原文章查看：https://juejin.im/post/6844903998730797070
本地測(cè)試：實(shí)時(shí)修改LOGGER級(jí)別
安裝arthas
網(wǎng)絡(luò)安裝
在接通外網(wǎng)的環(huán)境下，可以使用快速網(wǎng)絡(luò)安裝，會(huì)從阿里的源拉去全量包。
- curl -O https://arthas.aliyun.com/arthas-boot.jar
- java -jar arthas-boot.jar
全量安裝
如果本地外網(wǎng)環(huán)境不通，比如某些容器內(nèi)是不允許外網(wǎng)訪問(wèn)的，那么可以使用預(yù)先下載好的全量安裝包，然后解壓后運(yùn)行包內(nèi)的jar，使用命令：
- java -jar arthas-boot.jar
啟動(dòng)arthas我在本地啟動(dòng)arthas，效果如下圖：
全局Logger信息
使用命令：
- logger
可以看到所有l(wèi)ogger的信息，包括其中每個(gè)appenders。
使用如下命令，修改名稱為ROOT的logger的日志級(jí)別至debug級(jí)別：
- logger --name ROOT --level debug
可以看到多出了debug級(jí)別的輸出。
指定類名的logger信息
在有多個(gè)logger的情況下，可以查找指定名稱的logger
- logger -n ROOT
指定classloader的logger信息
如果需要改變指定類的輸出級(jí)別，先要定位到該類的classLoader，然后修改該clasLoader的logger。
- sc -d cn.monitor4all.miaoshaweb.DynamicLoggerTest | grep classLoaderHash
使用sc命令查看你需要改變的類信息：
隨后可以通過(guò)classLoader找到其對(duì)應(yīng)的logger：
- logger -c 18b4aac2
然后就可以調(diào)整對(duì)應(yīng)的logger日志級(jí)別:
- logger -c 18b4aac2 --name ROOT --level debug
使用 ongl 命令
此外，Arthas還支持使用ognl來(lái)修改日志級(jí)別。但是這種方法對(duì)log4j不友好，修改會(huì)報(bào)錯(cuò)。并且就算支持的logback/slf4j，也需要復(fù)雜的形如ognl -c @org.slf4j.LoggerFactory@getLogger("root").setLevel()的命令才能修改,并不是一個(gè)很好的辦法。
線上實(shí)戰(zhàn)：實(shí)時(shí)打印MyBatis SQL語(yǔ)句
容器內(nèi)啟動(dòng)arthas
我的線上容器，是沒(méi)有外網(wǎng)訪問(wèn)權(quán)限的(這種情況蠻常見(jiàn)的)，我將全量包解壓在容器內(nèi)運(yùn)行：
打印DEBUG級(jí)別的SQL日志
下圖是沒(méi)有DEBUG信息的一條請(qǐng)求日志，可以看到只有入?yún)⒊鰠⒌臄r截器信息(INFO級(jí)別)：
使用logger --name ROOT --level debug，將SQL語(yǔ)句輸出出來(lái)：
畢竟，很多時(shí)候線上的bug是不小心拼錯(cuò)SQL導(dǎo)致。
總結(jié)
文章簡(jiǎn)單總結(jié)了使用Arthas來(lái)動(dòng)態(tài)調(diào)整日志級(jí)別的使用方法。在線上環(huán)境，能夠有效的提升排查問(wèn)題的效率。當(dāng)然Arthas能做的還遠(yuǎn)不止于此，更多有趣并且「實(shí)用」的功能等待大家的發(fā)掘。
參考
https://jueee.github.io/2020/08/2020-08-20-Arthas%E4%B9%8B%E6%9F%A5%E7%9C%8B%E5%92%8C%E4%BF%AE%E6%94%B9%E6%97%A5%E5%BF%97%E7%BA%A7%E5%88%AB/
https://arthas.aliyun.com/doc/logger.html#appenderlogger
https://juejin.im/post/6844903959195303943
本文轉(zhuǎn)載自微信公眾號(hào)「后端技術(shù)漫談」，可以通過(guò)以下二維碼關(guān)注。轉(zhuǎn)載本文請(qǐng)聯(lián)系后端技術(shù)漫談公眾號(hào)。
