為儀錶盤添加互動事件實現下鑽分析

在儀錶盤發現異常時，利用互動事件功能可快速進行下鑽分析，如在Logstore查詢分析、Trace分析或訪問其他儀錶盤等，以實現定位異常根因。本文介紹互動事件的類型和為儀錶盤設定互動事件的操作步驟。

功能介紹

2024-09-12_15-24-27 (1)

當您在儀錶盤發現異常問題時，可以使用互動事件功能快速進行下鑽分析，例如開啟日誌庫（Logstore）、開啟儀錶盤、開啟快速查詢、開啟自訂HTTP連結、開啟Trace詳情、開啟全棧可觀測Trace詳情。

本樣本以Nginx訪問日誌為例，當您單擊餅圖中的狀態為200的部分後，會跳轉到Logstore查詢狀態為200的日誌，查詢時間範圍和儀錶盤的時間範圍相同。

添加請求狀態佔比圖：配置查詢時間範圍、Logstore、查詢分析語句。
為請求狀態佔比圖添加互動事件：將儀錶盤中的PV欄位的互動事件設定為開啟日誌庫，然後添加通過變數動態調整查詢分析語句的參數${{status}}用於在Logstore中查詢儀錶盤中選定狀態的日誌。

Log Service支援的互動事件如下，具體的配置步驟參見文末。

開啟日誌庫

設定互動事件為開啟日誌庫，則觸發互動事件後，將跳轉到目標Logstore頁面。

前提條件
已建立目標Logstore。更多資訊，請參見建立Logstore。

配置參數

參數	說明
自訂名稱	設定互動事件的名稱。
請選擇專案	選擇目標Logstore所屬的Project。
請選擇日誌庫	選擇目標Logstore。觸發互動事件後，將跳轉到目標Logstore頁面。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的日誌庫時，會開啟新的頁面。
時間範圍	設定目標Logstore的查詢時間範圍。
是否繼承過濾	開啟是否繼承過濾開關，將當前儀錶盤已有的過濾條件同步到目標Logstore中，並以`AND`方式添加到查詢分析語句之前。
過濾語句	輸入過濾語句，可將該過濾語句同步到目標Logstore中，並以`AND`方式添加到查詢分析語句之前。您可以單擊添加變量，在過濾語句中插入變數。其中，重要的系統變數說明如下： `${{__start_time__}}`：查詢開始時間。 `${{__end_time__}}`：查詢結束時間。 `${{__interval__}}`：查詢的時間間隔，單位：秒。 `${{__project__}}`：查詢的Project名稱。插入變數後，會將變數值作為過濾條件。

開啟儀錶盤

設定互動事件為開啟儀錶盤，則觸發互動事件後，將跳轉到目標儀錶盤頁面。

前提條件
已建立目標儀錶盤並添加統計圖表。更多資訊，請參見添加統計圖表到儀錶盤。
如果要組態變數，則需在目標儀錶盤的統計圖表中設定查詢分析語句的變數。更多資訊，請參見通過變數動態調整查詢分析語句的參數。

配置參數

參數	說明
自訂名稱	設定互動事件的名稱。
請選擇專案	選擇目標儀錶盤所屬的Project。
請選擇儀錶盤	選擇目標儀錶盤。觸發互動事件後，將開啟該儀錶盤。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的儀錶盤時，會開啟新的頁面。
時間範圍	設定目標儀錶盤的時間範圍。
是否繼承過濾	開啟是否繼承過濾開關，將當前儀錶盤已有的過濾條件同步到目標儀錶盤中。
是否繼承變數	開啟是否繼承變數開關，將當前儀錶盤中已有的變數同步到目標儀錶盤中。
過濾語句	輸入過濾語句，可將該過濾語句同步到目標儀錶盤中。支援在過濾語句中插入變數。您可以單擊添加變量，在過濾語句中插入變數。其中，重要的系統變數說明如下： `${{__start_time__}}`：查詢開始時間。 `${{__end_time__}}`：查詢結束時間。 `${{__interval__}}`：查詢的時間間隔，單位：秒。 `${{__project__}}`：查詢的Project名稱。插入變數後，會將變數值作為過濾條件。
動態變數	Log Service支援將此處設定的變數同步到目標儀錶盤中。動態變數名：組態變數名。動態變數值所在列：以指定列對應的值動態同步到目標儀錶盤中。說明最多可添加5個動態變數。
靜態變數	Log Service支援將此處設定的變數同步到目標儀錶盤中。靜態變數名：組態變數名。靜態值：以固定的欄位值同步到目標儀錶盤中。說明最多可添加5個靜態變數。

自訂HTTP連結

設定互動事件為自訂HTTP連結，則觸發互動事件後，將跳轉到目標頁面。

前提條件
已準備好HTTP連結。

配置參數

配置	說明
自訂名稱	設定互動事件的名稱。
協議	設定連結協議。
連結地址	輸入目標連結地址。支援在連結中添加如下Log Service系統變數，例如`https://sls.console.aliyun.com/lognext/project/${{__project__}}/logsearch/test`。 `${{__start_time__}}`：查詢開始時間。 `${{__end_time__}}`：查詢結束時間。 `${{__interval__}}`：查詢的時間間隔，單位：秒。 `${{__project__}}`：查詢的Project名稱。
是否轉碼	開啟是否轉碼開關後，會將連結中的內容進行Encode轉碼。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的HTTP連結時，會開啟新的頁面。

開啟快速查詢

設定互動事件為開啟快速查詢，則觸發互動事件後，將跳轉到目標快速查詢頁面。

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

配置參數

參數	說明
自訂名稱	設定互動事件的名稱。
請選擇專案	選擇目標快速查詢所屬的Project。
請選擇快速查詢	選擇目標快速查詢。觸發互動事件後，將開啟該快速查詢頁面。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的快速查詢時，會開啟新的頁面。
時間範圍	設定目標快速查詢的時間範圍。
是否繼承過濾	開啟是否繼承過濾開關，將當前儀錶盤已有的過濾條件同步到目標快速查詢中，並以`AND`方式添加到查詢分析語句之前。
過濾語句	輸入過濾語句，可將該過濾語句同步到目標快速查詢中，並以`AND`方式添加到查詢分析語句之前。支援在過濾語句中插入變數。插入變數後，會將變數值作為過濾條件。
動態變數	Log Service支援通過變數靈活修改目標快速查詢中的查詢分析語句。當此處添加的變數和目標快速查詢的查詢分析語句中的變數相同時，會將查詢分析語句中的變數替換為觸發互動事件的欄位值。動態變數名：組態變數名。動態變數值所在列：以指定列對應的值動態替換目標快速查詢的查詢分析語句中的變數。說明最多可添加5個動態變數。
靜態變數	Log Service支援通過變數靈活修改目標快速查詢的查詢分析語句，當此處添加的變數和目標快速查詢的查詢分析語句中的變數相同時，會將查詢分析語句中的變數替換為觸發互動事件的欄位值。靜態變數名：組態變數名。靜態值：以固定的欄位值替換目標快速查詢的查詢分析語句中的變數。說明最多可添加5個靜態變數。

開啟Trace分析

設定互動事件為開啟Trace分析，則觸發互動事件後，將跳轉到Trace分析頁面。

前提條件
已建立Trace執行個體並接入Trace資料。更多資訊，請參見接入Trace資料概述。

配置參數

參數	說明
自訂名稱	設定互動事件的名稱。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的Trace分析時，會開啟新的頁面。
時間範圍	設定Trace分析的時間範圍。
Trace執行個體	選擇目標Trace執行個體。觸發互動事件後，將開啟該Trace執行個體下的分析頁面。
過濾語句	輸入過濾語句，可將該過濾語句同步到目標Trace分析頁面中。支援在過濾語句中插入變數。插入變數後，會將變數值作為過濾條件。

開啟Trace詳情

設定互動事件為開啟Trace詳情，則觸發互動事件後，將跳轉到Trace詳情頁面。

前提條件
已建立Trace執行個體並接入Trace資料。更多資訊，請參見接入Trace資料概述。

配置參數

參數	說明
自訂名稱	設定互動事件的名稱。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的Trace詳情時，會開啟新的頁面。
時間範圍	設定Trace詳情的時間範圍。
Trace執行個體	選擇目標Trace執行個體。觸發互動事件後，將開啟該Trace執行個體下的詳情頁面。
Trace ID	選擇目標Trace ID。
Span ID	選擇目標Span ID。

開啟全棧可觀測Trace分析

設定互動事件為開啟全棧可觀測Trace分析，則觸發互動事件後，將跳轉到全棧可觀測的Trace分析頁面。

前提條件
已建立全棧可觀測執行個體。更多資訊，請參見建立全棧可觀測執行個體。

配置參數

參數	說明
自訂名稱	設定互動事件的名稱。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的全棧可觀測執行個體時，會開啟新的頁面。
時間範圍	設定全棧可觀測執行個體的時間範圍。
全棧可觀測執行個體	選擇目標全棧可觀測執行個體。觸發互動事件後，將開啟該執行個體下的Trace分析頁面。
過濾語句	輸入過濾語句，可將該過濾語句同步到目標Trace分析頁面中。支援在過濾語句中插入變數。插入變數後，會將變數值作為過濾條件。您可以單擊添加變數，在過濾語句中插入變數。其中，重要的系統變數說明如下： `${{__start_time__}}`：查詢開始時間。 `${{__end_time__}}`：查詢結束時間。 `${{__interval__}}`：查詢的時間間隔，單位：秒。 `${{__project__}}`：查詢的Project名稱。插入變數後，會將變數值作為過濾條件。

開啟全棧可觀測Trace詳情

設定互動事件為開啟全棧可觀測Trace詳情，則觸發互動事件後，將跳轉到Trace詳情頁面。

前提條件
已建立全棧可觀測執行個體，Trace執行個體並接入Trace資料。更多資訊，請參見建立全棧可觀測執行個體和接入Trace資料概述。

配置參數

參數	說明
自訂名稱	設定互動事件的名稱。
開啟新視窗	開啟開啟新視窗開關後，點擊關聯的全棧可觀測執行個體時，會開啟新的頁面。
時間範圍	設定全棧可觀測執行個體的時間範圍。
全棧可觀測執行個體	選擇目標全棧可觀測執行個體。觸發互動事件後，將開啟該執行個體下的Trace詳情頁面。
Trace ID	選擇目標Trace ID。
Span ID	選擇目標Span ID。

配置步驟

樣本一：添加互動事件為開啟日誌庫

樣本二：添加互動事件為開啟儀錶盤

1. 添加請求狀態佔比圖

1.1 添加儀錶盤

添加儀錶盤：登入Log Service控制台，選擇目標Project，在儀錶盤>儀錶盤列表頁面，添加儀錶盤名稱為請求狀態佔比圖。

1.2 添加統計圖表

添加統計圖表，單擊添加新圖表。
配置和儲存統計圖表：
1. 在頁面左側配置查詢時間範圍、Logstore、查詢分析語句。
2. 在頁面右側配置圖表類型、分類、數值列的欄位，單擊頁面上方的應用查看圖表配置效果，然後單擊確定儲存圖表。
```
* | 
select 
  count(1) as pv ,status 
group by 
  status
```

2. 添加互動事件

本文以互動事件中的開啟日誌庫為例，介紹為儀錶盤添加互動事件的步驟。最終實現單擊儀錶盤例如200欄位後，會跳轉到Logstore查詢status為200的日誌，查詢時間範圍和儀錶盤的時間範圍相同。

2.1 為欄位添加互動事件

在頁面右側的互動事件頁簽，單擊添加欄位按鈕，在下拉式清單選擇相應欄位。
單擊添加事件，從下拉式清單中選擇開啟日誌庫，在對話方塊中配置日誌庫和動態變數。
日誌庫代表查詢的Logstore，時間範圍代表查詢語句的時間範圍，過濾語句代表在Logstore中的查詢語句。

2.2 儲存圖表和儀錶盤

在統計圖表的編輯頁面的右上方，單擊確定。
在儀錶盤的編輯頁面的右上方，單擊儲存。

2.3 驗證互動事件

在統計圖表中單擊200，然後單擊開啟日誌庫，跳轉到日誌庫後查詢語句為status: 200，查詢時間為儀錶盤中選擇的前天。

將Nginx訪問日誌採集到名為website_log的日誌庫中並建立兩個儀錶盤（RequestMethod和destination_drilldown）實現事件互動。

在名為RequestMethod的儀錶盤中，添加要求方法分類表格，並設定互動事件為開啟destination_drilldown儀錶盤。
在名為destination_drilldown的儀錶盤中，添加PV隨時間分布的折線圖。

設定完成後，您在RequestMethod儀錶盤中單擊各個要求方法即可跳轉到destination_drilldown儀錶盤查看對應的PV趨勢。如下為主要的操作步驟。

在destination_drilldown儀錶盤中，添加PV隨時間分布的線圖。
查詢分析語句如下所示，其中${{method|PUT}}為變數資訊。具體操作，請參見添加統計圖表到儀錶盤。
```
request_method: ${{method|PUT}} | SELECT __time__ - __time__ %60 AS time, COUNT(1) AS PV GROUP BY time ORDER BY time
```
在RequestMethod儀錶盤中，添加要求方法分類表格並設定互動事件。
查詢分析語句如下所示。具體操作，請參見添加統計圖表到儀錶盤。
互動事件配置樣本如下圖所示。
- 設定請選擇儀錶盤為destination_drilldown。
- 設定動態變數名為method，並選擇request_method列。
查看互動事件設定結果。
在RequestMethod儀錶盤的表格中，單擊GET，然後單擊開啟儀錶盤，將跳轉到destination_drilldown儀錶盤。
destination_drilldown儀錶盤中顯示GET請求對應的PV隨時間的變化趨勢。