添加過濾器篩選儀錶盤

變數的文法格式為${{變數名|預設值}}，它允許您動態地調整查詢參數中的預留位置。通過設定這些變數，您可以對統計圖表或整個儀錶盤進行篩選，而無需直接改動查詢分析語句。本文向您介紹如何對儀錶盤整體及單個統計圖表進行篩選。

過濾器類型

每張統計圖表實際為一個查詢和分析語句，過濾器用於為儀錶盤中的所有統計圖表批量修改查詢條件或替換預留位置變數，實現對整個儀錶盤資料的篩選功能。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

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

參數	說明
名稱	過濾器名稱。
類型	過濾器：建立過濾器類型的過濾器，通過欄位名和欄位值進行過濾。在執行過濾器操作時，將其作為過濾條件增加到查詢和分析語句前，使用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。
靜態清單項目用於配置不同查詢時間長度範圍的變數值。

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

參數	說明
名稱	過濾器名稱。
類型	變數替換：建立變數類型的過濾器，指定變數和變數的值。如果儀錶盤中已有設定了該變數預留位置的統計圖表，則添加變數類型的過濾器後，自動將統計圖表的查詢和分析語句中的變數替換為您選擇的變數值。在靜態清單項目中組態變數的值，支援設定多個變數值。
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會自動建立一個名叫主機監控的儀錶盤。在主機監控編輯模式下，單擊頁面的右上方的儀錶盤過濾器-過濾器表徵圖表徵圖。在過濾器面板中，完成以下設定，然後單擊確定。

時序過濾器參數說明

參數	說明
名稱	過濾器名稱。
類型	時序過濾器：動態添加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
```
組態變數替換。
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

變數與互動事件配合使用

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