小 T 導讀：隨著 TDengine 這款時序資料庫（Time Series Database）在各個領域應用的越來越廣泛，很多使用者選擇將 Grafana 與 TDengine 配合使用，以視覺化的方式監控各項指標的執行狀態。為了讓使用者更便捷地組合使用 TDengine+Grafana，我們不僅對 TDengine Grafana 外掛進行了改造升級，還推出了基於 Grafana 的零依賴監控解決方案 TDinsight。本篇文章將對 TDengine + Grafana 的落地實施進行詳細介紹。

TDengine 能夠與開源資料視覺化系統 Grafana 快速整合搭建資料監測報警系統，整個過程無需任何程式碼開發，TDengine 中資料表的內容可以在儀表盤（DashBoard）上視覺化展現。關於 TDengine 外掛的使用，你可以在 GitHub（https://github.com/taosdata/grafanaplugin/blob/master/README.md） 中瞭解更多。

**前置條件**
要讓 Grafana 能正常新增 TDengine 資料來源，需要以下幾方面的準備工作：
- TDengine 叢集已經部署並正常執行
- taosAdapter 已經安裝並正常執行，具體細節請參考 taosAdapter 的使用手冊（https://docs.taosdata.com/reference/taosadapter/）

在此過程中，我們需要記錄以下資訊：
- TDengine 叢集 REST API 地址，如：http://tdengine.local:6041
- TDengine 叢集認證資訊，可使用使用者名稱及密碼

**安裝 Grafana**
目前 TDengine 支援 Grafana 7.5 以上的版本。使用者可以根據當前的作業系統，到 Grafana 官網下載安裝包，並執行安裝。下載地址如下：https://grafana.com/grafana/download。

**配置 Grafana**
**安裝 Grafana Plugin 並配置資料來源**
- 圖形化介面安裝
- 使用安裝指令碼
- 手動安裝
- K8s/Docker 容器

對於使用 Grafana 7.x 版本或使用 Grafana Provisioning 配置的使用者，可以在 Grafana 伺服器上使用安裝指令碼自動安裝外掛即新增資料來源 Provisioning 配置檔案。
```cpp
bash -c "$(curl -fsSL \
  https://raw.githubusercontent.com/taosdata/grafanaplugin/master/install.sh)" -- \
  -a http://localhost:6041 \
  -u root \
  -p taosdata
```
安裝完畢後，需要重啟 Grafana 服務後方可生效。

儲存該指令碼並執行 ./install.sh --help 可檢視詳細幫助文件。

**建立 Dashboard**
回到主介面建立 Dashboard，點選 Add Query 進入皮膚查詢頁面：
![](http://img.blog.itpub.net/blog/2022/11/08/057e33d76ac14163.jpeg?x-oss-process=style/bb)

如上圖所示，在 Query 中選中 TDengine 資料來源，在下方查詢框可輸入相應 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 外掛的內建變數，表示從 Grafana 外掛皮膚獲取的查詢範圍和時間間隔。除了內建變數外，也支援使用自定義模板變數。
- ALIAS BY：可設定當前查詢別名。
- GENERATE SQL： 點選該按鈕會自動替換相應變數，並生成最終執行的語句。

按照預設提示，查詢當前 TDengine 部署所在伺服器指定間隔系統記憶體平均使用量如下：

![](http://img.blog.itpub.net/blog/2022/11/08/55f673e396860b70.jpeg?x-oss-process=style/bb)

關於如何使用 Grafana 建立相應的監測介面以及更多有關使用 Grafana 的資訊，請參考 Grafana 官方的文件（https://grafana.com/docs/）。

**匯入 Dashboard**
在資料來源配置頁面下，我們可以為該資料來源匯入 TDinsight 皮膚，作為 TDengine 叢集的監控視覺化工具。如果 TDengine 服務端為 3.0 版本請選擇 TDinsight for 3.x 匯入。
![](http://img.blog.itpub.net/blog/2022/11/08/024e4cd3d4848970.png?x-oss-process=style/bb)

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

如果你想要使用 TDengine 作為資料來源的其他皮膚，如監控多個 TDengine 叢集、查閱 TDengine 告警例項、進行 Telegraf 採集節點資訊的資料展示，可以點選進入 https://docs.taosdata.com/third-party/grafana/ 檢視。

> 歡迎新增小T（VX：TDengine），加入物聯網技術討論群，第一時間瞭解TDengine 官方資訊，與關注前沿技術的同學們共同探討新技術、新玩法。

------------

想了解更多 [TDengine Database]( https://www.taosdata.com/?zh"TDengine Database")的具體細節，歡迎大家在[GitHub]( https://github.com/taosdata/TDengine"GitHub")上檢視相關原始碼。
[![](http://img.blog.itpub.net/blog/2022/05/11/0fd59db1207fc97f.jpeg?x-oss-process=style/bb)](https://www.taosdata.com/?zh "![](http://img.blog.itpub.net/blog/2022/05/11/0fd59db1207fc97f.jpeg?x-oss-process=style/bb)")

零依賴監控解決方案：TDengine+Grafana落地實施

相關文章