Arthas(阿爾薩斯) 能為你做什麼?
Arthas
是Alibaba開源的Java診斷工具,深受開發者喜愛。當你遇到以下類似問題而束手無策時,
Arthas
可以幫助你解決:
- 這個類從哪個 jar 包載入的?為什麼會報各種類相關的 Exception?
- 我改的程式碼為什麼沒有執行到?難道是我沒 commit?分支搞錯了?
- 遇到問題無法線上上 debug,難道只能通過加日誌再重新發布嗎?
- 線上遇到某個使用者的資料處理有問題,但線上同樣無法 debug,線下無法重現!
- 是否有一個全域性視角來檢視系統的執行狀況?
- 有什麼辦法可以監控到JVM的實時執行狀態?
- 怎麼快速定位應用的熱點,生成火焰圖?
- 怎樣直接從JVM內查詢某個類的例項?
Arthas
支援JDK 6+,支援Linux/Mac/Windows,採用命令列互動模式,同時提供豐富的Tab
自動補全功能,進一步方便進行問題的定位和診斷。
具體內容請檢視官方文件,各個命令有詳細的說明: https://arthas.aliyun.com/doc/
本文不是介紹arthas怎麼用的。這裡要說的是,如何在我們的docker容器中,使用arthas。
鑑於我們在docker容器中使用arthas十分複雜,需要找到容器id,需要複製整個arthas目錄到容器中,需要進入容器,需要切換到目標服務的使用者,需要啟動arthas,這些步驟對於很多對linux命令和docker命令不熟悉的同學並不友好。
因此我寫了個指令碼,可以直接替代以上步驟,使用方法如下圖所示:
直接在指令碼後,輸入完整的服務名(這裡取的是容器的IMAGE名稱),即可使用,簡單便捷。
使用方法:
- 首先需要在linux伺服器上解壓arhas-bin.zip,解壓出來即是arthas軟體。確保本機已安裝docker
下載目錄:https://github.com/alibaba/arthas/releases
- 將arthasDocker.sh指令碼,放到剛才解壓的arthas目錄中,開啟指令碼,編輯ARTHAS_PATH變數,改為你arthas放置的目錄。
arthasDocker.sh指令碼內容:
#!/bin/bash
#
# author: 劉力源
# date: 2020-8-20 18:14:38
# desc: 本指令碼需要放到arthas的目錄中,連同整個目錄一起復制到docker容器中去。主要用途為在容器中切換目標服務的使用者,並啟動arthas
echo "開始查詢目標服務的程式id和使用者..."
PID=`ps -eo pid,user=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa -o args | grep java | grep -v grep | awk '{print $1}'`
echo "目標服務的程式id為${PID}"
USER=`ps -eo pid,user=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa -o args | grep java | grep -v grep | awk '{print $2}'`
echo "目標服務的使用者為${USER}"
if [[ ! -d "/home/${USER}" ]]
then
mkdir -p /home/${USER}
echo "建立目錄/home/${USER}"
fi
chmod 777 /home/${USER}
echo "開始切換使用者並啟動arthas..."
# 下面的arthas路徑需要修改,並且要和startArthas.sh指令碼中保持一致
ARTHAS_PATH="/opt/arthas"
su ${USER} -c "java -jar ${ARTHAS_PATH}/arthas-client.jar 127.0.0.1 3658 -c 'stop'"
su ${USER} -c "java -jar ${ARTHAS_PATH}/arthas-boot.jar ${PID}"
- 將startArthas.sh指令碼,放到linux伺服器上,建議放到~目錄下,開啟指令碼,編輯ARTHAS_PATH變數,改為你arthas放置的目錄。然後賦予指令碼執行許可權
startArthas.sh指令碼內容:
#! /bin/bash
#
# author: 劉力源
# date: 2020-9-18 10:36:27
# desc: 本指令碼主要用途為啟動arthas診斷工具來診斷某個docker中java服務
if [[ ${1} == '' ]]
then
echo "請選擇一個服務:"
sudo docker ps | awk 'NR>1 {print $2}'
exit 0
fi
echo "開始尋找服務${1}的容器..."
DOCKER_LIST=`sudo docker ps | awk 'NR>1 {print $2}'`
FLAG=0
for i in ${DOCKER_LIST[@]}
do
if [[ ${i} == ${1} ]]
then
FLAG=1
break
fi
done
if [[ ${FLAG} == 0 ]]
then
DOCKER_NAME=`sudo docker ps | awk 'NR>1 {print $2}' | grep ${1}`
if [[ ${DOCKER_NAME} == '' ]]
then
echo "未找到該服務的容器,請重新選擇服務:"
sudo docker ps | awk 'NR>1 {print $2}'
else
echo "請輸入服務的完整名稱:"
sudo docker ps | awk 'NR>1 {print $2}' | grep ${1}
fi
else
ID=`sudo docker ps --filter ancestor=${1} | awk '{print $1}' | sed -n '2p'`
echo "找到容器${ID}"
echo "開始複製arthas到容器中..."
# 下面的arthas路徑需要修改,並且要和arthasDocker.sh指令碼中保持一致
ARTHAS_PATH="/opt/arthas"
sudo docker exec -it ${ID} /bin/bash -c "rm -rf ${ARTHAS_PATH}"
sudo docker cp ${ARTHAS_PATH} ${ID}:${ARTHAS_PATH}
echo "複製完成"
echo "即將進入容器中..."
sudo docker exec -it ${ID} /bin/bash -c "bash ${ARTHAS_PATH}/arthasDocker.sh"
fi
- 最後直接執行 startArthas.sh 指令碼就可以了