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

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

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

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

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

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

添加自訂互動事件

1. 在调用链分析頁面單擊調用鏈的TraceId。

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

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

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

   在服務事件配置頁簽下，單擊添加欄位，添加 spanID 和 traceID 欄位。

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

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

   可選的互動事件包括開啟日誌庫、自訂HTTP連結、從編輯框中開啟、開啟快速查詢。

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

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

   在 服務事件配置 頁簽下，為 spanID 節點添加事件，填寫 自訂名稱 並選擇 文本類型，單擊 添加事件 可繼續添加新的互動事件。

觸發自訂事件

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

例如，將滑鼠懸浮到 spanId 欄位值上，快顯功能表的 自訂事件 地區將展示 從編輯框中開啟 和 查詢關聯日誌 等已配置的事件。

互動事件參數說明

開啟日誌庫

觸發開啟日誌庫互動事件後，控制台將跳轉到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格式展示欄位值。

開啟快速查詢

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

• 前提條件

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

  如果要設定變數，則需在目標快速查詢中設定查詢分析語句的變數。更多資訊，請參見通過變數動態調整查詢分析語句的參數。

• 配置參數

  參數	是否必填	說明
  自訂名稱	是	自訂互動事件的名稱，該名稱會展示在自訂事件懸浮框中。
  請選擇region	是	選擇Log Service目標Project所在地區。
  請選擇專案	是	選擇Log Service目標Project名稱。
  請選擇快速查詢	是	選擇Log Service目標快速查詢。觸發互動事件後，將開啟該快速查詢頁面。
  開啟新視窗	否	開啟該選項，觸發互動事件後將在新視窗開啟目標快速查詢頁面。
  時間範圍	否	設定目標快速查詢的時間範圍。可以設定為： 預設：跳轉到目標快速查詢頁面後，保持Log Service預設的查詢時間範圍，即15分鐘（相對）。 繼承目前時間：跳轉到目標快速查詢頁面後，對應的查詢時間為觸發互動事件時調用鏈分析頁面對應的時間。 繼承資料點時間：跳轉到目標快速查詢頁面後，對應的查詢開始時間為觸發互動事件時所選調用鏈的時間範圍欄位值減去時間範圍欄位差值，查詢結束時間為時間範圍欄位值加上時間範圍欄位差值。 相對時間：跳轉到目標快速查詢頁面後，對應的查詢時間為當前指定的相對時間。 整點時間：跳轉到目標快速查詢頁面後，對應的查詢範圍為當前指定的整點時間。
  過濾語句	否	輸入過濾語句，可將該過濾語句同步到目標快速查詢頁面中，並以AND方式添加到查詢分析語句之前。 在過濾語句中添加變數，可以將對應欄位的值作為過濾條件。
  動態變數	否	Log Service支援通過變數靈活修改目標快速查詢中的查詢分析語句，當此處添加的變數和目標快速查詢的查詢分析語句中的變數相同時，查詢分析語句中的變數將會被觸發互動事件的欄位值替換。 說明 最多可添加5個動態變數和5個靜態變數。 動態變數 動態變數名：設定變數名。 動態變數值所在列：以指定列對應的值動態替換目標快速查詢的查詢分析語句中的變數。 靜態變數 靜態變數名：設定變數名。 靜態值：以固定的欄位值替換目標快速查詢的查詢分析語句中的變數。
  靜態變數	否

預置互動事件（進階配置）

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

按右鍵Span欄位值後彈出的快速查詢菜單分為進階配置和自訂事件兩個地區，進階配置地區展示內建事件（如使用當前條件查詢調用鏈、查看應用詳情），自訂事件地區展示使用者自行配置的事件，底部提供事件配置入口用於管理自訂事件。

常見問題

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

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

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

3. 準備要跳轉到的Log Service連結，並將連結的網域名稱（sls.console.alibabacloud.com）替換為Log Service虛商網域名稱（sls4servims.console.alibabacloud.com），更多資訊請參見準備分享連結。其中，是否轉碼保持關閉，開啟新視窗開關保持開啟。

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

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

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