Tablestore對接Grafana後，您可以通過Grafana可視化展示Tablestore中的資料。

前提条件

背景信息

Grafana是一款開源的可視化和分析平台，支援Prometheus、Graphite、OpenTSDB、InfluxDB、Elasticsearch、MySQL、PostgreSQL等多種資料來源的資料查詢、可視化等。更多資訊，請參見Grafana官方文檔。

Tablestore的表資料接入Grafana後，Grafana可以根據表資料產生大盤面板，將資料即時展示給需要的使用者。

注意事項

目前Tablestore支援使用Grafana實現資料視覺效果功能的地區有華東1（杭州）、華東2（上海）、華北2（北京）、華北3（張家口）、華南1（深圳）和新加坡。

步驟一：安裝Tablestore外掛程式

在Windows平台操作

  1. 下載Tablestore Grafana外掛程式包。具體下載路徑為Tablestore Grafana外掛程式包。
  2. 解壓Tablestore Grafana外掛程式包，並將Tablestore Grafana外掛程式包放到Grafana外掛程式的plugins-bundled目錄中。
  3. 修改Grafana設定檔。
    1. 使用文字編輯器工具開啟Grafana外掛程式conf目錄中的設定檔defaults.ini。
    2. 在設定檔的[plugins]節點中，設定allow_loading_unsigned_plugins參數。
      allow_loading_unsigned_plugins = aliyun-tablestore-grafana-datasource
  4. 在工作管理員中重啟grafana-server.exe進程。

在Linux或者Mac平台操作

  1. 執行以下命令下載Tablestore Grafana外掛程式包。
    wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20220527/ygdf/tablestore-grafana-plugin-1.0.0.zip
  2. 將Tablestore Grafana外掛程式包解壓到Grafana外掛程式目錄。
    根據Grafana的安裝方式執行對應命令。
    • 使用YUM或RPM安裝的Grafana（只適用於Linux平台）：unzip tablestore-grafana-plugin-1.0.0.zip -d /var/lib/grafana/plugins
    • 使用.tar.gz檔案安裝的Grafana：unzip tablestore-grafana-plugin-1.0.0.zip -d {PATH_TO}/grafana-{VERSION}/data/plugins
  3. 修改Grafana設定檔。
    1. 進入檔案目錄開啟設定檔。
      • 使用YUM或RPM安裝的Grafana（只適用於Linux平台）：/etc/grafana/grafana.ini
      • 使用.tar.gz檔案安裝的Grafana：{PATH_TO}/grafana-{VERSION}/conf/defaults.ini

        其中{PATH_TO}/grafana-{VERSION}為Grafana的安裝路徑，VERSION為Grafana的版本號碼。

    2. 在設定檔的[plugins]節點中，設定allow_loading_unsigned_plugins參數。
      allow_loading_unsigned_plugins = aliyun-tablestore-grafana-datasource
  4. 重啟Grafana。
    1. 使用kill命令終止Grafana進程。
    2. 執行以下命令啟動Grafana。
      • 使用YUM或RPM安裝的Grafana（只適用於Linux平台）：systemctl restart grafana-server
      • 使用.tar.gz檔案安裝的Grafana：./bin/grafana-server web

步驟二：配置資料來源

  1. 登入Grafana。
    1. 在瀏覽器中輸入http://localhost:3000/，進入Grafana登入介面。
    2. 輸入Email or username和Password，單擊Log in。
      Grafana預設初始登入使用者名稱和密碼均為admin。首次登入時，請根據系統提示修改初始密碼。
  2. 將滑鼠移動到左側導覽列的fig_config表徵圖上，單擊Data sources。
  3. 在Data sources頁簽，單擊Add data source。
  4. 在Add data source頁面的Others地區，單擊aliyun-tablestore-grafana-datasource。
  5. 在Settings頁面，根據下表說明配置相關參數。
    參數樣本值說明
    Namealiyun-tablestore-grafana-datasource資料來源名稱，可自訂。預設為aliyun-tablestore-grafana-datasource。
    Endpointhttps://myinstance.cn-hangzhou.ots.aliyuncs.comTablestore執行個體的服務地址，請根據訪問的Tablestore執行個體填寫。更多資訊，請參見服務地址。
    InstancemyinstanceTablestore執行個體名稱。
    AccessId************************擁有Tablestore存取權限的阿里雲帳號或者RAM使用者的AccessKey ID。
    AccessKey********************************擁有Tablestore存取權限的阿里雲帳號或者RAM使用者的AccessKey Secret。
  6. 單擊Save & test。
    串連成功後，介面會顯示Data source is working資訊。fig_20220425_setting

步驟三：建立大盤面板

  1. 在Grafana控制台介面，將滑鼠移動到左側導覽列的fig_20220425_add表徵圖上，單擊Dashboard。
  2. 在New dashboard頁面單擊fig_20220425_adddashboard表徵圖。
  3. 在Add panel地區，單擊Add a new panel。
  4. 在Edit Panel頁面Query地區配置資料來源查詢條件。
    1. 在Data source下拉式清單中選擇tablestore資料來源。
    2. 配置資料來源參數。
      參數樣本說明
      QuerySELECT * FROM your_table WHERE $__unixMicroTimeRangeFilter(_time)AND _m_name = "your_measurement" AND tag_value_at(_tags, "your_tag")="your_tag_value"LIMIT 1000SQL查詢語句。更多資訊，請參見查詢資料。
      重要
      • 在WHERE子句中要通過預定義宏過濾時間範圍，即樣本中的$__unixMicroTimeRangeFilter。更多的時間宏函數請單擊配置頁面中的“Show Help”查看。
      • 如果以時序圖形式展示，則需要返回以數字時間戳記形式表示的時間列，並配置時間列的列名。
      Format AsTimeseries結果處理形式。取值範圍如下：
      • Timeseries（預設）：普通時序圖。
      • FlowGraph：多維圖表展示。
      • Table：普通表格形式。
      Time Column_time返回資料中時間列的列名，時間列會作為時序圖的橫座標。當選擇Format As為Timeseries或者FlowGraph時可配置。
      Aggregation Column_field_name#:#_double_value將同一時間點的多行單列資料轉換為同一時間點的單行多列資料，適用於將Tablestore時序SQL產生的單值模型資料轉換為多值模型資料。當選擇Format As為FlowGraph時可配置。格式為<資料點名稱列>#:#<數值列>。
  5. 單擊Run SQL，執行SQL語句查看資料和調試。
  6. 設定並儲存大盤面板。
    1. 在右側設定監控圖表的名稱、類型、展示樣式等。
      fig_20220426_dashboard
    2. 單擊右上方的Apply。
    3. 單擊右上方的fig_20220426_savedashboard表徵圖，在Save dashboard as...對話方塊，設定Dashboard name和大盤歸屬的Folder後，單擊Save。

步驟四：查看監控資料

  1. 在Grafana控制台介面，將滑鼠移動到左側導覽列的fig_20220426_view表徵圖上，單擊Browse。
  2. 在Browse頁簽，單擊目標目錄下的監控大盤，即可查看目標大盤上的所有監控圖表。