Lindorm：通過Grafana訪問時序引擎

前提條件

• 已建立Grafana工作區。具體操作，請參見建立Grafana工作區。

• 如果通過公網訪問Lindorm時序引擎，請完成以下操作：

  • 為Lindorm時序引擎開通公網地址。開通時序引擎公網地址，請參見查看時序引擎串連地址。

  • 將Grafana的公網IP添加到Lindorm白名單。具體操作，請參見設定白名單。

操作步驟

本文以Grafana 10.0.x為例介紹操作步驟。

1. 登入可觀測可視化 Grafana 版控制台，在左側導覽列單擊工作區管理。

2. 在基本資料地區，單擊公網地址或私網地址。輸入使用者名稱和密碼。使用者名稱為admin，密碼為建立工作去時設定的密碼。

3. 在Grafana服務中添加Lindorm資料來源。

   1. 單擊左上方的表徵圖，在列表中選擇管理。然後單擊資料來源。

   2. 在管理頁面，單擊資料來源。

   3. 在資料來源頁面，單擊Add data source。

   4. 在Add data source頁面的搜尋方塊中輸入Alibaba Cloud Lindorm，找到目標資料來源並單擊資料來源。

   5. 在Settings頁簽中配置以下參數，其他參數可保持預設值。

      配置項	參數	是否必選	描述
      Name		是	資料來源名稱，可自訂。
      HTTP	URL	是	Lindorm時序HTTP地址，擷取方法請參見查看時序引擎串連地址。 重要 請使用Lindorm時序HTTP地址的公網地址，並確保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時序引擎的資料庫。

   6. 單擊Save & test。

      顯示test success，說明測試連接成功。

4. 單擊Build a dashboard。

5. 在New Dashboard頁面，單擊添加可視化。

6. 選擇步驟3添加的Lindorm資料來源。

7. 在Query頁簽中查詢資料。

   1. 在Data source列表中選擇目標資料來源名稱。

   2. Grafana支援兩種編輯器模式，包括格式化查詢編輯器和SQL查詢編輯器。

      SQL查詢編輯器

      單擊A地區右上方的，將查詢編輯器切換為Raw Query Mode，然後可以輸入Lindorm SQL完成複雜的查詢操作。樣本如下。

      SELECT region,time,avg(temperature) FROM sensor WHERE time >= $from AND time <= $to SAMPLE BY $interval

      說明

      Lindorm SQL語句使用請參見SELECT文法。

      • time >= $from AND time <= $to為時間條件，為必選項，不添加無法查詢出結果。參數值為Dashboard頁面中選擇的時間範圍。

      • 單擊Query options，可以通過Min interval和Max data points參數來設定Interval參數大小。

      • 通過ALIAS BY重新命名時間軸標籤，格式為$tag_<tag_name>，例如$tag_host，時間軸標籤將顯示為host的值。

      • 通過OFFSET設定時間位移量，方便您將不同時間段的資料進行對比。

      格式化查詢編輯器

      通過格式化的模板，選擇需要查詢的表、欄位、查詢條件等，可以完成簡單的查詢，關鍵字說明如下表。

      關鍵字	說明
      SELECT	選擇需要查詢的欄位名。
      FROM	選擇需要查詢的表名。
      WHERE	添加查詢條件。
      GROUP BY	添加彙總條件。
      SAMPLE BY	選擇降採樣時間間隔，具體請參見降採樣查詢。 單擊Query options，可以通過Min interval和Max data points參數來設定Interval參數大小。
      ORDER BY TIME	按時間對查詢結果排序。
      LIMIT	指定查詢結果集的返回行數。
      ALIAS BY	重新命名時間軸標籤。格式為$tag_<tag_name>，例如$tag_host，時間軸標籤將顯示為host的值。
      OFFSET	設定時間位移量，方便您將不同時間段的資料進行對比。

部署要求

• ECS執行個體的作業系統版本選擇CentOS 7.3 64位及以上版本。

• ECS執行個體的資源規格需要1核2 G記憶體以上，磁碟剩餘空間至少有10 GB。

前提條件

在開始操作前，請確保已完成以下操作：

• ECS執行個體安全性群組已允許存取3000連接埠的入方向流量。具體操作，請參見添加安全性群組規則。

• 添加ECS執行個體的IP到Lindorm白名單。

  如果ECS執行個體與Lindorm執行個體屬於同一專用網路：請添加ECS執行個體的主私網IP地址至Lindorm執行個體的白名單。具體操作，請參見設定白名單。

  如果ECS執行個體與Lindorm執行個體不屬於同一專用網路：

  • 請為ECS執行個體分配公網IP。如果ECS執行個體未分配公網IP地址，請配置並將EIP綁定至ECS執行個體，或者修改頻寬配置。

  • 請添加ECS執行個體的公網IP地址至Lindorm執行個體的白名單。具體操作，請參見設定白名單。

• 如果通過公網訪問Grafana Web介面，請確保ECS執行個體已指派公網IP。如果ECS執行個體未分配公網IP地址，請配置並將EIP綁定至ECS執行個體，或者修改頻寬配置。如果通過專用網路訪問Grafana Web介面，則無需為ECS執行個體分配公網IP。

操作步驟

1. 安裝Grafana服務（如已安裝，可跳過）。

   1. 登入ECS執行個體。具體操作請參見登入ECS。

   2. 執行下述命令下載Grafana：

      wget https://dl.grafana.com/enterprise/release/grafana-enterprise-8.2.2-1.x86_64.rpm

      說明

      本文以Grafana企業版8.2.2-1版本為例，您也可以安裝其他版本。其他版本的下載地址，請參見Grafana官網。

   3. 執行下述命令安裝Grafana：

      sudo yum install grafana-enterprise-8.2.2-1.x86_64.rpm

   4. 執行下述命令啟動Grafana服務：

      sudo service grafana-server start

2. 安裝Alibaba Cloud Lindorm資料來源外掛程式。

   1. 執行下述命令下載資料來源外掛程式。

      wget https://tsdbtools.oss-cn-hangzhou.aliyuncs.com/grafana-alibabacloud-lindorm-datasource-latest.zip

   2. 執行下述命令解壓外掛程式到預設目錄，Linux的預設目錄為/var/lib/grafana/plugins/。

      unzip grafana-alibabacloud-lindorm-datasource-latest.zip -d /var/lib/grafana/plugins/

   3. 執行下述命令修改grafana.ini檔案資訊，Linux預設檔案位置/etc/grafana/grafana.ini。

      sudo nano -w  /etc/grafana/grafana.ini

   4. 在[plugins]地區中將;allow_loading_unsigned_plugins=修改為allow_loading_unsigned_plugins = alibabacloud-lindorm-datasource。修改後按下CTRL+O儲存並斷行符號退出編輯頁面。

      重要

      修改grafana.ini檔案時，需要刪除;allow_loading_unsigned_plugins前面的半形分號（;）。

   5. 執行下述命令重啟Grafana服務：

      sudo service grafana-server restart

3. 在Grafana服務中添加Lindorm資料來源。

   1. 在瀏覽器中輸入http://IP:3000/，其中IP為ECS的公網IP或主私網IP。然後輸入使用者名稱和密碼。如果是第一次登入，使用者名稱和密碼為admin，登入後請及時修改密碼。更詳細的介紹，請參見登入Grafana。

   2. 單擊左側的表徵圖，在列表中選擇Data Sources。

   3. 在Configuration頁面，單擊Add data source。

   4. 在Add data source頁面的搜尋方塊中輸入Alibaba Cloud Lindorm，找到目標資料來源並單擊Select。

   5. 在Settings頁簽中配置以下參數，其他參數可保持預設值。

      配置項	參數	是否必選	描述
      Name		是	資料來源名稱，可自訂。
      HTTP	URL	是	Lindorm時序HTTP地址，擷取方法請參見查看時序引擎串連地址。 重要 如果您的ECS與Lindorm執行個體，位於同一專用網路，請使用Lindorm時序HTTP地址的專用網路地址，否則請使用公網地址。 如果此處使用的是時序HTTP地址的專用網路地址，請確保ECS主私網IP已經添加到Lindorm的白名單中。如果使用的是公網地址，請確保ECS公網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時序引擎的資料庫。

   6. 單擊Save & test。

      顯示test success，說明測試連接成功。

4. 串連Lindorm執行個體後，在Grafana服務中建立並使用dashboard，具體操作您可以參考建立Dashboard。

5. 在Query頁簽中查詢資料。

   1. 在Data source列表中選擇目標資料來源名稱。

   2. Grafana支援兩種編輯器模式，包括格式化查詢編輯器和SQL查詢編輯器。

      SQL查詢編輯器

      單擊A地區右上方的，將查詢編輯器切換為Raw Query Mode，然後可以輸入Lindorm SQL完成複雜的查詢操作。樣本如下。

      SELECT region,time,avg(temperature) FROM sensor WHERE time >= $from AND time <= $to SAMPLE BY $interval

      說明

      Lindorm SQL語句使用請參見SELECT文法。

      • time >= $from AND time <= $to為時間條件，為必選項，不添加無法查詢出結果。參數值為Dashboard頁面中選擇的時間範圍。

      • 單擊Query options，可以通過Min interval和Max data points參數來設定Interval參數大小。

      • 通過ALIAS BY重新命名時間軸標籤，格式為$tag_<tag_name>，例如$tag_host，時間軸標籤將顯示為host的值。

      • 通過OFFSET設定時間位移量，方便您將不同時間段的資料進行對比。

      格式化查詢編輯器

      通過格式化的模板，選擇需要查詢的表、欄位、查詢條件等，可以完成簡單的查詢，關鍵字說明如下表。

      關鍵字	說明
      SELECT	選擇需要查詢的欄位名。
      FROM	選擇需要查詢的表名。
      WHERE	添加查詢條件。
      GROUP BY	添加彙總條件。
      SAMPLE BY	選擇降採樣時間間隔，具體請參見降採樣查詢。 單擊Query options，可以通過Min interval和Max data points參數來設定Interval參數大小。
      ORDER BY TIME	按時間對查詢結果排序。
      LIMIT	指定查詢結果集的返回行數。
      ALIAS BY	重新命名時間軸標籤。格式為$tag_<tag_name>，例如$tag_host，時間軸標籤將顯示為host的值。
      OFFSET	設定時間位移量，方便您將不同時間段的資料進行對比。