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

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

前置條件

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

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

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

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

安裝 Grafana

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

配置 Grafana

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

• 圖形化界面安裝
• 使用安裝腳本
• 手動(dòng)安裝
• K8s/Docker 容器

對(duì)于使用 Grafana 7.x 版本或使用 Grafana Provisioning 配置的用戶，可以在 Grafana 服務(wù)器上使用安裝腳本自動(dòng)安裝插件即添加數(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 服務(wù)后方可生效。

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

創(chuàng)建 Dashboard

回到主界面創(chuàng)建 Dashboard，點(diǎn)擊 Add Query 進(jìn)入面板查詢頁(yè)面：

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

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

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

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

導(dǎo)入 Dashboard

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

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

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