小 T 導讀：隨著 TDengine 這款時序數(shù)據(jù)庫（Time Series Database, TSDB）在各個領域應用的越來越廣泛，很多用戶選擇將 Grafana 與 TDengine 配合使用，以可視化的方式監(jiān)控各項指標的運行狀態(tài)。為了讓用戶更便捷地組合使用 TDengine+Grafana，我們不僅對 TDengine Grafana 插件進行了改造升級，還推出了基于 Grafana 的零依賴監(jiān)控解決方案 TDinsight。本篇文章將對 TDengine + Grafana 的落地實施進行詳細介紹。

TDengine 時序數(shù)據(jù)庫能夠與開源數(shù)據(jù)可視化系統(tǒng) Grafana 快速集成搭建數(shù)據(jù)監(jiān)測報警系統(tǒng)，整個過程無需任何代碼開發(fā)，TDengine 中數(shù)據(jù)表的內(nèi)容可以在儀表盤（DashBoard）上可視化展現(xiàn)。關于 TDengine 插件的使用，你可以在 GitHub（https://github.com/taosdata/grafanaplugin/blob/master/README.md） 中了解更多。

前置條件

要讓 Grafana 能正常添加 TDengine 數(shù)據(jù)源，需要以下幾方面的準備工作：

• TDengine 集群已經(jīng)部署并正常運行
• taosAdapter 已經(jīng)安裝并正常運行，具體細節(jié)請參考 taosAdapter 的使用手冊（https://docs.taosdata.com/reference/taosadapter/）

在此過程中，我們需要記錄以下信息：

• TDengine 集群 REST API 地址，如：http://tdengine.local:6041
• TDengine 集群認證信息，可使用用戶名及密碼

安裝 Grafana

目前 TDengine 支持 Grafana 7.5 以上的版本。用戶可以根據(jù)當前的操作系統(tǒng)，到 Grafana 官網(wǎng)下載安裝包，并執(zhí)行安裝。下載地址如下：https://grafana.com/grafana/download。

配置 Grafana

安裝 Grafana Plugin 并配置數(shù)據(jù)源

• 圖形化界面安裝
• 使用安裝腳本
• 手動安裝
• K8s/Docker 容器

對于使用 Grafana 7.x 版本或使用 Grafana Provisioning 配置的用戶，可以在 Grafana 服務器上使用安裝腳本自動安裝插件即添加數(shù)據(jù)源 Provisioning 配置文件。

bash -c "$(curl -fsSL \
  https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)" -- \
  -a http://localhost:6041 \
  -u root \
  -p taosdata

安裝完畢后，需要重啟 Grafana 服務后方可生效。

保存該腳本并執(zhí)行 ./install.sh --help 可查看詳細幫助文檔。

創(chuàng)建 Dashboard

回到主界面創(chuàng)建 Dashboard，點擊 Add Query 進入面板查詢頁面：

如上圖所示，在 Query 中選中 TDengine 數(shù)據(jù)源，在下方查詢框可輸入相應 SQL 進行查詢，具體說明如下：

• INPUT SQL：輸入要查詢的語句（該 SQL 語句的結果集應為兩列多行），例如：select _wstart, avg(mem_system) from log.dnodes_info where ts >= $from and ts < $to interval($interval) ，其中，from、to 和 interval 為 TDengine 插件的內(nèi)置變量，表示從 Grafana 插件面板獲取的查詢范圍和時間間隔。除了內(nèi)置變量外，也支持使用自定義模板變量。
• ALIAS BY：可設置當前查詢別名。
• GENERATE SQL： 點擊該按鈕會自動替換相應變量，并生成最終執(zhí)行的語句。

按照默認提示，查詢當前 TDengine 部署所在服務器指定間隔系統(tǒng)內(nèi)存平均使用量如下：

關于如何使用 Grafana 創(chuàng)建相應的監(jiān)測界面以及更多有關使用 Grafana 的信息，請參考 Grafana 官方的文檔（https://grafana.com/docs/）。

導入 Dashboard

在數(shù)據(jù)源配置頁面下，我們可以為該數(shù)據(jù)源導入 TDinsight 面板，作為 TDengine 集群的監(jiān)控可視化工具。如果 TDengine 服務端為 3.0 版本請選擇 TDinsight for 3.x 導入。

其中適配 TDengine 2.* 的 Dashboard 已發(fā)布在 Grafana：Dashboard 15167 – TDinsight（https://grafana.com/grafana/dashboards/15167-tdinsight/） 。其他安裝方式和相關使用說明請見 TDinsight 用戶手冊。

如果你想要使用 TDengine 作為數(shù)據(jù)源的其他面板，如監(jiān)控多個 TDengine 集群、查閱 TDengine 告警實例、進行 Telegraf 采集節(jié)點信息的數(shù)據(jù)展示，可以點擊進入 https://docs.taosdata.com/third-party/grafana/ 查看。