如何通過添加過濾器篩選儀錶盤以及通過添加變數替換篩選統計圖表 - Simple Log Service

添加過濾器篩選儀錶盤

過濾器類型

每張統計圖表實際為一個查詢和分析語句，過濾器用於為儀錶盤中的所有統計圖表批量修改查詢條件或替換預留位置變數，實現對整個儀錶盤資料的篩選功能。Log Service支援三種類型的過濾器：

過濾器類型的過濾器：通過日誌欄位的Key和Value進行過濾。在原查詢和分析語句的結果中，尋找包含或者不包含Key:Value的日誌。例如查看不同要求方法的訪問PV時，可以添加過濾器類型的過濾器，通過動態清單項目快速查看。
變數類型的過濾器：先添加變數，然後添加過濾器，自動將統計圖表的查詢和分析語句中的變數替換為您選擇的變數值。例如查看每10秒、60秒或600秒的訪問PV。
時序過濾器：採集時序資料後，可以通過Label和Value進行篩選，多個過濾條件取交集。

過濾器類型的過濾器

1. 將統計圖表添加到儀錶盤

添加儀錶盤。
在目標儀錶盤的編輯模式下，單擊添加 > 添加新圖表。
在頁面左側配置查詢時間範圍、LogStore、查詢分析語句。在頁面右側選擇表格。單擊頁面上方的應用查看圖表配置效果，然後單擊確定儲存圖表。

查看每分鐘的訪問PV的查詢分析語句如下：
```
* | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

2. 添加過濾器類型的過濾器

在目標儀錶盤的編輯模式下，單擊頁面的右上方的表徵圖。

在過濾器面板中，完成以下設定，然後單擊確定。

用於動態清單項目預覽的樣本查詢與分析語句如下：

*|select distinct request_method

本樣本中，Key值設為request_method，日誌庫選擇website_log，時間範圍設為15min（最近15分鐘），動態清單項目預覽結果包含GET、POST、DELETE、PUT四個值。

過濾器類型的過濾器參數說明

參數	說明
名稱	過濾器名稱。
類型	過濾器：建立過濾器類型的過濾器，通過欄位名和欄位值進行過濾。在執行過濾器操作時，將其作為過濾條件增加到查詢和分析語句前，使用AND或NOT進行串連，預設為AND。 AND：`Value AND [search query] \| [sql query]` NOT：`Value NOT [search query] \| [sql query]` 在靜態列表項中添加值，支援設定多個值。
全局過濾	開啟全局過濾，表示在所有欄位中過濾Value，無需指定Key。關閉全局過濾，表示僅在指定的Key中過濾Value。
Key值	在Key值中配置目標欄位名。
別名	列的別名。
自動過濾	開啟自動過濾，會自動過濾掉資料來源中不存在的值。
顯示設置	設定過濾器的顯示樣式。開啟顯示標題開關，為過濾器增加標題。開啟顯示邊框開關，為過濾器增加邊框。開啟顯示背景開關，為過濾器增加白色背景。
查詢方式	使用AND方式或NOT方式進行串連。
靜態列表項	設定Key值對應的Value。多次單擊+，可添加多個Value。如果開啟預設選中，則每次開啟儀錶盤時，預設使用該Value執行過濾。
添加動態列表項	開啟添加動態列表項開關，可添加動態清單項目，即為Key值配置動態Value。動態清單項目為對應查詢和分析語句的查詢結果，在不同的時間範圍內，查詢結果是動態變化的。開啟添加動態列表項開關後，需配置如下參數。請選擇Project：選擇您要查詢的專案。請選擇日誌庫：選擇您要查詢的日誌庫。是否繼承過濾：開啟是否繼承過濾開關後，在執行過濾時繼承儀錶盤中已有的過濾條件。查詢剖析：輸入查詢和分析語句並設定時間範圍。動態列表項預覽：確認查詢結果。

調整頁面配置，單擊保存，在儲存儀錶盤對話方塊，單擊確認。

3. 驗證結果

在目標儀錶盤頁面，在request_method下拉框中選擇GET和PUT，代表查詢GET和PUT方法的訪問PV。該操作對應的查詢和分析語句如下：

(*)and (request_method: GET OR request_method: PUT)| SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time

變數類型的過濾器

1. 為統計圖表的查詢分析語句設定變數

添加儀錶盤。
在目標儀錶盤編輯模式下，單擊添加 > 添加新圖表。
在頁面左側配置查詢時間範圍、LogStore、設定變數的查詢分析語句。在頁面右側選擇表格。單擊頁面上方的應用查看圖表配置效果，然後單擊確定儲存圖表。

查看不同時間間隔訪問PV的查詢分析語句如下，其中的${{interval|60}}代表設定變數interval，預設值是60。
```
* | SELECT date_format(__time__ - __time__ % ${{interval|60}}, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

2. 添加變數類型的過濾器

在目標儀錶盤編輯模式下，單擊頁面的右上方的表徵圖。

在過濾器面板中，完成以下設定，然後單擊確定。

說明

Key值必須為您在設定變數步驟中設定的變數，本樣本為interval。
靜態列表項用於配置不同查詢時間長度範圍的變數值。

本樣本中，名稱設為PV過濾器，靜態清單項目分別添加10、60、600三個變數值（單位為秒），完成後單擊確定。

變數類型的過濾器參數說明

參數	說明
名稱	過濾器名稱。
類型	變數替換：建立變數類型的過濾器，指定變數和變數的值。如果儀錶盤中已有設定了該變數預留位置的統計圖表，則添加變數類型的過濾器後，自動將統計圖表的查詢和分析語句中的變數替換為您選擇的變數值。在靜態列表項中組態變數的值，支援設定多個變數值。
Key值	在Key值中組態變數。說明您要替換變數的統計圖表必須已設定預留位置變數，且與此處配置的變數相同。
別名	列的別名。
顯示設置	設定過濾器的顯示樣式。開啟顯示標題開關，為過濾器增加標題。開啟顯示邊框開關，為過濾器增加邊框。開啟顯示背景開關，為過濾器增加白色背景。
顯示組件類型	選擇組件類行的方式：自由輸入。下拉式清單。
靜態列表項	設定Key值對應的Value。多次單擊+，可添加多個Value。如果開啟預設選中，則每次開啟儀錶盤時，預設使用該Value執行過濾。
添加動態列表項	開啟添加動態列表項開關，可添加動態清單項目，即為Key值配置動態Value。動態清單項目為對應查詢和分析語句的查詢結果，在不同的時間範圍內，查詢結果是動態變化的。開啟添加動態列表項開關後，需配置如下參數。請選擇Project：選擇您要查詢的專案。請選擇日誌庫：選擇您要查詢的日誌庫。是否繼承過濾：開啟是否繼承過濾開關後，在執行過濾時繼承儀錶盤中已有的過濾條件。查詢剖析：輸入查詢和分析語句並設定時間範圍。動態列表項預覽：確認查詢結果。

調整頁面配置，單擊保存，在儲存儀錶盤對話方塊，單擊確認。

3. 驗證結果

在目標儀錶盤頁面，將PV過濾器中interval設定為10，代表查詢每10秒的訪問PV。
該操作對應的查詢和分析語句如下：
```
* | SELECT date_format(__time__ - __time__ % 10, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```
在目標儀錶盤頁面，將PV過濾器中interval設定為60，代表查詢每60秒的訪問PV。
該操作對應的查詢和分析語句如下：
```
* | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as time, count(1) as count GROUP BY time ORDER BY time
```

時序過濾器

接入時序資料：例如採集主機監控資料。

添加過濾器：採集主機資料後，Log Service會自動建立一個名叫主機監控的儀錶盤。在主機監控編輯模式下，單擊頁面的右上方的儀錶盤過濾器-過濾器表徵圖表徵圖。在過濾器面板中，完成以下設定，然後單擊確定。

在Key值中選擇Host。

時序過濾器參數說明

參數	說明
名稱	過濾器名稱。
類型	時序過濾器：動態添加Label和Value進行過濾。添加時序過濾器後，可以手動對時序庫的Label和Value進行過濾顯示。
Key值	過濾器的唯一標識。
別名	列的別名。
顯示設置	設定過濾器的顯示樣式。開啟顯示標題開關，為過濾器增加標題。開啟顯示邊框開關，為過濾器增加邊框。開啟顯示背景開關，為過濾器增加白色背景。
請選擇Project	選擇您要查詢的Project。
請選擇時序庫	選擇您要查詢的時序庫。

篩選儀錶盤：在儀錶盤頁面頂端的下拉式清單，選擇Label和Value。

添加變數替換篩選單個統計圖表

您可以對單個統計圖表設定變數替換，Log Service將在當前統計圖表的左上方添加一個過濾器，從而實現對單個統計圖表的篩選。此處以查看不同時間間隔訪問PV的表格樣本，配置步驟如下。

1. 組態變數替換

在編輯圖表頁面左側配置查詢時間範圍、LogStore、設定變數的查詢分析語句。

查看不同時間間隔訪問PV的查詢分析語句如下，其中的${{date|60}}代表設定變數date，預設值是60。
```
* | select __time__ - __time__ % ${{date | 60}} as time, COUNT(*) as pv, avg(request_time) as duration, request_method GROUP BY time, request_method order by time limit 1000
```
執行查詢後，資料來源選擇 Logstore 為 website_log，時間範圍設為 15 Minutes(Relative)，查詢結果以資料表形式展示按時間和要求方法分組的PV及平均耗時資料。
組態變數替換。
1. 在編輯圖表頁面右側圖表類型選擇表格，單擊變數替換 > 添加變數替換。
2. 在變數替換彈框設定變數Key為date，變數的顯示名稱為時間，變數值的顯示名稱為min、hour，對應的變數值為60、3600。
單擊頁面右上方的確定，然後單擊右上方保存，在儲存儀錶盤對話方塊，單擊確認。

2. 篩選統計圖表

設定完成後，統計圖表的左上方將出現一個過濾器。選擇對應的值後，Log Service將根據您選擇的值執行一次查詢與分析操作。例如您選擇hour，對應的查詢分析語句為：

(*)| select __time__ - __time__ % 3600 as time, COUNT(*) as pv, avg(request_time) as duration, request_method GROUP BY time, request_method order by time limit 1000

變數與互動事件配合使用

在配置統計圖表的互動事件時，您可以設定變數，這樣，每當您點擊目標互動事件，該變數就會自動更新為觸發事件的值，從而便於您進行相應的查詢與分析。具體樣本，請參見配置樣本。

在開啟日誌庫配置彈窗中，選擇目標日誌庫（如website_log），並在過濾語句中通過添加變數按鈕引用變數，例如* | SELECT date_format(__time__ - __time__ % 60, '%H:%i:%s') as "${time}"，其中${time}即為互動事件中設定的變數。

變數的高階使用（結合首碼使用）

重要

篩選儀錶盤或者統計圖表時，還可以結合首碼，使用${{變數名|預設值|首碼}}文法。

未設定變數值時，查詢使用預設值進行統計。
設定變數值後，查詢分析語句結合首碼與變數值進行統計。

篩選儀錶盤：HTTP方法（http_method）過濾情境

變數說明

變數格式：${{method_filter|http_method in ('GET','POST')|http_method =}}
查詢分析語句：(*)|select status, count(1) as err_count where ${{method_filter|request_method in ('GET','POST')|request_method =}} and status>=400 group by status
- 未設定變數時：預設統計GET/POST請求中400+狀態的錯誤分布，查詢分析語句為：
  
  (*)|select status, count(1) as err_count where request_method in ('GET','POST') and status>=400 group by status
- 設定變數為'DELETE'時：切換為分析DELETE方法的錯誤狀態，查詢分析語句為：
  
  (*)| select status, count(1) as err_count where request_method ='DELETE' and status>=400 group by status

操作步驟

配置圖表：在頁面左側配置查詢時間範圍、LogStore、設定變數的查詢分析語句。在頁面右側選擇表格。單擊頁面上方的應用查看圖表配置效果，然後單擊確定儲存圖表。

查詢分析語句樣本為 * | select status, count(1) as err_count where ${{method_filter|request_method in ('GET','POST')|request_method =}} and status>=400 group by status，其中 ${{method_filter|...|...}} 為變數替換過濾器文法，資料來源選擇 website_log。
組態變數類型過濾器：在過濾器面板，添加method_filter變數下拉選擇的值。

類型選擇變數替換，在靜態清單項目中依次添加 GET、POST、PUT、DELETE，單擊確定。
篩選儀錶盤：單擊過濾器，選擇DELETE時，使用(*)| select status, count(1) as err_count where request_method ='DELETE' and status>=400 group by status查詢分析語句進行統計展示。

篩選統計圖表：請求時間（request_time）閾值過濾情境

變數說明

變數格式：${{slow_query|request_time>50|request_time>}}
查詢分析語句：(*)| select request_uri, avg(request_time) as avg_time where ${{slow_query|request_time>50|request_time>}} group by request_uri order by avg_time desc
- 未設定變數時：預設篩選請求時間超過50ms的介面，按平均耗時降序排列，查詢分析語句為：
  
  (*)| select request_uri, avg(request_time) as avg_time where request_time>50 group by request_uri order by avg_time desc
- 設定變數為1000ms時：調整為分析超1秒的慢介面，查詢分析語句為：(*)| select request_uri, avg(request_time) as avg_time where request_time>1000 group by request_uri order by avg_time desc

操作步驟

配置圖表：在編輯圖表頁面左側配置查詢時間範圍、LogStore、設定變數的查詢分析語句。

在右側圖表類型地區選取項目表格，在左下方編輯包含變數模板的查詢分析語句，然後在右側變數替換地區組態變數 Key 和顯示名稱。設定完成後單擊右上方確定。
組態變數替換：在編輯圖表頁面右側，單擊變數替換，在變數替換彈框，添加slow_query變數下拉選擇的值。

變數值列表中依次添加：顯示名稱 50ms（替換值 50，設為預設值）、100ms（替換值 100）、200ms（替換值 200）、300ms（替換值 300）、400ms（替換值 400）、500ms（替換值 500）、1000ms（替換值 1000），然後單擊確定。
篩選圖表：單擊統計圖表的左上方篩選框。選擇1000ms時，使用(*)| select request_uri, avg(request_time) as avg_time where request_time>1000 group by request_uri order by avg_time desc查詢分析語句進行統計展示。