全部產品
Search
文件中心

Application Real-Time Monitoring Service:為調用鏈配置自訂互動事件

更新時間:Sep 21, 2024

事件配置用於對單個欄位或單個查詢分析進行下鑽(Drilldown)分析,加深資料分析的維度。您可以為調用鏈的一個或多個屬性設定互動事件,方便查詢更詳盡的調用鏈或查看與調用鏈關聯的日誌、指標等資訊。本文介紹互動事件相關的配置說明。

互動事件是資料分析中不可缺少的功能之一,通過改變資料維度的層次、變換分析的粒度從而擷取資料中更詳盡的資訊。調用鏈分析支援對Span的欄位、屬性設定互動事件。互動事件類型包括:

  • 開啟日誌庫:跳轉到Log Service目標Logstore頁面。

  • 自訂HTTP連結:跳轉到目標HTTP連結頁面。

  • 從編輯框中開啟:在彈窗中以文字格式設定或JSON格式展示欄位值。

  • 開啟快速查詢:跳轉到Log Service目標快速查詢頁面。

添加自訂互動事件

  1. 調用鏈分析頁面單擊調用鏈的TraceId

  2. 選中目標介面,在右側的Span詳情地區單擊事件配置

    image

  3. 在彈出的Drilldown 配置面板中,選擇互動事件的生效範圍。

    自訂事件生效範圍有兩種,包括服務事件配置全域事件配置。服務事件配置僅在當前應用的所有調用鏈中生效,而全域事件配置在當前地區的所有調用鏈中生效。

    image

  4. 單擊添加欄位,選擇需要配置自訂事件的欄位,然後單擊確定。

    image

  5. 單擊添加事件,從下拉框中選擇互動事件。

    image

  6. 填寫互動事件的參數,配置完成後單擊確認

    具體參數的說明請參見下文互動事件參數說明

    image

觸發自訂事件

Span詳情地區將滑鼠懸浮到藍色欄位上,會彈出懸浮框展示已配置的自訂事件,單擊事件名即可觸發互動事件。

image

互動事件參數說明

開啟日誌庫

觸發開啟日誌庫互動事件後,控制台將跳轉到Log Service目標Logstore頁面。

  • 前提條件

    已建立目標Logstore。更多資訊,請參見管理Logstore

  • 配置參數

    參數

    是否必填

    說明

    自訂名稱

    自訂互動事件的名稱,該名稱會展示在自訂事件懸浮框中。

    請選擇region

    選擇Log Service目標Project所在地區。

    請選擇專案

    選擇Log Service目標Project名稱。

    請選擇日誌庫

    選擇Log Service目標Logstore名稱。觸發互動事件後,將跳轉到目標Logstore頁面。

    開啟新視窗

    開啟該選項,則觸發互動事件後將在新視窗開啟目標Logstore。

    時間範圍

    設定目標Logstore的查詢時間範圍。可以設定為:

    • 預設:跳轉到目標Logstore頁面後,對應的查詢時間為Log Service預設的查詢時間,即15分鐘(相對)。

    • 繼承當前查詢時間:跳轉到目標Logstore頁面後,對應的查詢時間為觸發互動事件時調用鏈分析頁面對應的時間。

    • 繼承資料點時間:跳轉到目標Logstore頁面後,對應的查詢開始時間為觸發互動事件時所選調用鏈的時間範圍欄位值減去時間範圍欄位差值,查詢結束時間為時間範圍欄位值加上時間範圍欄位差值

    • 相對時間:跳轉到目標Logstore頁面後,對應的查詢時間為當前指定的相對時間。

    • 整點時間:跳轉到目標Logstore頁面後,對應的查詢時間為當前指定的整點時間。

    過濾語句

    輸入過濾語句,可將該過濾語句同步到目標Logstore中,並以AND方式添加到查詢分析語句之前。

    在過濾語句中添加變數,可以將對應欄位的值作為過濾條件。

    樣本:traceId=${{traceID}} AND spanId=${{spanID}}

自訂HTTP連結

觸發自訂HTTP連結互動事件後,控制台將跳轉到目標HTTP連結頁面。

  • 前提條件

    已準備好HTTP連結。

  • 配置參數

    參數

    是否必填

    說明

    自訂名稱

    自訂互動事件的名稱,該名稱會展示在自訂事件懸浮框中。

    協議

    選擇HTTP連結的協議。

    連結地址

    需要跳轉到的目標地址。

    HTTP連結中的路徑部分表示訪問的目標檔案的層級路徑,您可以在定義HTTP連結的路徑部分添加變數,單擊連結時,對應欄位值將會替換HTTP連結中的參數,跳轉到重新置放的HTTP連結中。

    是否轉碼

    開啟是否轉碼開關後,連結中的內容將會進行encode轉碼。

    開啟新視窗

    開啟該選項,觸發互動事件後將在新視窗開啟目標HTTP連結頁面。

從編輯框中開啟

觸發從編輯框中開啟互動事件後,控制台將在彈窗中以文字格式設定或JSON格式展示欄位值。

參數

是否必填

說明

自訂名稱

自訂互動事件的名稱,該名稱會展示在自訂事件懸浮框中。

文本類型

選擇以文字格式設定或JSON格式展示欄位值。

開啟快速查詢

觸發開啟快速查詢互動事件後,控制台將跳轉到Log Service目標快速查詢頁面。

  • 前提條件

    已在Log Service中建立目標快速查詢。更多資訊,請參見快速查詢

    如果要設定變數,則需在目標快速查詢中設定查詢分析語句的變數。更多資訊,請參見變數

  • 配置參數

    參數

    是否必填

    說明

    自訂名稱

    自訂互動事件的名稱,該名稱會展示在自訂事件懸浮框中。

    請選擇region

    選擇Log Service目標Project所在地區。

    請選擇專案

    選擇Log Service目標Project名稱。

    請選擇快速查詢

    選擇Log Service目標快速查詢。觸發互動事件後,將開啟該快速查詢頁面。

    開啟新視窗

    開啟該選項,觸發互動事件後將在新視窗開啟目標快速查詢頁面。

    時間範圍

    設定目標快速查詢的時間範圍。可以設定為:

    • 預設:跳轉到目標快速查詢頁面後,保持Log Service預設的查詢時間範圍,即15分鐘(相對)。

    • 繼承目前時間:跳轉到目標快速查詢頁面後,對應的查詢時間為觸發互動事件時調用鏈分析頁面對應的時間。

    • 繼承資料點時間:跳轉到目標快速查詢頁面後,對應的查詢開始時間為觸發互動事件時所選調用鏈的時間範圍欄位值減去時間範圍欄位差值,查詢結束時間為時間範圍欄位值加上時間範圍欄位差值

    • 相對時間:跳轉到目標快速查詢頁面後,對應的查詢時間為當前指定的相對時間。

    • 整點時間:跳轉到目標快速查詢頁面後,對應的查詢範圍為當前指定的整點時間。

    過濾語句

    輸入過濾語句,可將該過濾語句同步到目標快速查詢頁面中,並以AND方式添加到查詢分析語句之前。

    在過濾語句中添加變數,可以將對應欄位的值作為過濾條件。

    動態變數

    Log Service支援通過變數靈活修改目標快速查詢中的查詢分析語句,當此處添加的變數和目標快速查詢的查詢分析語句中的變數相同時,查詢分析語句中的變數將會被觸發互動事件的欄位值替換。

    說明

    最多可添加5個動態變數和5個靜態變數。

    • 動態變數

      • 動態變數名:設定變數名。

      • 動態變數值所在列:以指定列對應的值動態替換目標快速查詢的查詢分析語句中的變數。

    • 靜態變數

      • 靜態變數名:設定變數名。

      • 靜態值:以固定的欄位值替換目標快速查詢的查詢分析語句中的變數。

    靜態變數

預置互動事件(進階配置)

調用鏈分析提供了預置的互動事件,包括以下內容:

image

內建事件名稱

生效欄位

說明

使用當前條件查詢調用鏈

除Span Events外的所有欄位

將該欄位作為查詢條件追加到調用鏈分析的查詢中。

查看應用詳情

應用程式名稱(serviceName)

跳轉至應用監控的應用概覽頁面。

查看提供服務

介面名(spanName)

跳轉至應用監控的提供服務頁面。

查看執行個體監控

IP

跳轉至應用監控的執行個體監控頁面。

查看原始Trace資料

TraceID、SpanId

查看儲存在Log Service中的原始調用鏈資料。

常見問題

如果您使用虛商網域名稱訪問調用鏈分析頁面(例如將ARMS頁面嵌入了自建Web頁面),觸發開啟日誌庫開啟快速查詢事件後將無法正常訪問Log Service控制台,而是跳轉至登入頁。您可以通過自訂HTTP連結實現同樣的效果,具體步驟如下:

  1. 在事件配置中建立自訂HTTP連結互動事件。

  2. 協議選擇https,並在連結地址中填寫跳轉連結。

  3. 準備要跳轉到的Log Service連結,並將連結的網域名稱(sls.console.aliyun.com)替換為Log Service虛商網域名稱(sls4service.console.aliyun.com),更多資訊請參見準備分享連結image

  4. 如果您希望跳轉到日誌庫時攜帶查詢參數,請單擊查詢變數選擇要添加的變數。

    連結地址樣本如下,該連結會開啟Project名稱為test-project、Logstore名稱為test-logstore的日誌庫,並過濾traceId為當前調用鏈的traceId。

    https://sls.console.aliyun.com/lognext/project/test-project/logsearch/test-logstore?queryString=traceId=${{traceID}}