小 T 導讀：taosAdapter 是 TDengine 這款時序數據庫（Time Series Database）的(de)配(pei)(pei)套工具，是 TDengine 集(ji)群和應(ying)用(yong)程序之間的(de)橋梁和適配(pei)(pei)器。當我(wo)們需要(yao)從數(shu)據(ju)(ju)收集(ji)代理(li)軟件（如 Telegraf、StatsD、collectd 等）攝取數(shu)據(ju)(ju)時，使用(yong) taosAdapter 能讓這一操作變(bian)得更加高效。此外(wai)，它還提供了 InfluxDB/OpenTSDB 兼容的(de)數(shu)據(ju)(ju)攝取接(jie)口(kou)，允許 InfluxDB/OpenTSDB 應(ying)用(yong)程序無(wu)縫移(yi)植到 TDengine。本文將整體介紹一下 taosAdapter，方便大家使用(yong)。

taosAdapter 主(zhu)要提供以下功(gong)能：

• RESTful 接口
• 兼容 InfluxDB v1 寫接口
• 兼容 OpenTSDB JSON 和 telnet 格式寫入
• 無縫連接到 Telegraf
• 無縫連接到 collectd
• 無縫連接到 StatsD
• 支持 Prometheus remote_read 和 remote_write

taosAdapter 部署方法

安裝 taosAdapter

有兩種安裝方式，你可以選擇進入濤思數據官網（//yakult-sh.com.cn/）下載 TDengine server 安裝包，無需任(ren)何額外操作即可安裝好 taosAdapter。

這種方式(shi)下，如(ru)果你需要將(jiang) taosAdapter 分(fen)離部署在(zai) TDengine server 之(zhi)外的(de)服(fu)務(wu)器上(shang)，則應該在(zai)該服(fu)務(wu)器上(shang)安裝(zhuang)完整的(de) TDengine 來安裝(zhuang) taosAdapter。除此之(zhi)外，你還可以選擇使用(yong)源代(dai)碼編譯(yi)生(sheng)成 taosAdapter，具體可參考如(ru)下文檔（）。

啟動/停止 taosAdapter

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

移除 taosAdapter

使用命令 rmtaos 可以移除包括(kuo) taosAdapter 在內的 TDengine server 軟件(jian)。

升級 taosAdapter

taosAdapter 和(he) TDengine server 需要使用(yong)相同版本，請通過升(sheng)級(ji) TDengine server 來升(sheng)級(ji) taosAdapter。

taosAdapter 支持通過命令行參數、環境變量和配置文件來配置，默認配置文件是 /etc/taos/taosadapter.toml。其中，命令行參數優先于環境變量優先于配置文件，命令行用法是 arg=val，如 taosadapter -p=30000 --debug=true，詳細(xi)參(can)數列表可參(can)見(jian)：。

接口

TDengine RESTful 接口

你可以使用任何支持 http 協議的客戶端訪問 RESTful 接口地址 //<fqdn>:6041/rest/sql 來(lai)寫入(ru)數據到 TDengine 或從(cong) TDengine 中查詢數據。細節請參考官(guan)方(fang)文檔（）。

InfluxDB

你可以使用任何支持 http 協議的客戶端訪問 Restful 接口地址 //<fqdn>:6041/<APIEndPoint> 來寫(xie)入(ru) InfluxDB 兼(jian)容格式的(de)數據到 TDengine。EndPoint 如(ru)下(xia)：

/influxdb/v1/write

支持(chi) InfluxDB 查詢參數(shu)如下：

• db 指定 TDengine 使用的數據庫名
• precision TDengine 使用的時間精度
• u TDengine 用戶名
• p TDengine 密碼

注意：目(mu)前不支持 InfluxDB 的 token 驗證方(fang)式，僅(jin)支持 Basic 驗證和查詢參數驗證。

OpenTSDB

同樣，你可以使用任何支持 http 協議的客戶端訪問 Restful 接口地址 //<fqdn>:6041/<APIEndPoint> 來(lai)寫入(ru) OpenTSDB 兼容格(ge)式的數(shu)據到(dao) TDengine。EndPoint 如下：

/opentsdb/v1/put/json/<db>
/opentsdb/v1/put/telnet/<db>

collectd

配置(zhi) taosAdapter 接收 collectd 數據的方(fang)法如下：

• 在 taosAdapter 配置文件（默認位置為 /etc/taos/taosadapter.toml）中使能配置項：

...
[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，也可以修改(gai) taosAdapter 配(pei)置文件 dbs 項(xiang)來指定不同的名稱(cheng)。user 和 password 填寫(xie)實際 TDengine 配(pei)置的值，修改(gai)過配(pei)置文件后 taosAdapter 需(xu)重新啟動。

StatsD

配置 taosAdapter 接收 StatsD 數(shu)據(ju)的方(fang)法如(ru)下：

• 在 taosAdapter 配置文件（默認位置 /etc/taos/taosadapter.toml）中使能配置項：

...
[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，也可(ke)以修(xiu)改 taosAdapter 配(pei)置文件 db 項來指定(ding)不同(tong)的名稱。同(tong)樣，user 和 password 填寫實際 TDengine 配(pei)置的值，如果修(xiu)改了配(pei)置文件，taosAdapter 需重新啟動。

在上述兩種(zhong)接(jie)(jie)口(kou)下，也可以使(shi)用 taosAdapter 命令行參數(shu)(shu)或設置環(huan)境變量啟動(dong)的方式，使(shi) taosAdapter 能(neng)接(jie)(jie)收 collectd/StatsD 數(shu)(shu)據。更多接(jie)(jie)口(kou)及其配置方法，請參考 。

內存使用優化方法

taosAdapter 將監(jian)測自身運行(xing)(xing)過程中的(de)內存使用率，并通過兩個閾值（pauseQueryMemoryThreshold 及(ji) pauseAllMemoryThreshold）進行(xing)(xing)調(diao)節,有效值范圍(wei)為 -1 到 100 之間的(de)整(zheng)數，單位(wei)為系統物理內存的(de)百分比(bi)。

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

當內存回落到閾值之下時恢復對應功能。狀態檢查接口 //<fqdn>:6041/-/ping

• 正常返回 code 200
• 無參數。如果內存超過 pauseAllMemoryThreshold 將返回 code 503
• 請求參數 action=query。如果內存超過 pauseQueryMemoryThreshold 或 pauseAllMemoryThreshold 將返回 code 503

我們可以(yi)根(gen)據具體項(xiang)目(mu)應用場景(jing)和(he)運營策(ce)略進行相應調整，建議使用運營監(jian)控軟件及時進行系統內存(cun)狀態(tai)監(jian)控。負載均衡器也可以(yi)通過這個接口檢(jian)查 taosAdapter 運行狀態(tai)。點擊  可查看參數詳情。

如何從舊版本 TDengine 遷移到 taosAdapter

在 TDengine server 2.2.x.x 或更早期版本中(zhong)，taosd 進(jin)程(cheng)包含一個內嵌的(de) HTTP 服務。如(ru)前(qian)文所述，taosAdapter 是(shi)(shi)一個使用(yong) systemd 管理的(de)獨立軟件(jian)，擁有自己的(de)進(jin)程(cheng)，并且兩(liang)者有一些(xie)配置參數(shu)和行為(wei)是(shi)(shi)不同的(de)，請見下表(biao)：

taosAdapter 主要通過參數 restfulRowLimit 來控制(zhi)結果的返回條數(shu)，-1 代表無(wu)限制(zhi)，默(mo)認(ren)無(wu)限制(zhi)。該(gai)參數(shu)控制(zhi)以下(xia)接(jie)口(kou)返回：

• //<fqdn>:6041/rest/sql
• //<fqdn>:6041/prometheus/v1/remote_read/:db

如果出現故障，我們可以通過命令 systemctl status taosadapter 來檢查 taosAdapter 運(yun)行狀態(tai)，也可以(yi)通過(guo)設(she)置(zhi) –logLevel 參數或(huo)者環境變量 TAOS_ADAPTER_LOG_LEVEL 來調節(jie) taosAdapter 日志(zhi)輸出詳(xiang)細程度，有效值包(bao)括：panic、fatal、error、warn、warning、info、debug 以(yi)及 trace。

寫在最后

受(shou)文(wen)章篇(pian)幅所限，本文(wen)并未包含(han) taosAdapter 應(ying)用(yong)手(shou)冊(ce)的所有技術細節(jie)，如需查詢相關配置(zhi)內容(rong)，可(ke)以(yi)移步(bu)到 TDengine 官(guan)網-技術文(wen)檔進行更具(ju)體了(le)解。此外(wai)，歡迎大家(jia)掃碼添加(jia)小(xiao)助手(shou)小(xiao)T，進入 TDengine 用(yong)戶交流群(qun)，在本群(qun)中(zhong)，你(ni)不僅可(ke)以(yi)與有同樣業務場(chang)景的小(xiao)伙伴(ban)進行交流，還可(ke)以(yi)獲得官(guan)方技術人員的專業支(zhi)持。