如何在Docker容器中使用Arthas

dijia478發表於2021-12-01
Docker

Arthas（阿爾薩斯） 能為你做什麼？

Arthas 是Alibaba開源的Java診斷工具，深受開發者喜愛。

當你遇到以下類似問題而束手無策時，Arthas可以幫助你解決：

  1. 這個類從哪個 jar 包載入的？為什麼會報各種類相關的 Exception？
  2. 我改的程式碼為什麼沒有執行到？難道是我沒 commit？分支搞錯了？
  3. 遇到問題無法線上上 debug，難道只能通過加日誌再重新發布嗎？
  4. 線上遇到某個使用者的資料處理有問題，但線上同樣無法 debug，線下無法重現！
  5. 是否有一個全域性視角來檢視系統的執行狀況？
  6. 有什麼辦法可以監控到JVM的實時執行狀態？
  7. 怎麼快速定位應用的熱點，生成火焰圖？
  8. 怎樣直接從JVM內查詢某個類的例項？

Arthas支援JDK 6+，支援Linux/Mac/Windows，採用命令列互動模式，同時提供豐富的 Tab 自動補全功能，進一步方便進行問題的定位和診斷。

具體內容請檢視官方文件，各個命令有詳細的說明： https://arthas.aliyun.com/doc/

本文不是介紹arthas怎麼用的。這裡要說的是，如何在我們的docker容器中，使用arthas。

鑑於我們在docker容器中使用arthas十分複雜，需要找到容器id，需要複製整個arthas目錄到容器中，需要進入容器，需要切換到目標服務的使用者，需要啟動arthas，這些步驟對於很多對linux命令和docker命令不熟悉的同學並不友好。

因此我寫了個指令碼，可以直接替代以上步驟，使用方法如下圖所示：

直接在指令碼後，輸入完整的服務名（這裡取的是容器的IMAGE名稱），即可使用，簡單便捷。

使用方法：

  1. 首先需要在linux伺服器上解壓arhas-bin.zip，解壓出來即是arthas軟體。確保本機已安裝docker

下載目錄：https://github.com/alibaba/arthas/releases

  1. 將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}"
  1. 將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
  1. 最後直接執行 startArthas.sh 指令碼就可以了

相關文章