Table Store對接Grafana後，您可以通過Grafana可視化展示Table Store中的資料。
前提條件
已建立RAM使用者並為RAM使用者授予管理Table Store許可權（AliyunOTSFullAccess）。
警告阿里雲帳號AccessKey泄露會威脅您所有資源的安全。建議您使用RAM使用者AccessKey進行操作，可以有效降低AccessKey泄露的風險。
開通服務和建立執行個體後，建立資料表及其映射關係，或者建立時序表及其多值模型映射關係。
已安裝開源Grafana，且Grafana版本必須大於8.0.0，本文以Grafana v12.3.1為例進行介紹。關於安裝Grafana的更多資訊，請參見Grafana官方文檔。
背景資訊
Grafana是一款開源的可視化和分析平台，支援Prometheus、Graphite、OpenTSDB、InfluxDB、Elasticsearch、MySQL、PostgreSQL等多種資料來源的資料查詢、可視化等。更多資訊，請參見Grafana官方文檔。
Table Store的表資料接入Grafana後，Grafana可以根據表資料產生大盤面板，將資料即時展示給需要的使用者。
注意事項
Grafana 資料視覺效果功能的支援地區與所用資料模型相關。
寬表模型：已支援全部地區。
時序模型：支援華東1（杭州）、華東2（上海）、華北2（北京）、華北3（張家口）、華北6（烏蘭察布）、華南1（深圳）、西南1（成都）、中國香港、日本（東京）、新加坡、馬來西亞（吉隆坡）、印尼（雅加達）、德國（法蘭克福）、英國（倫敦）、美國（矽谷）、美國（維吉尼亞）、沙特（利雅得）。
步驟一：安裝Table Store外掛程式
Windows
下載Table StoreGrafana外掛程式包。具體下載路徑為Table StoreGrafana外掛程式包。
解壓Table StoreGrafana外掛程式包，並將Table StoreGrafana外掛程式包放到Grafana安裝目錄下的data/plugins目錄中。
修改Grafana設定檔。
使用文字編輯器工具開啟Grafana外掛程式conf目錄中的設定檔defaults.ini。
在設定檔的[plugins]節點中，設定allow_loading_unsigned_plugins參數。
allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
在工作管理員中重啟grafana-server.exe進程。
Mac/Linux
執行以下命令下載Table StoreGrafana外掛程式包。
wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260203/qbqmxg/aliyun-tablestore-grafana-datasource-adapt-react.zip將Table StoreGrafana外掛程式包解壓到Grafana外掛程式目錄。
根據Grafana的安裝方式執行對應命令。
使用YUM或RPM安裝的Grafana（只適用於Linux平台）：unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d /var/lib/grafana/plugins
使用.zip檔案安裝的Grafana：unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d {PATH_TO}/grafana-{VERSION}/data/plugins
說明其中
{PATH_TO}/grafana-{VERSION}為Grafana的安裝路徑，{VERSION}為Grafana的版本號碼。
修改Grafana設定檔。
進入檔案目錄開啟設定檔。
使用YUM或RPM安裝的Grafana（只適用於Linux平台）：/etc/grafana/grafana.ini
使用.zip檔案安裝的Grafana：{PATH_TO}/grafana-{VERSION}/conf/defaults.ini
說明其中
{PATH_TO}/grafana-{VERSION}為Grafana的安裝路徑，{VERSION}為Grafana的版本號碼。
在設定檔的[plugins]節點中，設定allow_loading_unsigned_plugins參數。
allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
重啟Grafana。
使用kill命令終止Grafana進程。
執行以下命令啟動Grafana。
使用YUM或RPM安裝的Grafana（只適用於Linux平台）：systemctl restart grafana-server
使用.zip檔案安裝的Grafana：./bin/grafana-server web
步驟二：配置資料來源
登入Grafana。
在瀏覽器中輸入
http://<x.x.x.x>:3000/，進入Grafana登入介面。說明<x.x.x.x>代表Grafana的IP地址。以Grafana安裝在Windows環境為例，登入地址為http://localhost:3000。輸入Email or username和Password，單擊Log in。
說明Grafana預設初始登入使用者名稱和密碼均為admin。首次登入時，請根據系統提示修改初始密碼。
在Grafana左側導覽列，選擇。
在Data sources頁面，單擊+ Add new data source。
在Add data source頁面的Others地區，單擊aliyun-tablestore-grafana-datasource。
在Settings頁簽，根據下表說明配置相關參數。
參數
樣本值
說明
Name
aliyun-tablestore-grafana-datasource
資料來源名稱，可自訂。預設為aliyun-tablestore-grafana-datasource。
Default
將Table Store資料來源設定為預設資料來源。
Endpoint
https://myinstance.cn-hangzhou.ots.aliyuncs.com
Table Store執行個體的服務地址，請根據訪問的Table Store執行個體填寫。
Instance
myinstance
Tablestore執行個體名稱。
AccessId
************************
擁有Table Store存取權限的阿里雲帳號或者RAM使用者的AccessKey ID。
AccessKey
********************************
擁有Table Store存取權限的阿里雲帳號或者RAM使用者的AccessKey Secret。
單擊Save & test。
串連成功後，介面會顯示Data source is working資訊。
步驟三：建立大盤面板
在Grafana左側導覽列，單擊Dashboards。
在Dashboards頁面，單擊New並選擇New dashboard。
在New dashboard頁面，單擊+ Add visualization。
在Select data source對話方塊，選擇配置完成的Tablestore資料來源。
在Edit panel頁面下的Queries頁簽配置查詢條件。
配置參數說明請參見下表。
參數
樣本
說明
Query
SELECT * 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 As
Timeseries
結果處理形式。取值範圍如下：
Timeseries（預設）：普通時序圖。
FlowGraph：多維圖表展示。
Table：普通表格形式。
說明使用SQL查詢寬表模型的表資料時，如果表資料中未包含時間列，請單擊Switch to table，以Table形式展示查詢結果；單擊Open visualization suggestions，可查看和選擇更多推薦的查詢結果展示形式。
Time Column
_time
返回資料中時間列的列名，時間列會作為時序圖的橫座標。當選擇Format As為Timeseries或者FlowGraph時可配置。
Aggregation Column
_field_name#:#_double_value
將同一時間點的多行單列資料轉換為同一時間點的單行多列資料，適用於將Tablestore時序SQL產生的單值模型資料轉換為多值模型資料。當選擇Format As為FlowGraph時可配置。格式為
<資料點名稱列>#:#<數值列>。單擊Run SQL，執行SQL語句查看資料並進行調試。
設定並儲存大盤面板。
在右側設定監控圖表的名稱、類型、展示樣式等。
單擊右上方的Save dashboard後，在Save dashboard對話方塊，設定Title、Description和大盤歸屬的Folder並單擊Save。
單擊右上方的Save dashboard後，在Save dashboard對話方塊，單擊Save。
步驟四：查看監控資料
在Grafana左側導覽列，選擇Dashboards，單擊目標目錄下的監控大盤，即可查看目標大盤上的所有監控圖表。