ARMS的可觀測可視化 Grafana 版默認安裝Alibaba Cloud Lindorm數據源插件。通過此插件，可實現Lindorm數據同步并實時呈現在Grafana大盤中。您無需手動獲取或遷移數據。本文介紹如何通過Lindorm數據源插件同步Lindorm數據，并使用Lindorm數據源創建大盤面板。
背景信息
Lindorm時序引擎是一款高性能、低成本、穩定可靠的在線時序數據庫引擎服務，提供高效讀寫、高壓縮比存儲、時序數據聚合計算等能力。更多信息，請參見引擎簡介。
步驟一：功能入口
登錄可觀測可視化 Grafana 版控制臺，在左側導航欄單擊工作區管理。
在工作區管理頁面，單擊目標工作區右側的訪問地址URL鏈接進入Grafana。
說明如果需要登錄Grafana，可以使用Grafana的Admin賬號和創建工作區時設置的密碼登錄Grafana，或者單擊Sign in with Alibaba Cloud直接使用當前購買工作區的阿里云賬號登錄Grafana。
步驟二：配置數據源
Grafana 9.0.x版本
在Grafana左側導航欄，選擇
> Data sources，然后單擊Add data source。在Add data source頁面的搜索框，搜索并單擊Alibaba Cloud Lindorm。
在Settings頁面設置以下參數。
配置項
參數
是否必選
描述
Name
是
是定義數據源名稱。
HTTP
URL
是
Lindorm時序HTTP地址，獲取方法請參見查看時序引擎連接地址。
重要如果您的Grafana與Lindorm實例位于同一專有網絡，請使用Lindorm時序HTTP地址的專有網絡地址，否則請使用公網地址。
如果此處使用的是時序HTTP地址的專有網絡地址，請確保Grafana私網IP（私網域名交換機所在網段）已經添加到Lindorm的白名單中。如果使用的是公網地址，請確保Grafana公網IP已經添加到Lindorm的白名單中。
Auth
Basic auth
否
Lindorm時序引擎如果開啟了權限與用戶認證，請打開Basic auth，并在Basic Auth Details區域填寫登錄時序引擎的用戶名和密碼。關于權限與用戶認證，請參見用戶及權限管理。
Basic Auth Details
User
否
如果打開Basic auth需要填寫Lindorm時序引擎的用戶名。
Password
否
如果打開Basic auth需要填寫Lindorm時序引擎的密碼。
Lindorm TSDB Details
Database
否
填寫需要訪問的Lindorm時序引擎的數據庫。
單擊Save & Test。
Grafana 10.0.x版本
在Grafana首頁，單擊頁面左上角的
圖標。在Grafana左側導航欄，選擇。
在數據源頁簽，單擊+ Add new data source。
在Add data source頁面的搜索框，搜索并單擊Alibaba Cloud Lindorm。
在Settings頁面設置以下參數。
配置項
參數
是否必選
描述
Name
是
是定義數據源名稱。
HTTP
URL
是
Lindorm時序HTTP地址，獲取方法請參見查看時序引擎連接地址。
重要如果您的Grafana與Lindorm實例位于同一專有網絡，請使用Lindorm時序HTTP地址的專有網絡地址，否則請使用公網地址。
如果此處使用的是時序HTTP地址的專有網絡地址，請確保Grafana私網IP（私網域名交換機所在網段）已經添加到Lindorm的白名單中。如果使用的是公網地址，請確保Grafana公網IP已經添加到Lindorm的白名單中。
Auth
Basic auth
否
Lindorm時序引擎如果開啟了權限與用戶認證，請打開Basic auth，并在Basic Auth Details區域填寫登錄時序引擎的用戶名和密碼。關于權限與用戶認證，請參見用戶及權限管理。
Basic Auth Details
User
否
如果打開Basic auth需要填寫Lindorm時序引擎的用戶名。
Password
否
如果打開Basic auth需要填寫Lindorm時序引擎的密碼。
Lindorm TSDB Details
Database
否
填寫需要訪問的Lindorm時序引擎的數據庫。
單擊Save & Test。
步驟三：創建大盤面板
添加Lindorm數據源后，您可以在創建面板時使用已添加的Lindorm數據源。
Grafana 9.0.x版本
在Grafana左側導航欄，單擊
圖標，然后單擊頁面右上角的New Dashboard。在New dashboard頁面，單擊Add a new panel。
在Edit Panel頁面的Query頁簽，單擊Data source區域的下拉框選擇上一步添加的數據源。
您可以選擇下面兩種方式中的任意一種進行數據查詢。
使用編輯框查詢：在A區域下的選擇框選擇需要查詢的數據，可以完成簡單的查詢操作，關鍵字說明如下表。
關鍵字
說明
SELECT
選擇需要查詢的字段名。
FROM
選擇需要查詢的表名。
WHERE
添加查詢條件。
GROUP BY
添加聚合條件。
SAMPLE BY
選擇降采樣時間間隔，具體請參見降采樣查詢。
FILL
選擇填充策略。
ORDER BY TIME
選擇排列順序。
LIMIT
輸入查詢返回最多的數據數量。
ALIAS BY
重命名時間線標簽。
使用TSQL語句查詢：單擊A區域右上角的
，可以通過輸入TSQL語句完成復雜的查詢操作（例如嵌套查詢），數據查詢結果如下圖。
說明TSQL語句使用請參見SELECT語法。
$timeFilter表示時間條件，會自動替換為頁面中選擇的時間范圍，定義為time>=xxx and time<=xxx。time為必選項，否則不會出現分析結果圖。SELECT語句中通過tag方式對不同時間線進行分組聚合。
通過Alias by重命名時間線標簽，例如使用
$tag_host進行區分時間線，如下圖所示：
TSQL語句中的
$interval表示降采樣時間間隔，語句示例如下：SELECT region,time,avg(temperature) FROM sensor WHERE $timeFilter SAMPLE BY $interval說明單擊Query options，通過Min interval和Max data points參數來設置Interval參數的大小。
在右側設置監控圖表的名稱、類型、展示樣式等。
單擊右上角的Apply。
單擊右上角的
圖標，設置監控大盤的名稱和歸屬目錄。單擊Save，大盤即可創建成功。
Grafana 10.0.x版本
在Grafana首頁，單擊頁面左上角的
圖標。在Grafana左側導航欄，選擇儀表板，單擊頁面右上角的新建，然后在下拉列表中單擊新建儀表板。
在新建儀表板頁面，單擊+ 添加可視化。
在彈出的Select data source頁面右側，選擇上一步添加的數據源。
您可以選擇下面兩種方式中的任意一種進行數據查詢。
使用編輯框查詢：在A區域下的選擇框選擇需要查詢的數據，可以完成簡單的查詢操作，關鍵字說明如下表。
關鍵字
說明
SELECT
選擇需要查詢的字段名。
FROM
選擇需要查詢的表名。
WHERE
添加查詢條件。
GROUP BY
添加聚合條件。
SAMPLE BY
選擇降采樣時間間隔，具體請參見降采樣查詢。
FILL
選擇填充策略。
ORDER BY TIME
選擇排列順序。
LIMIT
輸入查詢返回最多的數據數量。
ALIAS BY
重命名時間線標簽。
使用TSQL語句查詢：單擊A區域右上角的
，可以通過輸入TSQL語句完成復雜的查詢操作（例如嵌套查詢），數據查詢結果如下圖。
說明TSQL語句使用請參見SELECT語法。
$timeFilter表示時間條件，會自動替換為頁面中選擇的時間范圍，定義為time>=xxx and time<=xxx。time為必選項，否則不會出現分析結果圖。SELECT語句中通過tag方式對不同時間線進行分組聚合。
通過Alias by重命名時間線標簽，例如使用
$tag_host進行區分時間線，如下圖所示：
TSQL語句中的
$interval表示降采樣時間間隔，語句示例如下：SELECT region,time,avg(temperature) FROM sensor WHERE $timeFilter SAMPLE BY $interval說明單擊Query options，通過Min interval和Max data points參數來設置Interval參數的大小。
在右側設置監控圖表的名稱、類型、展示樣式等。
單擊右上角的Apply。
單擊右上角的
圖標，設置監控大盤的名稱和歸屬目錄。單擊Save，大盤即可創建成功。
步驟四：查看監控數據
Grafana 9.0.x版本
在Grafana左側導航欄，單擊
圖標，然后單擊Browse。在Browse頁簽，單擊目標目錄下的監控大盤，即可查看目標大盤上的所有監控圖表。
Grafana 10.0.x版本
在Grafana首頁，單擊頁面左上角的
圖標。在Grafana左側導航欄，選擇儀表板，單擊目標目錄下的監控大盤，即可查看目標大盤上的所有監控圖表。