小 T 導讀：taosAdapter 是 [TDengine ]( https://www.taosdata.com/"TDengine ")這款[時序資料庫]( https://www.taosdata.com/"時序資料庫")（Time Series Database）的配套工具，是 TDengine 叢集和應用程式之間的橋樑和介面卡。當我們需要從資料收集代理軟體（如 Telegraf、StatsD、collectd 等）攝取資料時，使用 taosAdapter 能讓這一操作變得更加高效。此外，它還提供了 InfluxDB/[OpenTSDB]( https://www.taosdata.com/opentsdb"OpenTSDB") 相容的資料攝取介面，允許 InfluxDB/OpenTSDB 應用程式無縫移植到 TDengine。本文將整體介紹一下 taosAdapter，方便大家使用。

taosAdapter 主要提供以下功能：

- RESTful 介面
- 相容 InfluxDB v1 寫介面
- 相容 OpenTSDB JSON 和 telnet 格式寫入
- 無縫連線到 Telegraf
- 無縫連線到 collectd
- 無縫連線到 StatsD
- 支援 Prometheus remote_read 和 remote_write

![](http://img.blog.itpub.net/blog/2022/10/09/30ba7caa3fad1c85.png?x-oss-process=style/bb)
aosAdapter 架構圖

**taosAdapter 部署方法**

**安裝 taosAdapter**
有兩種安裝方式，你可以選擇進入濤思資料官網（https://www.taosdata.com/）下載 TDengine server 安裝包，無需任何額外操作即可安裝好 taosAdapter。

這種方式下，如果你需要將 taosAdapter 分離部署在 TDengine server 之外的伺服器上，則應該在該伺服器上安裝完整的 TDengine 來安裝 taosAdapter。除此之外，你還可以選擇使用原始碼編譯生成 taosAdapter，具體可參考如下文件（https://github.com/taosdata/taosadapter/blob/3.0/BUILD-CN.md）。

**啟動/停止 taosAdapter**
在 Linux 系統上 taosAdapter 服務預設由 systemd 管理，使用命令 systemctl start taosadapter 可以啟動 taosAdapter 服務，使用命令 systemctl stop taosadapter 可以停止 taosAdapter 服務。

**移除 taosAdapter**
使用命令 rmtaos 可以移除包括 taosAdapter 在內的 TDengine server 軟體。

**升級 taosAdapter**
taosAdapter 和 TDengine server 需要使用相同版本，請透過升級 TDengine server 來升級 taosAdapter。

taosAdapter 支援透過命令列引數、環境變數和配置檔案來配置，預設配置檔案是 /etc/taos/taosadapter.toml。其中，命令列引數優先於環境變數優先於配置檔案，命令列用法是 arg=val，如 taosadapter -p=30000 --debug=true，詳細引數列表可參見：https://docs.taosdata.com/reference/taosadapter/。

**介面**

**TDengine RESTful 介面**
你可以使用任何支援 http 協議的客戶端訪問 RESTful 介面地址 http://<fqdn>:6041/rest/sql 來寫入資料到 TDengine 或從 TDengine 中查詢資料。細節請參考官方文件（https://docs.taosdata.com/connector/rest-api/）。

**InfluxDB**
你可以使用任何支援 http 協議的客戶端訪問 Restful 介面地址 http://<fqdn>:6041/<apiendpoint> 來寫入 InfluxDB 相容格式的資料到 TDengine。EndPoint 如下：
```cpp
/influxdb/v1/write
```
支援 InfluxDB 查詢引數如下：
- db 指定 TDengine 使用的資料庫名
- precision TDengine 使用的時間精度
- u TDengine 使用者名稱
- p TDengine 密碼

注意：目前不支援 InfluxDB 的 token 驗證方式，僅支援 Basic 驗證和查詢引數驗證。

**OpenTSDB**
同樣，你可以使用任何支援 http 協議的客戶端訪問 Restful 介面地址 http://<fqdn>:6041/<apiendpoint> 來寫入 OpenTSDB 相容格式的資料到 TDengine。EndPoint 如下：
```cpp
/opentsdb/v1/put/json/<db>
/opentsdb/v1/put/telnet/<db>
```

**collectd**
配置 taosAdapter 接收 collectd 資料的方法如下：

在 taosAdapter 配置檔案（預設位置為 /etc/taos/taosadapter.toml）中使能配置項：
```cpp
...
[opentsdb_telnet]
enable = true
maxTCPConnections = 250
tcpKeepAlive = false
dbs = ["opentsdb_telnet", "collectd", "icinga2", "tcollector"]
ports = [6046, 6047, 6048, 6049]
user = "root"
password = "taosdata"
...
```
其中 taosAdapter 預設寫入的資料庫名稱為 collectd，也可以修改 taosAdapter 配置檔案 dbs 項來指定不同的名稱。user 和 password 填寫實際 TDengine 配置的值，修改過配置檔案後 taosAdapter 需重新啟動。

**StatsD**
配置 taosAdapter 接收 StatsD 資料的方法如下：

在 taosAdapter 配置檔案（預設位置 /etc/taos/taosadapter.toml）中使能配置項：
```cpp
...
[statsd]
enable = true
port = 6044
db = "statsd"
user = "root"
password = "taosdata"
worker = 10
gatherInterval = "5s"
protocol = "udp"
maxTCPConnections = 250
tcpKeepAlive = false
allowPendingMessages = 50000
deleteCounters = true
deleteGauges = true
deleteSets = true
deleteTimings = true
...
```

其中 taosAdapter 預設寫入的資料庫名稱為 statsd，也可以修改 taosAdapter 配置檔案 db 項來指定不同的名稱。同樣，user 和 password 填寫實際 TDengine 配置的值，如果修改了配置檔案，taosAdapter 需重新啟動。

在上述兩種介面下，也可以使用 taosAdapter 命令列引數或設定環境變數啟動的方式，使 taosAdapter 能接收 collectd/StatsD 資料。更多介面及其配置方法，請參考 https://docs.taosdata.com/reference/taosadapter/。

**記憶體使用最佳化方法**

taosAdapter 將監測自身執行過程中的記憶體使用率，並透過兩個閾值（pauseQueryMemoryThreshold 及 pauseAllMemoryThreshold）進行調節,有效值範圍為 -1 到 100 之間的整數，單位為系統實體記憶體的百分比。

- 當超過 pauseQueryMemoryThreshold 閾值時將停止處理查詢請求。http 返回內容為 code 503、body “query memory exceeds threshold”
- 當超過 pauseAllMemoryThreshold 閾值時停止處理所有寫入和查詢請求。http 返回內容為 code 503、body “memory exceeds threshold”

當記憶體回落到閾值之下時恢復對應功能。狀態檢查介面 http://<fqdn>:6041/-/ping

- 正常返回 code 200
- 無引數。如果記憶體超過 pauseAllMemoryThreshold 將返回 code 503
- 請求引數 action=query。如果記憶體超過 pauseQueryMemoryThreshold 或 pauseAllMemoryThreshold 將返回 code 503

我們可以根據具體專案應用場景和運營策略進行相應調整，建議使用運營監控軟體及時進行系統記憶體狀態監控。負載均衡器也可以透過這個介面檢查 taosAdapter 執行狀態。點選 https://docs.taosdata.com/reference/taosadapter/ 可檢視引數詳情。

**如何從舊版本 TDengine 遷移到 taosAdapter**

在 TDengine server 2.2.x.x 或更早期版本中，taosd 程式包含一個內嵌的 HTTP 服務。如前文所述，taosAdapter 是一個使用 systemd 管理的獨立軟體，擁有自己的程式，並且兩者有一些配置引數和行為是不同的，請見下表：
![](http://img.blog.itpub.net/blog/2022/10/09/693d003436e8f235.jpeg?x-oss-process=style/bb)

taosAdapter 主要透過引數 restfulRowLimit 來控制結果的返回條數，-1 代表無限制，預設無限制。該引數控制以下介面返回：

http://<fqdn>:6041/rest/sql
http://<fqdn>:6041/prometheus/v1/remote_read/:db
如果出現故障，我們可以透過命令 systemctl status taosadapter 來檢查 taosAdapter 執行狀態，也可以透過設定 –logLevel 引數或者環境變數 TAOS_ADAPTER_LOG_LEVEL 來調節 taosAdapter 日誌輸出詳細程度，有效值包括：panic、fatal、error、warn、warning、info、debug 以及 trace。

**寫在最後**

受文章篇幅所限，本文並未包含 taosAdapter 應用手冊的所有技術細節，如需查詢相關配置內容，可以移步到 TDengine 官網-技術文件進行更具體瞭解。此外，歡迎大家掃碼新增小助手小T，進入 TDengine 使用者交流群，在本群中，你不僅可以與有同樣業務場景的小夥伴進行交流，還可以獲得官方技術人員的專業支援。
![](http://img.blog.itpub.net/blog/2022/10/09/c82b852439aa6a64.jpeg?x-oss-process=style/bb)

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

想了解更多 TDengine Database的具體細節，歡迎大家在[GitHub]( https://github.com/taosdata/grafanaplugin"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)")</fqdn></fqdn></fqdn></db></db></apiendpoint></fqdn></apiendpoint></fqdn></fqdn>

如何從 InfluxDB/OpenTSDB 無縫連線到 TDengine

相關文章