全部產品
Search
文件中心

Application Real-Time Monitoring Service:Java應用自訂配置

更新時間:Aug 01, 2024

您可以在自訂配置頁簽上調整探針功能開關、採樣策略等常用設定。

說明

如果您需要使用API方式調整,請參見SaveTraceAppConfig

前提條件

重要

ARMS應用監控面向已開通新版計費的使用者提供全新的監控詳情頁面,新版計費詳情,請參見產品計費(新版)

對於未開通新版計費的使用者,如需查看新版監控詳情頁面,可在應用總覽頁面單擊體驗新版

已為應用安裝探針,具體操作,請參見應用監控接入概述

功能入口

  1. 登入ARMS控制台,在左側導覽列選擇應用監控 > 應用列表

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

    說明

    語言列的表徵圖含義如下:

    Java表徵圖:接入應用監控的Java應用。

    image:接入應用監控的Golang應用。

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

  3. 在上方導覽列選擇應用配置 > 自訂配置

  4. 設定自訂配置參數,設定完成後,單擊儲存

採樣設定

採樣設定地區,可以為調用鏈設定採樣策略和採樣介面名稱。更多詳細,請參見調用鏈取樣模式選擇(3.2.8以下探針版本)

image.png

探針開關設定

探針開關設定地區,可以控制應用監控的啟停並調整各外掛程式開關。

重要

應用監控的啟停修改即時生效,無需重啟應用。如果暫停應用監控,則系統將無法監控您的應用,請謹慎操作。要使對各外掛程式開關的修改生效,必須手動重啟應用。

image.png

線程分析設定

線程分析設定地區,可以開啟或關閉線程分析總控開關、定期儲存本地方法棧資訊開關,並設定高耗時調用閾值。

說明

服務調用耗時超過慢調用監聽觸發閾值(預設值為2000毫秒)時才會啟動監聽,並一直持續到該次調用結束或超過15秒。建議將此閾值設為調用耗時的第99百分位元。假設有100次調用,則按耗時從小到大排序,排在第99位的耗時就是第99百分位元。

image.png

應用日誌關聯配置

應用日誌關聯配置地區,可以設定應用關聯的日誌源資訊。更多資訊,請參見日誌分析

image

URL收斂設定

URL收斂設定地區,可以開啟或關閉收斂功能的開關,並設定收斂閾值、收斂規則。URL收斂是指將具有相似性的一系列URL作為一個單獨的個體展示,例如將前半部分都為/service/demo/的一系列URL集中展示。收斂閾值是指要進行URL收斂的最低數量條件,例如當閾值為100時,則符合規則Regex的URL數量達到100才會對它們進行收斂。

image.png

Arthas監控

Arthas監控地區,可以開啟或關閉Arthas診斷功能,並設定生效IP。更多資訊,請參見Arthas診斷

說明

僅應用監控專家版支援該功能。

image.png

持續剖析設定

持續剖析地區,可以開啟或關閉總開關、CPU熱點、記憶體熱點、代碼熱點功能,並設定生效IP或網段。更多資訊,請參見持續剖析

image.png

資訊脫敏設定

資訊脫敏設定地區,通過設定脫敏規則,探針將對JVM系統參數、K8s Yaml、方法入參、Arthas環境變數和系統變數等內容在採集時就進行脫敏處理。脫敏規則中各元素通過英文半形逗號分隔,每一個元素代表一個不區分大小寫Regex,以password為例,脫敏規則等同於Regex.*password.*資訊脫敏

探針在採集資料時會對資料的key按照對應的運算式進行過濾,如果滿足條件,該key會被認為包含敏感性資料進行脫敏處理。如下圖所示,當脫敏規則為licenseKey時,其對-Darms.licenseKey為key的資訊進行了脫敏處理。資訊脫敏2

介面調用配置

介面調用配置地區,可以設定慢調用閾值,並調整異常白名單、HTTP狀態代碼白名單以及調整無效介面調用過濾策略。

  • 異常白名單:輸入不需要查看的異常名,從而將其從異常相關圖表隱去。使用Regex匹配異常全名,多個異常規則請使用英文半形逗號(,)分隔。

  • 異常過濾父類繼承:異常過濾中可配置父類異常。所有繼承該父類的異常都會被過濾。該功能僅支援4.1.6及以上版本探針。

  • HTTP狀態代碼白名單:輸入不需要查看調用情況的介面,從而將其從介面調用頁面隱去。精確匹配HTTP狀態代碼,多個狀態代碼請使用英文半形逗號(,)分隔。

  • 無效介面調用過濾:輸入不需要查看調用情況的介面,從而將其從介面調用頁面隱去。使用Regex匹配無效介面全名,多個規則請使用英文半形逗號(,)分隔。

image.png

資料庫調用配置

資料庫調用配置地區,可以設定慢SQL閾值、採集SQL最大保留長度,並設定是否展示SQL中的變數綁定值以及常量值。

  • 展示SQL中的變數綁定值:捕獲PrepareStatement參數綁定的變數值,無需重啟應用即可生效。

  • 展示SQL中的常量值:僅對SQL截斷,不做額外處理,無需重啟應用即可生效。

image.png

調用鏈透傳通訊協定設定

調用鏈透傳通訊協定設定地區,您可以根據自己的需求選擇使用的Trace協議,ARMS支援的Trace協議請參見ARMS支援Tracing協議

image

預設情況下,當一次調用到來時,ARMS探針會按照EagleEye、OpenTelemetry、SkyWalking、Jaeger、Zipkin的順序依次探測是否存在該協議約定的要求標頭,如果探測到某個協議存在,則按照該協議約定恢複Trace上下文,後續調用下遊時,也按照該協議約定往請求中塞入相關Header。當上述檢測都失敗時,預設使用EagleEye協議。

您可以在該頁面選擇任一協議作為優先協議。選擇並儲存後,ARMS會優先探測是否存在該協議約定的要求標頭。例如,按照如下配置,當一次調用到來時,ARMS探針將會改為按照Jaeger、EagleEye、OpenTelemetry、SkyWalking、Zipkin的順序依次探測是否存在協議約定上下文。

image

您也可以選擇強制使用某一種協議。例如,按照如下配置,當一次調用到來時,ARMS探針只會探測是否存在Jaeger協議約定的要求標頭,如果不存在,不會依次檢測其他協議,而是重建新的Trace上下文。

image

進階設定

進階設定地區,可以設定需過濾的介面、方法堆棧最大長度等。

  • 探針每秒最大鏈路採集量:探針每秒最大可以處理的請求數量,預設為100,大於該閾值的調用鏈不會被收集。

  • 探針記錄層級:調整探針日誌的列印層級,用於問題排查。

  • 暫停採集調用鏈:控制調用鏈功能的啟停,開關開啟時,採集停止。

  • 分位元統計:是否開啟分位元統計功能。

  • 方法堆棧最大保留長度:預設為128條,最大值為400條。

  • 同類異常堆棧區分深度:同類型異常,用於作為不同異常區分的堆棧深度,一般設定為第一個差異調用的深度。

  • 請求入參最大展示長度:預設為512字元,支援的最大長度為2048字元。

  • 自訂RabbitMQ消費者:通過設定自訂消費者的類名或者包含匿名內部消費者的類名,可以看到該消費者的調用鏈路。多個消費者以英文半形逗號(,)分隔。

  • 自訂Kafka消費方法:通過自訂消費方法,可以在通過Kafka原生SDK消費訊息的情境下看到鏈路以及指標資料。

  • 非同步透傳掃描包名:添加非同步透傳掃描包實現非同步任務監控。非同步透傳掃描包中的Runnable、Callable和Supplier介面在建立新對象時會自動捕獲當前線程調用鏈的上下文,並在非同步線程中執行時使用該調用鏈上下文,完成串聯。探針版本必須為v2.7.1.3或以上,升級探針的操作,請參見升級ARMS探針

  • HTTP返回結果中包含TraceId:僅針對HTTP類型的請求,在Response Header中返回欄位為eagleeye-traceid。

將配置複製到其他應用

如果您需要為其他應用同步相同配置,可以將對應配置複製到其他應用上。

將單個配置複製到其他應用

  1. 在對應配置地區單擊儲存並批量複製到其他應用

  2. 如果彈出當前設定未儲存對話方塊,請單擊確定儲存本應用配置後,再單擊儲存並批量複製到其他應用

  3. 在彈出的對話方塊中選擇生效的應用,然後單擊確定

將所有配置複製到其他應用

  1. 在頁面底部單擊儲存並批量複製到其他應用

  2. 如果彈出當前設定未儲存對話方塊,請單擊確定儲存本應用配置後,再單擊儲存並批量複製到其他應用

  3. 在彈出的對話方塊中選擇生效的應用,然後單擊確定

全域預設配置

您可以將當前配置儲存為全域預設配置,在之後建立新應用時將會預設使用當前配置。

  1. 在頁面底部單擊儲存當前應用設定為全域預設配置

  2. 如果彈出當前設定未儲存對話方塊,請單擊確定儲存本應用配置後,再單擊儲存當前應用設定為全域預設配置

  3. 在彈出的對話方塊中單擊確認