Application Real-Time Monitoring Service：Arthas診斷

Arthas版本資訊

ARMS Agent版本為v2.7.1.3～4.6.x對應的Arthas版本為3.5.6。4.7.x及以上對應的Arthas版本為4.1.0。

開通Arthas診斷功能

1. 登入ARMS控制台，在左側導覽列選擇应用监控 > 应用列表。

2. 在应用列表頁面頂部選擇目標地區，然後單擊目標應用程式名稱。

   說明

   语言列的表徵圖含義如下：

   ：接入應用監控的Java應用。

   ：接入應用監控的Golang應用。

   ：接入應用監控的Python應用。

   -：接入可觀測鏈路 OpenTelemetry 版的應用。

3. 在上方導覽列選擇应用配置 > 自定义配置。

4. 在Arthas监控地區，開啟Arthas開關，根據需求選擇是否僅對部分IP進行Arthas診斷，並添加目標IP。

5. 單擊保存。

查看Arthas診斷資訊

1. 登入ARMS控制台，在左側導覽列選擇应用监控 > 应用列表。

2. 在应用列表頁面頂部選擇目標地區，然後單擊目標應用程式名稱。

   說明

   语言列的表徵圖含義如下：

   ：接入應用監控的Java應用。

   ：接入應用監控的Golang應用。

   ：接入應用監控的Python應用。

   -：接入Managed Service for OpenTelemetry的應用。

3. 在上方導覽列選擇应用诊断 > Arthas 诊断。

4. 在Arthas診斷頁面頂部下拉式清單選擇待診斷的應用執行個體。

   • 若該執行個體的Agent版本未升級至2.7.1.3或以上，頁面會提示您需要先升級Agent。

   • 若該執行個體的Agent版本已升級至2.7.1.3或以上，頁面會顯示該執行個體的Arthas診斷資訊。

JVM概覽

JVM概覽支援查看應用的JVM相關資訊，包括JVM記憶體、作業系統資訊、變數資訊等，協助您瞭解JVM的總體情況。

Arthas診斷頁面預設顯示JVM概览頁簽，您可以在JVM概览頁簽查看以下資訊：

• JVM内存：JVM記憶體的相關資訊，包括堆記憶體使用量情況、非堆記憶體使用量情況、GC情況等。其中表格以heap、buffer_pool和nonheap分類展示各記憶體地區的已使用量、總量、最大量以及GC類型對應的總次數和總耗時。

• 操作系统信息：作業系統的相關資訊，包括平均負載情況，作業系統名稱、作業系統版本、Java版本等。具體欄位包括systemLoadAverage、osVersion、javaVersion、processors、osName、javaHome、timestamp和uptime。

• 变量信息：變數的相關資訊，包括系統變數和環境變數。頁面分為左側系統變數和右側環境變數兩個面板，各提供搜尋方塊可按關鍵字篩選，以索引值對形式展示變數名稱和取值。

線程耗時分析

線程耗時分析支援顯示該應用的所有線程和查看線程的堆棧資訊，協助您快速定位耗時較高的線程。

1. 在Arthas診斷頁面，單擊线程耗时分析頁簽。

   线程耗时分析頁簽會即時擷取當前JVM進程的線程耗時情況，並將相似線程彙總。頁面頂部顯示各狀態線程數（NEW、TERMINATED、RUNNABLE、BLOCKED、WAITING、TIMED_WAITING），下方表格以Name、總CPU、數量為列彙總展示線程，展開可查看各線程的ID、CPU使用率、State和查看即時堆棧操作入口。

2. 單擊線程左側的+表徵圖展開線程明細，可以查看線程的ID、CPU使用率和狀態。

3. 如需查看目標線程的堆棧資訊，您可以在目標線程右側的操作列，單擊查看实时堆栈。

   彈出線程詳情對話方塊，顯示線程名稱、狀態（如RUNNABLE）以及完整的Java堆棧資訊。

方法執行分析

方法執行分析支援抓取方法的某一次執行的耗時、入參、傳回值等資訊和鑽入，協助您快速定位導致慢調用的根本原因，以及問題線下無法複現或日誌缺失等情境。

1. 在Arthas診斷頁面，單擊方法执行分析頁簽。

2. 在方法执行分析頁簽的搜尋方塊中輸入類名的關鍵詞，然後單擊表徵圖。

3. 在搜尋到的類中選擇需要診斷的類，然後在右側方法選擇框選取該類的某個方法，單擊确定。

   頁面將會顯示ARMS隨機抓取的該方法的某一次執行的資訊。

   • 左側執行堆棧地區顯示診斷方法的內部執行記錄。

     • 如需鑽入某個內部方法，在其右側操作列，單擊钻入。

     • 如需查看方法源碼，單擊執行堆棧地區頂部的查看方法源碼。

       每一次內部方法的執行耗時都會以注釋的方式顯示在原始碼中。

   • 右側方法執行結果地區顯示方法執行的參數值、傳回值、異常、成員變數以及此次方法執行的TraceID。

   • 右側設定執行條件地區執行以下步驟，可以設定方法執行條件來抓取滿足條件的方法執行記錄。

     1. 選擇當前方法中的一個重載方法。

     2. 在請選擇初始過濾key下拉框選擇初始過濾Key的類型，單擊表徵圖。

        初始過濾Key的類型：

        • params[n]：方法的第n個參數。

        • returnObj：方法的傳回值。

        • 方法執行耗時：方法執行的耗時。

        • 是否拋出異常：方法執行時是否拋出異常。

        說明

        如果選取的初始過濾Key為巢狀型別，則還需要繼續選擇該巢狀型別的內部欄位，直到選擇欄位為基礎類型。

     3. 選擇過濾條件。

     4. 輸入過濾值。

     5. 單擊添加。

        在當前過濾條件地區會顯示已添加的過濾條件。

        例如選擇重載方法doGetDatas(ArmsCtx, String)，設定當前過濾key為params[0].userId，選擇過濾條件為=，填入過濾值123，單擊添加後，當前過濾條件地區顯示已配置的條件（如params.length = 2、params[0].userId = 123）。

     6. 在左側執行堆棧地區右上方單擊表徵圖，系統會按照設定的條件重新抓取一次方法執行。

對象查看器

對象查看器用於查看一些單例對象當前的狀態，用於排查應用狀態異常問題，例如應用配置、黑白名單、成員變數等。

1. 在Arthas診斷頁面，單擊对象查看器頁簽。

2. 在对象查看器頁簽的搜尋方塊中輸入類名的關鍵詞，然後單擊搜索表徵圖。

3. 在搜尋到的類中選擇需要診斷的類，然後在右側執行個體選擇框選擇該類的某個執行個體，單擊确定。

   頁面則會顯示該執行個體中當前欄位的即時取值。頁面分為左側對象欄位即時取值地區（表格顯示類型、欄位名和詳情列）和右側欄位詳情地區（展示選中欄位的詳細JSON資料）。

   • 對於簡單類型的欄位，在左側对象字段实时取值地區的详情列會是欄位的取值。

   • 對於複製類型的欄位，在左側对象字段实时取值地區的详情列單擊点击查看详情，在右側字段详情地區查看欄位取值詳情。

     字段详情地區僅支援將複雜類型欄位還原序列化一層進行展示，如果需要查看更具體的資料，單擊點擊查看欄位更詳細的資料。

即時看板

即時看板用於查看系統中用到的關鍵組件的即時狀態，例如查看資料庫連接池的使用方式、HTTP串連池的使用方式等，有利於排查資源類型的問題。

1. 在Arthas診斷頁面，單擊实时看板頁簽。

2. 在实时看板頁簽的下拉式清單中選擇一個看板，然後在右側執行個體選擇框選擇該看板的一個執行個體，單擊添加到看板。

   頁面顯示該看板的即時情況。以Druid串連池為例，即時狀態資訊包括基礎配置、串連池狀態、執行耗時分布等。其中基礎配置包括DbType、URL等，串連池狀態包括ActiveCount、PoolingCount、MaxActive等指標，下方以柱狀圖展示connection佔用耗時分布和事務執行耗時分布。

效能分析

效能分析支援對CPU耗時、記憶體配置等對象進行一定時間的採樣並產生相應的火焰圖，協助您快速定位應用的效能瓶頸。

1. 在Arthas診斷頁面，單擊性能分析頁簽。

2. 在性能分析頁簽下方，單擊新建火焰圖。

3. 在新建火焰圖對話方塊，選擇火焰圖類型，輸入採樣時間和備忘資訊，然後單擊确认。

   參數	描述	樣本值
   火焰圖類型	採樣對象的類型。取值： cpu耗時 記憶體配置 鎖耗時 itimer	cpu耗時
   輸入採樣時間（單位：秒）	採樣的時間長度。取值：10~1800。	30

   性能分析頁簽下方顯示已建立的火焰圖的任務資訊，包括開始時間、採樣時間、備忘資訊、火焰圖類型和任務狀態。任務完成後，任務狀態列將顯示查看火焰圖連結，可點擊查看產生的火焰圖。

4. 在性能分析頁簽下方，找到任務記錄，在其右側任务状态，單擊查看火焰圖，根據頁面提示下載SVG格式的火焰圖檔案，然後在瀏覽器中開啟。

   

Arthas Shell

通過命令列方式自訂Arthas診斷。

Arthas Shell頁面頂部提供線路選擇和串連/斷開按鈕，串連成功後顯示綠色已串連狀態提示，下方為黑色終端介面，顯示Arthas命令列提示符（如[arthas@9]$），您可以在此輸入Arthas命令進行診斷操作。

常見問題