別再擔心線上 Java 業務出問題怎麼辦了，`Arthas` 幫助你解決以下常見問題：

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

[Arthas](https://arthas.aliyun.com/)（阿爾薩斯）是一款線上監控診斷產品，透過全域性視角實時檢視應用 load、記憶體、gc、執行緒的狀態資訊，並能在不修改應用程式碼的情況下，對業務問題進行診斷，包括檢視方法呼叫的出入參、異常，監測方法執行耗時，類載入資訊等，大大提升線上問題排查效率。

Arthas 採用命令列互動模式，同時提供豐富的 `Tab` 自動補全功能，進一步方便進行問題的定位和診斷。

同時 Arthas 也支援透過 Web Console 進入命令列互動模式，這適用於開發人員沒有伺服器許可權時透過 Arthas Web Console 診斷業務。

## Arthas 在 Rainbond 上整合

**1. 外掛整合**

透過 Rainbond 外掛的機制，從 Rainbond 開源應用商店一鍵安裝 Arthas 外掛並在元件中開通，元件啟動時會自動下載 `arthas-agent.jar` 結合環境變數配置使用 `javaagent` 方式啟動。

**2. Arthas Tunnel 整合**

當我們的微服務業務有 10+，這時透過 Arthas 去診斷就會比較麻煩，開發人員沒有伺服器的許可權並且透過 Web Console 訪問的話也會由於訪問地址太多導致特別混亂。這時就需要透過 Arthas Tunnel Server/Client 來遠端管理/連線多個 Agent。

Arthas Agent 會透過 WS 註冊到 Arthas Tunnel 中，實現統一管理。

Arthas Tunnel 可透過 Rainbond 開源應用商店一鍵安裝。

**3. Arthas Web Console**

對於 Spring Boot 應用則無需透過 Arthas Tunnel 訪問 Web Console，在元件內新增8563埠即可訪問 Web Console。(注意：域名訪問需開啟 Websocket 支援

![](https://static.goodrain.com/wechat/arthas/10.png)

## 使用Arthas診斷Rainbond上的Spring Boot應用

本小節使用若依SpringBoot作為示例。

首先需要安裝 Rainbond雲原生應用管理平臺，可參閱文件 [安裝 Rainbond Allinone](https://www.rainbond.com/docs/installation/install-with-dind)

### 1. 部署 Spring Boot 應用

團隊 -> 新增 -> 基於應用商店建立元件 -> 在應用商店中搜尋 `若依SpringBoot` 進行一鍵部署。

![](https://static.goodrain.com/wechat/arthas/11.png)

### 2. 安裝 Arthas Java Agent 外掛並配置

**2.1 安裝外掛**

團隊 -> 外掛 -> 從應用商店安裝外掛 -> 在應用商店中搜尋 `Arthas-Agent` 進行一鍵部署。

![](https://static.goodrain.com/wechat/arthas/4.png)

**2.2 開通外掛**

為`ruoyi-admin` 開通 Arthas Agent 外掛，在元件內 -> 外掛 -> 未開通 -> 開通外掛。

![](https://static.goodrain.com/wechat/arthas/12.png)

**2.3 環境變數配置**

為 `ruoyi-admin` 元件配置環境變數，在元件內 -> 環境變數 -> 新增變數。

| 變數名          | 變數值                              |
| --------------- | ----------------------------------- |
| JAVA_OPTS       | -javaagent:/arthas/arthas-agent.jar |
| ARTHAS_APP_NAME | ruoyi-admin                         |
| ARTHAS_AGENT_ID | ruoyi-admin                         |

**2.4 新增埠並更新**

為 `ruoyi-admin` 元件新增 8563 埠並開啟對外服務，更新元件完成後可透過預設域名訪問 Web Console。

![](https://static.goodrain.com/wechat/arthas/13.png)

![](https://static.goodrain.com/wechat/arthas/14.png)

## 使用Arthas診斷Rainbond上的SpringCloud應用

使用 Arthas 診斷部署在 Rainbond 上的微服務 Spring Cloud Pig，並透過 Arthas Tunnel 統一管理 Arthas agent。本小節將使用 Spring Cloud Pig 作為示例。

首先需要安裝 Rainbond雲原生應用管理平臺，可參閱文件 [安裝 Rainbond Allinone](https://www.rainbond.com/docs/installation/install-with-dind)

### 1. 部署 Spring Cloud Pig

團隊 -> 新增 -> 基於應用商店建立元件 -> 在應用商店中搜尋 `SpringCloud-Pig` 進行一鍵部署。

![](https://static.goodrain.com/wechat/arthas/3.png)

### 2. 部署 Arthas Tunnel

團隊 -> 新增 -> 基於應用商店建立元件 -> 在應用商店中搜尋 `Arthas-Tunnel` 進行一鍵部署。

![](https://static.goodrain.com/wechat/arthas/5.png)

### 3. 安裝 Arthas Agent 外掛並配置

**1. 安裝外掛**

團隊 -> 外掛 -> 從應用商店安裝外掛 -> 在應用商店中搜尋 `Arthas-Agent` 進行一鍵部署。

![](https://static.goodrain.com/wechat/arthas/4.png)

**2. 開通外掛**

為每個微服務元件都開通外掛，進入微服務元件 -> 外掛 -> 開通外掛 `Arthas-Agent` 。

![](https://static.goodrain.com/wechat/arthas/6.png)

**3. 配置環境變數**

為每個微服務元件配置環境變數，在元件內 -> 環境變數 -> 新增變數。

| 變數名          | 變數值                              | 說明                                        |
| --------------- | ----------------------------------- | ------------------------------------------- |
| JAVA_OPTS       | -javaagent:/arthas/arthas-agent.jar | JAVA 啟動引數                               |
| ARTHAS_APP_NAME | register                            | arthas app name，根據實際情況修改           |
| ARTHAS_AGENT_ID | register                            | arthas agent ID 不可與其他 ID相同，是唯一的 |

**4. 配置依賴關係**

將所有微服務元件依賴至 `arthas tunnel`，應用檢視切換到編排模式進行拖拉拽。

![](https://static.goodrain.com/wechat/arthas/arthasgif.gif)

**5. 批次更新**

更新/重啟所有微服務相關元件。可在 `列表` 中批次操作。

### 4. 透過 Arthas Tunnel 連線到其他 Agent 進行診斷

1.可透過 Arthas Tunnel  8080 埠預設生成的域名訪問 Web Console。

2.在 Web Console 中的 IP:PORT 填寫 Arthas Tunnel 7777 的對外服務埠，7777 埠是 Agent 連線到 Tunnel 的。所以在透過 Web 遠端連線到其他服務時修改 AgentId 即可連線

![](https://static.goodrain.com/wechat/arthas/7.png)

![](https://static.goodrain.com/wechat/arthas/8.png)

## Arthas 使用入門

### 1. Arthas 命令使用

Arthas 採用命令列互動模式，同時提供豐富的 `Tab` 自動補全功能，進一步方便進行問題的定位和診斷，以下是部分命令，詳細請參閱文件 [Arthas命令列表](https://arthas.aliyun.com/doc/commands.html)

* dashboard - 當前系統的實時資料皮膚
* getstatic - 檢視類的靜態屬性
* heapdump - dump java heap, 類似 jmap 命令的 heap dump 功能
* jvm - 檢視當前 JVM 的資訊
* logger - 檢視和修改 logger
* mbean - 檢視 Mbean 的資訊
* memory - 檢視 JVM 的記憶體資訊
* ognl - 執行 ognl 表示式
* perfcounter - 檢視當前 JVM 的 Perf Counter 資訊
* sysenv - 檢視 JVM 的環境變數
* sysprop - 檢視和修改 JVM 的系統屬性
* thread - 檢視當前 JVM 的執行緒堆疊資訊
* vmoption - 檢視和修改 JVM 裡診斷相關的 option
* vmtool - 從 jvm 裡查詢物件，執行 forceGc

以下是部分命令的使用截圖：

![](https://static.goodrain.com/wechat/arthas/15.png)

![](https://static.goodrain.com/wechat/arthas/16.png)

![](https://static.goodrain.com/wechat/arthas/17.png)

### 2. 生成火焰圖

`profiler` 命令支援生成應用熱點的火焰圖。本質上是透過不斷的取樣，然後把收集到的取樣結果生成火焰圖。  
以下命令均在Arthas Tunnel Web Console 中執行。

**1.啟動 profiler**

```shell
$ profiler start
Started [cpu] profiling
```

**2.停止 profiler 並生成火焰圖**

預設情況下，結果檔案是`html`格式，也可以用`--format`引數指定：

```shell
$ profiler stop --format html
OK
profiler output file: /app/arthas-output/20220907-214802.html
```

**3.透過瀏覽器檢視火焰圖**

上一步生成的 html 檔案在指定的微服務元件中，所以需要在該微服務元件中檢視火焰圖。

進入到該微服務元件中，例如：pig-auth，在元件埠中新增 `3658` 埠並開啟對外服務並訪問 `http://domain/arthas-output`

![](https://static.goodrain.com/wechat/arthas/9.png)

## 最後

Arthas 是款非常好的 Java 診斷工具，而在 Kubernetes 中使用較為複雜。Rainbond 底層基於 Kubernetes，在此之上抽象了應用模型，使使用者更方便的在 Kubernets 中部署管理應用，並且透過 Rainbond 的外掛機制讓使用者更便捷的使用 Arthas 診斷業務，降低了在 Kubernetes 中使用 Arthas 的門檻，使用者只需關注業務。

原文連結：https://mp.weixin.qq.com/s/soEhi5oQn2p1h7xDL68hlg

乾貨分享！JAVA診斷工具Arthas在Rainbond上實踐~

相關文章