跳到主要内容

taosAdapter 参考手册

taosAdapter 是一个 TDengine TSDB 的配套工具，是 TDengine TSDB 集群和应用程序之间的桥梁和适配器。它提供了一种易于使用和高效的方式来直接从数据收集代理软件（如 Telegraf、StatsD、collectd 等）摄取数据。它还提供了 InfluxDB/OpenTSDB 兼容的数据摄取接口，允许 InfluxDB/OpenTSDB 应用程序无缝移植到 TDengine TSDB。 TDengine TSDB 的各语言连接器通过 WebSocket 接口与 TDengine TSDB 进行通信，因此必须安装 taosAdapter。

架构图如下：

TDengine TSDB Database taosAdapter Architecture

功能列表​

taosAdapter 提供了以下功能：

WebSocket 接口​

各语言连接器通过 taosAdapter 的 WebSocket 接口，能够实现 SQL 执行、无模式写入、参数绑定和数据订阅功能。参考 开发指南。

InfluxDB v1 数据写入​

您可以使用任何支持 HTTP 协议的客户端访问 Restful 接口地址 http://<fqdn>:6041/influxdb/v1/write 来写入 InfluxDB 兼容格式的数据到 TDengine TSDB。

支持 InfluxDB 参数如下：

  • db 指定 TDengine TSDB 使用的数据库名
  • precision TDengine TSDB 使用的时间精度
  • u TDengine TSDB 用户名
  • p TDengine TSDB 密码
  • ttl 自动创建的子表生命周期，以子表的第一条数据的 TTL 参数为准，不可更新。更多信息请参考 创建表文档的 TTL 参数。
  • table_name_key 自定义子表名使用的标签名，如果设置了该参数，则子表名将使用该标签对应的值。

注意：目前不支持 InfluxDB 的 token 验证方式，仅支持 Basic 验证和查询参数验证。 示例：

curl --request POST http://127.0.0.1:6041/influxdb/v1/write?db=test --user "root:taosdata" --data-binary "measurement,host=host1 field1=2i,field2=2.0 1577836800000000000"

OpenTSDB JSON 和 telnet 格式写入​

您可以使用任何支持 HTTP 协议的客户端访问 Restful 接口地址 http://<fqdn>:6041/<APIEndPoint> 来写入 OpenTSDB 兼容格式的数据到 TDengine TSDB。EndPoint 如下：

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

collectd 数据写入​

collectd 使用插件机制可以以多种形式将采集到的监控数据写入到不同的数据存储软件。TDengine 支持写入 collectd write_tsdb 插件数据和 collectd 二进制数据。

collectd write_tsdb 插件是 collectd 官方提供的插件，支持将数据转为 OpenTSDB 协议格式发送到后端存储。

collectd write_tsdb 插件数据写入​

配置 taosAdapter​
  • 在 taosAdapter 配置文件（默认位置为 /etc/taos/taosadapter.toml）中使能配置项
# 写入 Schemaless 数据时自动创建数据库
smlAutoCreateDB = true
[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 需重新启动。

smlAutoCreateDB 配置项用于使能自动创建数据库功能，设置为 true 时，taosAdapter 会在接收到数据时自动创建对应的数据库（如果不存在）。

  • 使用 taosAdapter 命令行参数或设置环境变量启动的方式，使能 taosAdapter 接收 collectd 数据功能，具体细节请参考 taosAdapter 的参考手册。
配置 collectd​

修改 collectd 配置文件（默认位置 /etc/collectd/collectd.conf）相关配置项。

LoadPlugin write_tsdb
<Plugin write_tsdb>
        <Node>
                Host "<taosAdapter's host>"
                Port "<port for collectd write_tsdb plugin>"
                ...
        </Node>
</Plugin>

其中 <taosAdapter's host> 填写运行 taosAdapter 的服务器域名或 IP 地址。<port for collectd write_tsdb plugin> 填写 taosAdapter 用于接收 collectd write_tsdb 插件的数据（默认为 6047）。

LoadPlugin write_tsdb
<Plugin write_tsdb>
        <Node>
                Host "127.0.0.1"
                Port "6047"
                HostTags "status=production"
                StoreRates false
                AlwaysAppendDS false
        </Node>
</Plugin>

然后重启 collectd：

systemctl restart collectd

collectd 二进制数据写入​

配置 taosAdapter​

  • 在 taosAdapter 配置文件（默认位置为 /etc/taos/taosadapter.toml）中使能配置项

    ...
    [collectd]
    enable = true
    port = 6045
    db = "collectd"
    user = "root"
    password = "taosdata"
    worker = 10
    ...

    其中 taosAdapter 默认写入的数据库名称为 collectd，也可以修改 taosAdapter 配置文件 db 项来指定不同的名称。user 和 password 填写实际 TDengine 配置的值。修改过配置文件 taosAdapter 需重新启动。

  • 使用 taosAdapter 命令行参数或设置环境变量启动的方式，使能 taosAdapter 接收 collectd 数据功能，具体细节请参考 taosAdapter 的参考手册。

配置 collectd​

修改 collectd 配置文件（默认位置 /etc/collectd/collectd.conf）相关配置项。

LoadPlugin network
<Plugin network>
         Server "<taosAdapter's host>" "<port for collectd direct>"
</Plugin>

其中 <taosAdapter's host> 填写运行 taosAdapter 的服务器域名或 IP 地址。<port for collectd direct> 填写 taosAdapter 用于接收 collectd 数据的端口（默认为 6045）。

示例如下：

LoadPlugin network
<Plugin network>
         Server "127.0.0.1" "6045"
</Plugin>

然后重启 collectd：

systemctl restart collectd

StatsD 数据写入​

配置 taosAdapter​

配置 taosAdapter 接收 StatsD 数据的方法：

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

    # 写入 Schemaless 数据时自动创建数据库
    smlAutoCreateDB = true
    [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 需重新启动。

    smlAutoCreateDB 配置项用于使能自动创建数据库功能，设置为 true 时，taosAdapter 会在接收到数据时自动创建对应的数据库（如果不存在）。

  • 使用 taosAdapter 命令行参数或设置环境变量启动的方式，使能 taosAdapter 接收 StatsD 数据功能，具体细节请参考 taosAdapter 的参考手册

配置 StatsD​

使用 StatsD 需要下载其源代码。其配置文件请参考其源代码下载到本地的根目录下的示例文件 exampleConfig.js 进行修改。其中 <taosAdapter's host> 填写运行 taosAdapter 的服务器域名或 IP 地址，<port for StatsD> 请填写 taosAdapter 接收 StatsD 数据的端口（默认为 6044）。

backends 部分添加 "./backends/repeater"
repeater 部分添加 { host:'<taosAdapter's host>', port: <port for StatsD>}

示例配置文件：

{
port: 8125
, backends: ["./backends/repeater"]
, repeater: [{ host: '127.0.0.1', port: 6044}]
}

增加如下内容后启动 StatsD（假设配置文件修改为 config.js）。

npm install
node stats.js config.js &

icinga2 OpenTSDB writer 数据写入​

配置 taosAdapter​

配置 taosAdapter 接收 icinga2 数据的方法：

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

    # 写入 Schemaless 数据时自动创建数据库
    smlAutoCreateDB = true
    [opentsdb_telnet]
    enable = true
    maxTCPConnections = 250
    tcpKeepAlive = false
    dbs = ["opentsdb_telnet", "collectd", "icinga2", "tcollector"]
    ports = [6046, 6047, 6048, 6049]
    user = "root"
    password = "taosdata"

    其中 taosAdapter 默认写入的数据库名称为 icinga2，也可以修改 taosAdapter 配置文件 dbs 项来指定不同的名称。user 和 password 填写实际 TDengine 配置的值。修改过 taosAdapter 需重新启动。

    smlAutoCreateDB 配置项用于使能自动创建数据库功能，设置为 true 时，taosAdapter 会在接收到数据时自动创建对应的数据库（如果不存在）。

  • 使用 taosAdapter 命令行参数或设置环境变量启动的方式，使能 taosAdapter 接收 icinga2 数据功能，具体细节请参考 taosAdapter 的参考手册

配置 icinga2​

  • 使能 icinga2 的 opentsdb-writer参考链接

  • 修改配置文件 /etc/icinga2/features-enabled/opentsdb.conf 填写 <taosAdapter's host> 为运行 taosAdapter 的服务器的域名或 IP 地址，<port for icinga2> 填写 taosAdapter 支持接收 icinga2 数据的相应端口（默认为 6048）

    object OpenTsdbWriter "opentsdb" {
      host = "<taosAdapter's host>"
      port = <port for icinga2>
    }

    示例文件：

    object OpenTsdbWriter "opentsdb" {
      host = "127.0.0.1"
      port = 6048
    }

TCollector 数据写入​

配置 taosAdapter​

配置 taosAdapter 接收 TCollector 数据的方法：

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

    # 写入 Schemaless 数据时自动创建数据库
    smlAutoCreateDB = true
    [opentsdb_telnet]
    enable = true
    maxTCPConnections = 250
    tcpKeepAlive = false
    dbs = ["opentsdb_telnet", "collectd", "icinga2", "tcollector"]
    ports = [6046, 6047, 6048, 6049]
    user = "root"
    password = "taosdata"

    其中 taosAdapter 默认写入的数据库名称为 tcollector，也可以修改 taosAdapter 配置文件 dbs 项来指定不同的名称。user 和 password 填写实际 TDengine 配置的值。修改过配置文件 taosAdapter 需重新启动。

    smlAutoCreateDB 配置项用于使能自动创建数据库功能，设置为 true 时，taosAdapter 会在接收到数据时自动创建对应的数据库（如果不存在）。

  • 使用 taosAdapter 命令行参数或设置环境变量启动的方式，使能 taosAdapter 接收 tcollector 数据功能，具体细节请参考 taosAdapter 的参考手册

配置 TCollector​

使用 TCollector 需下载其源代码。其配置项在其源代码中。注意：TCollector 各个版本区别较大，这里仅以当前 master 分支最新代码 (git commit: 37ae920) 为例。

修改 collectors/etc/config.py 和 tcollector.py 两个文件中相应内容。将原指向 OpenTSDB 宿主机的地址修改为 taosAdapter 被部署的服务器域名或 IP 地址，修改端口为 taosAdapter 支持 TCollector 使用的相应端口（默认为 6049）。

示例为源代码修改内容的 git diff 输出：

index e7e7a1c..ec3e23c 100644
--- a/collectors/etc/config.py
+++ b/collectors/etc/config.py
@@ -59,13 +59,13 @@ def get_defaults():
         'http_password': False,
         'reconnectinterval': 0,
         'http_username': False,
-        'port': 4242,
+        'port': 6049,
         'pidfile': '/var/run/tcollector.pid',
         'http': False,
         'http_api_path': "api/put",
         'tags': [],
         'remove_inactive_collectors': False,
-        'host': '',
+        'host': '127.0.0.1',
         'logfile': '/var/log/tcollector.log',
         'cdir': default_cdir,
         'ssl': False,
diff --git a/tcollector.py b/tcollector.py
index 21f9b23..4c71ba2 100755
--- a/tcollector.py
+++ b/tcollector.py
@@ -64,7 +64,7 @@ ALIVE = True
 # exceptions, something is not right and tcollector will shutdown.
 # Hopefully some kind of supervising daemon will then restart it.
 MAX_UNCAUGHT_EXCEPTIONS = 100
-DEFAULT_PORT = 4242
+DEFAULT_PORT = 6049
 MAX_REASONABLE_TIMESTAMP = 2209212000  # Good until Tue  3 Jan 14:00:00 GMT 2040
 # How long to wait for datapoints before assuming
 # a collector is dead and restarting it
@@ -943,13 +943,13 @@ def parse_cmdline(argv):
             'http_password': False,
             'reconnectinterval': 0,
             'http_username': False,
-            'port': 4242,
+            'port': 6049,
             'pidfile': '/var/run/tcollector.pid',
             'http': False,
             'http_api_path': "api/put",
             'tags': [],
             'remove_inactive_collectors': False,
-            'host': '',
+            'host': '127.0.0.1',
             'logfile': '/var/log/tcollector.log',
             'cdir': default_cdir,
             'ssl': False,

OpenMetrics 采集写入​

OpenMetrics 是一种由 CNCF（云原生计算基金会）支持的开放标准，专注于规范指标数据的采集和传输，是云原生生态中监控和可观测性系统的核心规范之一。

从 3.3.7.0 版本开始，taosAdapter 支持 OpenMetrics v1.0.0 数据采集与写入，同时兼容 Prometheus 0.0.4 协议，确保与 Prometheus 生态的无缝集成。

启用 OpenMetrics 数据采集写入需要以下步骤：

  • 启用 taosAdapter 的配置 open_metrics.enable
  • 设置 OpenMetrics 的相关配置
  • 重新启动 taosAdapter

Prometheus remote_read 和 remote_write​

首先创建一个 Prometheus 数据库，用于存储 Prometheus 指标数据：

CREATE DATABASE prometheus_data;

配置 Prometheus 是通过编辑 Prometheus 配置文件 prometheus.yml（默认位置 /etc/prometheus/prometheus.yml）完成的。

配置第三方数据库地址​

将其中的 remote_read url 和 remote_write url 指向运行 taosAdapter 服务的服务器域名或 IP 地址，REST 服务端口（taosAdapter 默认使用 6041），以及希望写入 TDengine 的数据库名称，并确保相应的 URL 形式如下：

  • remote_read url : http://<taosAdapter's host>:<REST service port>/prometheus/v1/remote_read/<database name>
  • remote_write url : http://<taosAdapter's host>:<REST service port>/prometheus/v1/remote_write/<database name>

配置 Basic 验证​

  • username: <TDengine's username>
  • password: <TDengine's password>

prometheus.yml 文件中 remote_write 和 remote_read 相关部分配置示例​

remote_write:
  - url: "http://localhost:6041/prometheus/v1/remote_write/prometheus_data"
    basic_auth:
      username: root
      password: taosdata

remote_read:
  - url: "http://localhost:6041/prometheus/v1/remote_read/prometheus_data"
    basic_auth:
      username: root
      password: taosdata
    remote_timeout: 10s
    read_recent: true

node_exporter 采集写入​

从 3.3.7.0 版本开始，可以使用 OpenMetrics 插件替代 node_exporter 进行数据采集和写入。

Prometheus 使用的由 *NIX 内核暴露的硬件和操作系统指标的输出器。

  • 启用 taosAdapter 的配置 node_exporter.enable
  • 设置 node_exporter 的相关配置
  • 重新启动 taosAdapter

RESTful 接口​

您可以使用任何支持 HTTP 协议的客户端通过访问 RESTful 接口地址 http://<fqdn>:6041/rest/sql 来写入数据到 TDengine TSDB 或从 TDengine TSDB 中查询数据。细节请参考 REST API 文档。

安装​

taosAdapter 是 TDengine TSDB 服务端软件 的一部分，如果您使用 TDengine TSDB server 您不需要任何额外的步骤来安装 taosAdapter。您可以从 涛思数据官方网站 下载 TDengine TSDB server 安装包。如果需要将 taosAdapter 分离部署在 TDengine TSDB server 之外的服务器上，则应该在该服务器上安装完整的 TDengine TSDB 来安装 taosAdapter。如果您需要使用源代码编译生成 taosAdapter，您可以参考 构建 taosAdapter 文档。

安装完成后使用命令 systemctl start taosadapter 可以启动 taosAdapter 服务。

配置​

taosAdapter 支持通过命令行参数、环境变量和配置文件来进行配置。默认配置文件是 /etc/taos/taosadapter.toml，可用过 -c 或 --config 命令行参数指定配置文件。

命令行参数优先于环境变量优先于配置文件，命令行用法是 arg=val，如 taosadapter -p=30000 --debug=true。

示例配置文件参见 example/config/taosadapter.toml。

基础配置​

taosAdapter 的基础配置参数如下：

  • debug：是否启用调试模式（pprof）
    • 设置为 true 时：（默认值）启用 go pprof 调试模式，允许使用 http://<fqdn>:<port>/debug/pprof 访问调试信息。
    • 设置为 false 时：关闭调试模式，不允许访问调试信息。
  • instanceId：taosAdapter 实例 id，用于区分不同 taosAdapter 的日志，默认值：32。
  • port：taosAdapter 对外提供 HTTP/WebSocket 服务的端口，默认值：6041。
  • taosConfigDir：TDengine TSDB 的配置文件目录，默认值：/etc/taos。该目录下的 taos.cfg 文件将被加载。

从 3.3.4.0 版本 开始，taosAdapter 支持设置调用 C 方法并发调用数：

  • maxAsyncConcurrentLimit

    设置 C 异步方法的最大并发调用数（0 表示使用 CPU 核心数）。

  • maxSyncConcurrentLimit

    设置 C 同步方法的最大并发调用数（0 表示使用 CPU 核心数）。

跨域配置​

使用浏览器进行接口调用时，请根据实际情况设置如下跨域（CORS）参数：

  • cors.allowAllOrigins：是否允许所有来源访问，默认为 true。
  • cors.allowOrigins：允许跨域访问的来源列表，支持多个来源，以逗号分隔。
  • cors.allowHeaders：允许跨域访问的请求头列表，支持多个请求头，以逗号分隔。
  • cors.exposeHeaders：允许跨域访问的响应头列表，支持多个响应头，以逗号分隔。
  • cors.allowCredentials：是否允许跨域请求包含用户凭证，如 cookies、HTTP 认证信息或客户端 SSL 证书。
  • cors.allowWebSockets：是否允许 WebSockets 连接。

如果不通过浏览器进行接口调用无需关心这几项配置。

以上配置对以下接口生效：

  • RESTful 接口请求
  • WebSocket 接口请求
  • InfluxDB v1 写接口
  • OpenTSDB HTTP 写入接口

关于 CORS 协议细节请参考：https://www.w3.org/wiki/CORS_Enabled 或 https://developer.mozilla.org/zh-CN/docs/Web/HTTP/CORS。

连接池配置​

taosAdapter 使用连接池管理与 TDengine TSDB 的连接，以提高并发性能和资源利用率。连接池配置对以下接口生效，且以下接口共享一个连接池：

  • RESTful 接口请求
  • InfluxDB v1 写接口
  • OpenTSDB JSON 和 telnet 格式写入
  • Telegraf 数据写入
  • collectd 数据写入
  • StatsD 数据写入
  • node_exporter 数据写入
  • OpenMetrics 数据写入
  • Prometheus remote_read 和 remote_write

连接池的配置参数如下：

  • pool.maxConnect：连接池允许的最大连接数，默认值为 2 倍 CPU 核心数。建议保持默认设置。
  • pool.maxIdle：连接池中允许的最大空闲连接数，默认与 pool.maxConnect 相同。建议保持默认设置。
  • pool.idleTimeout：连接空闲超时时间，默认永不超时。建议保持默认设置。
  • pool.waitTimeout：从连接池获取连接的超时时间，默认设置为 60 秒。如果在超时时间内未能获取连接，将返回 HTTP 状态码 503。该参数从版本 3.3.3.0 开始提供。
  • pool.maxWait：连接池中等待获取连接的请求数上限，默认值为 0，表示不限制。当排队请求数超过此值时，新的请求将返回 HTTP 状态码 503。该参数从版本 3.3.3.0 开始提供。

HTTP 返回码配置​

taosAdapter 通过参数 httpCodeServerError 来控制当底层 C 接口返回错误时，是否在 RESTful 接口请求中返回非 200 的 HTTP 状态码。当设置为 true 时，taosAdapter 会根据 C 接口返回的错误码映射为相应的 HTTP 状态码。具体映射规则请参考 HTTP 响应码。

该配置只会影响 RESTful 接口。

参数说明​
  • httpCodeServerError：
    • 设置为 true 时：根据 C 接口返回的错误码映射为相应的 HTTP 状态码。
    • 设置为 false 时：无论 C 接口返回什么错误，始终返回 HTTP 状态码 200（默认值）。

内存限制配置​

taosAdapter 将监测自身运行过程中内存使用率并通过两个阈值进行调节。有效值范围为 1 到 100 的整数，单位为系统物理内存的百分比。

该配置只会影响以下接口：

  • RESTful 接口请求
  • InfluxDB v1 写接口
  • OpenTSDB HTTP 写入接口
  • Prometheus remote_read 和 remote_write 接口
参数说明​
  • pauseQueryMemoryThreshold：
    • 当内存使用超过此阈值时，taosAdapter 将停止处理查询请求。
    • 默认值：70（即 70% 的系统物理内存）。
  • pauseAllMemoryThreshold：
    • 当内存使用超过此阈值时，taosAdapter 将停止处理所有请求（包括写入和查询）。
    • 默认值：80（即 80% 的系统物理内存）。

当内存使用回落到阈值以下时，taosAdapter 会自动恢复相应功能。

HTTP 返回内容​
  • 超过 pauseQueryMemoryThreshold 时：
    • HTTP 状态码：503
    • 返回内容："query memory exceeds threshold"
  • 超过 pauseAllMemoryThreshold 时：
    • HTTP 状态码：503
    • 返回内容："memory exceeds threshold"
状态检查接口​

可以通过以下接口检查 taosAdapter 的内存状态：

  • 正常状态：http://<fqdn>:6041/-/ping 返回 code 200。
  • 内存超过阈值：
    • 如果内存超过 pauseAllMemoryThreshold，返回 code 503。
    • 如果内存超过 pauseQueryMemoryThreshold，且请求参数包含 action=query，返回 code 503。
相关配置参数​
  • monitor.collectDuration：内存监控间隔，默认值为 3s，环境变量为 TAOS_MONITOR_COLLECT_DURATION。
  • monitor.incgroup：是否在容器中运行（容器中运行设置为 true），默认值为 false，环境变量为 TAOS_MONITOR_INCGROUP。
  • monitor.pauseQueryMemoryThreshold：查询请求暂停的内存阈值（百分比），默认值为 70，环境变量为 TAOS_MONITOR_PAUSE_QUERY_MEMORY_THRESHOLD。
  • monitor.pauseAllMemoryThreshold：查询和写入请求暂停的内存阈值（百分比），默认值为 80，环境变量为 TAOS_MONITOR_PAUSE_ALL_MEMORY_THRESHOLD。

您可以根据具体项目应用场景和运营策略进行相应调整，并建议使用运营监控软件及时进行系统内存状态监控。负载均衡器也可以通过这个接口检查 taosAdapter 运行状态。

无模式写入创建 DB 配置​

从 3.0.4.0 版本 开始，taosAdapter 提供了参数 smlAutoCreateDB，用于控制在 schemaless 协议写入时是否自动创建数据库（DB）。

smlAutoCreateDB 参数只会影响以下接口：

  • InfluxDB v1 写接口
  • OpenTSDB JSON 和 telnet 格式写入
  • Telegraf 数据写入
  • collectd 数据写入
  • StatsD 数据写入
  • node_exporter 数据写入
  • OpenMetrics 数据写入
参数说明​
  • smlAutoCreateDB：
    • 设置为 true 时：在 schemaless 协议写入时，如果目标数据库不存在，taosAdapter 会自动创建该数据库。
    • 设置为 false 时：用户需要手动创建数据库，否则写入会失败（默认值）。

结果返回条数配置​

taosAdapter 提供了参数 restfulRowLimit，用于控制 HTTP 接口返回的结果条数。

restfulRowLimit 参数只会影响以下接口的返回结果：

  • RESTful 接口
  • Prometheus remote_read 接口
参数说明​
  • restfulRowLimit：
    • 设置为正整数时：接口返回的结果条数将不超过该值。
    • 设置为 -1 时：接口返回的结果条数无限制（默认值）。

日志配置​

配置参数如下：

  • log.path

    指定日志存储路径（默认值："/var/log/taos"）。

  • log.level

    设置日志级别（默认值："info"）。

  • log.keepDays

    日志保留天数（正整数，默认值：30）。

  • log.rotationCount

    日志文件轮转数量（默认值：30）。

  • log.rotationSize

    单个日志文件最大大小（支持 KB/MB/GB 单位，默认值："1GB"）。

  • log.compress

    是否压缩旧日志文件（默认值：false）。

  • log.rotationTime

    日志轮转时间（已弃用，固定 24 小时轮转）。

  • log.reservedDiskSize

    为日志目录保留的磁盘空间（支持 KB/MB/GB 单位，默认值："1GB"）。

  • log.enableSqlToCsvLogging

    是否启用记录 SQL 到 CSV 文件（默认值：false）具体内容见 记录 SQL 到 csv 文件。

  • log.enableRecordHttpSql

    不建议继续使用此参数，推荐使用记录 SQL 到 csv 文件作为替代方案

    是否记录 HTTP SQL 请求（默认值：false）。

  • log.sqlRotationCount

    不建议继续使用此参数，推荐使用记录 SQL 到 csv 文件作为替代方案

    SQL 日志轮转数量（默认值：2）。

  • log.sqlRotationSize

    不建议继续使用此参数，推荐使用记录 SQL 到 csv 文件作为替代方案

    单个 SQL 日志文件最大大小（支持 KB/MB/GB 单位，默认值："1GB"）。

  • log.sqlRotationTime

    不建议继续使用此参数，推荐使用记录 SQL 到 csv 文件作为替代方案

    SQL 日志轮转时间（默认值：24h）。

可以通过设置 --log.level 参数或者环境变量 TAOS_ADAPTER_LOG_LEVEL 来设置 taosAdapter 日志输出详细程度。有效值包括：panic、fatal、error、warn、warning、info、debug 以及 trace。

第三方数据源配置​

Collectd 配置参数​

  • collectd.enable

    启用或禁用 collectd 协议支持（默认值：false）。

  • collectd.port

    指定 collectd 服务监听端口（默认值：6045）。

  • collectd.db

    设置 collectd 数据写入的目标数据库名称（默认值："collectd"）。

  • collectd.user

    配置连接数据库使用的用户名（默认值："root"）。

  • collectd.password

    设置连接数据库使用的密码（默认值："taosdata"）。

  • collectd.ttl

    定义 collectd 数据的生存时间（默认值：0，表示无超时）。

  • collectd.worker

    配置 collectd 写入工作线程数量（默认值：10）。

InfluxDB 配置参数​

  • influxdb.enable

    启用或禁用 InfluxDB 协议支持（布尔值，默认值：true）。

OpenTSDB 配置参数​

  • opentsdb.enable

    是否启用 OpenTSDB HTTP 协议支持（默认值：true）。

  • opentsdb_telnet.enable

    是否启用 OpenTSDB Telnet 协议支持（警告：无认证机制，默认值：false）。

  • opentsdb_telnet.ports

    配置 OpenTSDB Telnet 监听端口（默认值：[6046,6047,6048,6049]）。

  • opentsdb_telnet.dbs

    指定 OpenTSDB Telnet 数据写入的数据库（默认值：["opentsdb_telnet","collectd_tsdb","icinga2_tsdb","tcollector_tsdb"]）。

  • opentsdb_telnet.user

    设置数据库连接用户名（默认值："root"）。

  • opentsdb_telnet.password

    设置数据库连接密码（默认值："taosdata"）。

  • opentsdb_telnet.ttl

    配置数据生存时间（默认值：0，表示无超时）。

  • opentsdb_telnet.batchSize

    设置批量写入大小（默认值：1）。

  • opentsdb_telnet.flushInterval

    配置刷新间隔时间（默认值：0s）。

  • opentsdb_telnet.maxTCPConnections

    设置最大 TCP 连接数（默认值：250）。

  • opentsdb_telnet.tcpKeepAlive

    是否启用 TCP KeepAlive（默认值：false）。

StatsD 配置参数​

  • statsd.enable

    是否启用 StatsD 协议支持（默认值：false）。

  • statsd.port

    设置 StatsD 服务监听端口（默认值：6044）。

  • statsd.protocol

    指定 StatsD 传输协议（可选：tcp/udp/tcp4/udp4，默认值："udp4"）。

  • statsd.db

    配置 StatsD 数据写入的目标数据库（默认值："statsd"）。

  • statsd.user

    设置数据库连接用户名（默认值："root"）。

  • statsd.password

    设置数据库连接密码（默认值："taosdata"）。

  • statsd.ttl

    配置数据生存时间（默认值：0，表示无超时）。

  • statsd.gatherInterval

    设置数据采集间隔（默认值：5s）。

  • statsd.worker

    配置写入工作线程数（默认值：10）。

  • statsd.allowPendingMessages

    设置允许挂起的消息数量（默认值：50000）。

  • statsd.maxTCPConnections

    配置最大 TCP 连接数（默认值：250）。

  • statsd.tcpKeepAlive

    是否启用 TCP KeepAlive（默认值：false）。

  • statsd.deleteCounters

    是否在采集后删除计数器缓存（默认值：true）。

  • statsd.deleteGauges

    是否在采集后删除测量值缓存（默认值：true）。

  • statsd.deleteSets

    是否在采集后删除集合缓存（默认值：true）。

  • statsd.deleteTimings

    是否在采集后删除计时器缓存（默认值：true）。

Prometheus 配置参数​

  • prometheus.enable

    是否启用 Prometheus 协议支持（默认值：true）。

OpenMetrics 配置参数​

  • open_metrics.enable

    启用或禁用 OpenMetrics 数据采集功能（默认值：false）。

  • open_metrics.user

    配置连接 TDengine TSDB 的用户名（默认值："root"）。

  • open_metrics.password

    设置连接 TDengine TSDB 的密码（默认值："taosdata"）。

  • open_metrics.urls

    指定 OpenMetrics 数据采集地址列表（默认值：["http://localhost:9100"]，未指定路由时会自动追加 /metrics）。

  • open_metrics.dbs

    设置数据写入的目标数据库列表（默认值：["open_metrics"]，需与采集地址数量相同）。

  • open_metrics.responseTimeoutSeconds

    配置采集超时时间（秒）（默认值：[5]，需与采集地址数量相同）。

  • open_metrics.httpUsernames

    设置 Basic 认证用户名列表（若启用需与采集地址数量相同，默认值：空）。

  • open_metrics.httpPasswords

    设置 Basic 认证密码列表（若启用需与采集地址数量相同，默认值：空）。

  • open_metrics.httpBearerTokenStrings

    配置 Bearer Token 认证列表（若启用需与采集地址数量相同，默认值：空）。

  • open_metrics.caCertFiles

    指定根证书文件路径列表（若启用需与采集地址数量相同，默认值：空）。

  • open_metrics.certFiles

    设置客户端证书文件路径列表（若启用需与采集地址数量相同，默认值：空）。

  • open_metrics.keyFiles

    配置客户端证书密钥文件路径列表（若启用需与采集地址数量相同，默认值：空）。

  • open_metrics.insecureSkipVerify

    是否跳过 HTTPS 证书验证（默认值：true）。

  • open_metrics.gatherDurationSeconds

    设置采集间隔时间（秒）（默认值：[5]，需与采集地址数量相同）。

  • open_metrics.ttl

    定义数据表的生存时间（秒）（0 表示无超时，若启用需与采集地址数量相同，默认值：空）。

  • open_metrics.ignoreTimestamp

    是否忽略采集数据中的时间戳（若忽略则使用采集时刻时间戳，默认值：false）。

node_exporter 配置参数​

  • node_exporter.enable

    是否启用 node_exporter 数据采集（默认值：false）。

  • node_exporter.db

    指定 node_exporter 数据写入的数据库名称（默认值："node_exporter"）。

  • node_exporter.urls

    配置 node_exporter 服务地址（默认值：["http://localhost:9100"]）。

  • node_exporter.gatherDuration

    设置数据采集间隔时间（默认值：5s）。

  • node_exporter.responseTimeout

    配置请求超时时间（默认值：5s）。

  • node_exporter.user

    设置数据库连接用户名（默认值："root"）。

  • node_exporter.password

    设置数据库连接密码（默认值："taosdata"）。

  • node_exporter.ttl

    配置采集数据的生存时间（默认值：0，表示无超时）。

  • node_exporter.httpUsername

    配置 HTTP 基本认证用户名（可选）。

  • node_exporter.httpPassword

    配置 HTTP 基本认证密码（可选）。

  • node_exporter.httpBearerTokenString

    配置 HTTP Bearer Token 认证（可选）。

  • node_exporter.insecureSkipVerify

    是否跳过 SSL 证书验证（默认值：true）。

  • node_exporter.certFile

    指定客户端证书文件路径（可选）。

  • node_exporter.keyFile

    指定客户端证书密钥文件路径（可选）。

  • node_exporter.caCertFile

    指定 CA 证书文件路径（可选）。

上报指标配置​

taosAdapter 将指标上报到 taosKeeper 进行统一管理，参数如下：

  • uploadKeeper.enable

    是否启用向 taoKeeper 上报监控指标（默认值：true）。

  • uploadKeeper.url

    配置 taosKeeper 服务地址（默认值：http://127.0.0.1:6043/adapter_report ）。

  • uploadKeeper.interval

    设置上报间隔时间（默认值：15s）。

  • uploadKeeper.timeout

    配置上报超时时间（默认值：5s）。

  • uploadKeeper.retryTimes

    设置失败重试次数（默认值：3）。

  • uploadKeeper.retryInterval

    配置重试间隔时间（默认值：5s）。

查询请求并发限制配置​

从 3.3.6.29/3.3.8.3 版本开始，taosAdapter 支持配置查询请求的并发限制，防止因过多的并发查询请求导致系统资源耗尽。 当启用该功能后，taosAdapter 会根据配置的并发限制数来控制同时处理的查询请求数量，超过限制的请求将进入等待，直到有可用的处理资源为止。

当等待时间超过配置的超时时间或等待数超过配置的最大等待请求数时，taosAdapter 将直接返回错误响应，提示用户请求过多。 RESTful 请求将返回 HTTP 状态码 503，WebSocket 请求将返回错误码 0xFFFE。

该配置会影响以下接口：

  • RESTful 接口
  • WebSocket SQL 执行接口
参数说明​
  • request.queryLimitEnable
    • 设置为 true 时：启用查询请求并发限制功能。
    • 设置为 false 时：禁用查询请求并发限制功能（默认值）。
  • request.default.queryLimit
    • 设置默认的查询请求并发限制数（默认值：0，表示无限制）。
  • request.default.queryWaitTimeout
    • 限制并发请求超过限制后的等待时间（单位：秒），请求等待执行超时后将直接返回错误，默认值：900。
  • request.default.queryMaxWait
    • 限制并发请求超过限制后的最大等待请求数，超过该数量的请求将直接返回错误，默认值：0，表示不限制。
  • request.excludeQueryLimitSql
    • 配置不受并发限制影响的 SQL 列表，必须以 select 开头，SQL 忽略大小写。
  • request.excludeQueryLimitSqlRegex
    • 配置不受并发限制影响的 SQL 正则表达式列表。
针对每个用户可单独设置​

仅支持配置文件进行设置：

  • request.users.<username>.queryLimit
    • 设置指定用户的查询请求并发限制数，优先级高于默认设置。
  • request.users.<username>.queryWaitTimeout
    • 限制并发请求超过限制后的等待时间（单位：秒），请求等待执行超时后将直接返回错误，优先级高于默认设置。
  • request.users.<username>.queryMaxWait
    • 限制并发请求超过限制后的最大等待请求数，超过该数量的请求将直接返回错误，优先级高于默认设置。
示例说明​
[request]
queryLimitEnable = true
excludeQueryLimitSql = ["select 1","select server_version()"]
excludeQueryLimitSqlRegex = ['(?i)^select\s+.*from\s+information_schema.*']

[request.default]
queryLimit = 200
queryWaitTimeout = 900
queryMaxWait = 0

[request.users.root]
queryLimit = 100
queryWaitTimeout = 200
queryMaxWait = 10
  • queryLimitEnable = true 启用了查询请求并发限制功能。
  • excludeQueryLimitSql = ["select 1","select server_version()"] 排除了两个常用做 ping 的查询 SQL。
  • excludeQueryLimitSqlRegex = ['(?i)^select\s+.*from\s+information_schema.*'] 排除了所有查询 information_schema 这个数据库的 SQL。
  • request.default 配置了默认的查询请求并发限制数为 200，等待超时为 900 秒，最大等待请求数为 0（无限制）。
  • request.users.root 配置了用户 root 的查询请求并发限制数为 100，等待超时为 200 秒，最大等待请求数为 10。

当用户 root 发起查询请求时，taosAdapter 会根据上述配置进行并发限制处理。当查询请求超过 100 个时，后续请求将进入等待，直到有可用的资源为止。如果等待时间超过 200 秒或等待请求数超过 10 个，taosAdapter 将直接返回错误响应。

当其他用户发起查询请求时，将使用默认的并发限制配置进行处理。每个用户配置独立，不共享 request.default 的并发限制。比如用户 user1 发起 200 个并发查询请求时，用户 user2 也可以同时发起 200 个并发查询请求而不会阻塞。

禁用查询 SQL 配置​

从 3.3.6.34/3.4.0.0 版本开始，taosAdapter 支持通过配置禁用特定的查询 SQL，防止执行某些不安全或资源消耗过大的查询操作。 当启用该功能后，taosAdapter 会检查每个非 insert（忽略大小写）开头的 SQL，如果匹配到配置的禁用正则表达式，则直接返回错误响应，提示用户该查询被禁用。 当被禁用的查询 SQL 被匹配到时，RESTful 接口将返回 HTTP 状态码 403，WebSocket 接口将返回错误码 0xFFFD， taosAdapter 将打印警告日志，包含此 SQL 的来源等内容，例如：

reject sql, client_ip:192.168.1.98, port:59912, user:root, app:test_app, reject_regex:(?i)^drop\s+table\s+.*, sql:DROP taBle testdb.stb

该配置会影响以下接口：

  • RESTful 接口
  • WebSocket SQL 执行接口
参数说明​
  • rejectQuerySqlRegex
    • 配置禁用查询 SQL 的正则表达式列表。支持 Goole RE2 语法。
    • 默认值：空列表，表示不禁用任何查询 SQL。
示例说明​
rejectQuerySqlRegex = ['(?i)^drop\s+database\s+.*','(?i)^drop\s+table\s+.*','(?i)^alter\s+table\s+.*']

rejectQuerySqlRegex = ['(?i)^drop\s+database\s+.*','(?i)^drop\s+table\s+.*','(?i)^alter\s+table\s+.*'] 禁用了所有 drop database、drop table 和 alter table 的查询操作，忽略大小写。

环境变量​

配置项与环境变量对应如下表：

详细信息
参数环境变量
collectd.dbTAOS_ADAPTER_COLLECTD_DB
collectd.enableTAOS_ADAPTER_COLLECTD_ENABLE
collectd.passwordTAOS_ADAPTER_COLLECTD_PASSWORD
collectd.portTAOS_ADAPTER_COLLECTD_PORT
collectd.ttlTAOS_ADAPTER_COLLECTD_TTL
collectd.userTAOS_ADAPTER_COLLECTD_USER
collectd.workerTAOS_ADAPTER_COLLECTD_WORKER
cors.allowAllOriginsTAOS_ADAPTER_CORS_ALLOW_ALL_ORIGINS
cors.allowCredentialsTAOS_ADAPTER_CORS_ALLOW_Credentials
cors.allowHeadersTAOS_ADAPTER_ALLOW_HEADERS
cors.allowOriginsTAOS_ADAPTER_ALLOW_ORIGINS
cors.allowWebSocketsTAOS_ADAPTER_CORS_ALLOW_WebSockets
cors.exposeHeadersTAOS_ADAPTER_Expose_Headers
debugTAOS_ADAPTER_DEBUG
httpCodeServerErrorTAOS_ADAPTER_HTTP_CODE_SERVER_ERROR
influxdb.enableTAOS_ADAPTER_INFLUXDB_ENABLE
instanceIdTAOS_ADAPTER_INSTANCE_ID
log.compressTAOS_ADAPTER_LOG_COMPRESS
log.enableRecordHttpSqlTAOS_ADAPTER_LOG_ENABLE_RECORD_HTTP_SQL
log.enableSqlToCsvLoggingTAOS_ADAPTER_LOG_ENABLE_SQL_TO_CSV_LOGGING
log.keepDaysTAOS_ADAPTER_LOG_KEEP_DAYS
log.levelTAOS_ADAPTER_LOG_LEVEL
log.pathTAOS_ADAPTER_LOG_PATH
log.reservedDiskSizeTAOS_ADAPTER_LOG_RESERVED_DISK_SIZE
log.rotationCountTAOS_ADAPTER_LOG_ROTATION_COUNT
log.rotationSizeTAOS_ADAPTER_LOG_ROTATION_SIZE
log.rotationTimeTAOS_ADAPTER_LOG_ROTATION_TIME
log.sqlRotationCountTAOS_ADAPTER_LOG_SQL_ROTATION_COUNT
log.sqlRotationSizeTAOS_ADAPTER_LOG_SQL_ROTATION_SIZE
log.sqlRotationTimeTAOS_ADAPTER_LOG_SQL_ROTATION_TIME
logLevelTAOS_ADAPTER_LOG_LEVEL
maxAsyncConcurrentLimitTAOS_ADAPTER_MAX_ASYNC_CONCURRENT_LIMIT
maxSyncConcurrentLimitTAOS_ADAPTER_MAX_SYNC_CONCURRENT_LIMIT
monitor.collectDurationTAOS_ADAPTER_MONITOR_COLLECT_DURATION
monitor.disableTAOS_ADAPTER_MONITOR_DISABLE
monitor.identityTAOS_ADAPTER_MONITOR_IDENTITY
monitor.incgroupTAOS_ADAPTER_MONITOR_INCGROUP
monitor.pauseAllMemoryThresholdTAOS_ADAPTER_MONITOR_PAUSE_ALL_MEMORY_THRESHOLD
monitor.pauseQueryMemoryThresholdTAOS_ADAPTER_MONITOR_PAUSE_QUERY_MEMORY_THRESHOLD
node_exporter.caCertFileTAOS_ADAPTER_NODE_EXPORTER_CA_CERT_FILE
node_exporter.certFileTAOS_ADAPTER_NODE_EXPORTER_CERT_FILE
node_exporter.dbTAOS_ADAPTER_NODE_EXPORTER_DB
node_exporter.enableTAOS_ADAPTER_NODE_EXPORTER_ENABLE
node_exporter.gatherDurationTAOS_ADAPTER_NODE_EXPORTER_GATHER_DURATION
node_exporter.httpBearerTokenStringTAOS_ADAPTER_NODE_EXPORTER_HTTP_BEARER_TOKEN_STRING
node_exporter.httpPasswordTAOS_ADAPTER_NODE_EXPORTER_HTTP_PASSWORD
node_exporter.httpUsernameTAOS_ADAPTER_NODE_EXPORTER_HTTP_USERNAME
node_exporter.insecureSkipVerifyTAOS_ADAPTER_NODE_EXPORTER_INSECURE_SKIP_VERIFY
node_exporter.keyFileTAOS_ADAPTER_NODE_EXPORTER_KEY_FILE
node_exporter.passwordTAOS_ADAPTER_NODE_EXPORTER_PASSWORD
node_exporter.responseTimeoutTAOS_ADAPTER_NODE_EXPORTER_RESPONSE_TIMEOUT
node_exporter.ttlTAOS_ADAPTER_NODE_EXPORTER_TTL
node_exporter.urlsTAOS_ADAPTER_NODE_EXPORTER_URLS
node_exporter.userTAOS_ADAPTER_NODE_EXPORTER_USER
open_metrics.enableTAOS_ADAPTER_OPEN_METRICS_ENABLE
open_metrics.userTAOS_ADAPTER_OPEN_METRICS_USER
open_metrics.passwordTAOS_ADAPTER_OPEN_METRICS_PASSWORD
open_metrics.urlsTAOS_ADAPTER_OPEN_METRICS_URLS
open_metrics.dbsTAOS_ADAPTER_OPEN_METRICS_DBS
open_metrics.responseTimeoutSecondsTAOS_ADAPTER_OPEN_METRICS_RESPONSE_TIMEOUT_SECONDS
open_metrics.httpUsernamesTAOS_ADAPTER_OPEN_METRICS_HTTP_USERNAMES
open_metrics.httpPasswordsTAOS_ADAPTER_OPEN_METRICS_HTTP_PASSWORDS
open_metrics.httpBearerTokenStringsTAOS_ADAPTER_OPEN_METRICS_HTTP_BEARER_TOKEN_STRINGS
open_metrics.caCertFilesTAOS_ADAPTER_OPEN_METRICS_CA_CERT_FILES
open_metrics.certFilesTAOS_ADAPTER_OPEN_METRICS_CERT_FILES
open_metrics.keyFilesTAOS_ADAPTER_OPEN_METRICS_KEY_FILES
open_metrics.insecureSkipVerifyTAOS_ADAPTER_OPEN_METRICS_INSECURE_SKIP_VERIFY
open_metrics.gatherDurationSecondsTAOS_ADAPTER_OPEN_METRICS_GATHER_DURATION_SECONDS
open_metrics.ignoreTimestampTAOS_ADAPTER_OPEN_METRICS_IGNORE_TIMESTAMP
open_metrics.ttlTAOS_ADAPTER_OPEN_METRICS_TTL
opentsdb.enableTAOS_ADAPTER_OPENTSDB_ENABLE
opentsdb_telnet.batchSizeTAOS_ADAPTER_OPENTSDB_TELNET_BATCH_SIZE
opentsdb_telnet.dbsTAOS_ADAPTER_OPENTSDB_TELNET_DBS
opentsdb_telnet.enableTAOS_ADAPTER_OPENTSDB_TELNET_ENABLE
opentsdb_telnet.flushIntervalTAOS_ADAPTER_OPENTSDB_TELNET_FLUSH_INTERVAL
opentsdb_telnet.maxTCPConnectionsTAOS_ADAPTER_OPENTSDB_TELNET_MAX_TCP_CONNECTIONS
opentsdb_telnet.passwordTAOS_ADAPTER_OPENTSDB_TELNET_PASSWORD
opentsdb_telnet.portsTAOS_ADAPTER_OPENTSDB_TELNET_PORTS
opentsdb_telnet.tcpKeepAliveTAOS_ADAPTER_OPENTSDB_TELNET_TCP_KEEP_ALIVE
opentsdb_telnet.ttlTAOS_ADAPTER_OPENTSDB_TELNET_TTL
opentsdb_telnet.userTAOS_ADAPTER_OPENTSDB_TELNET_USER
pool.idleTimeoutTAOS_ADAPTER_POOL_IDLE_TIMEOUT
pool.maxConnectTAOS_ADAPTER_POOL_MAX_CONNECT
pool.maxIdleTAOS_ADAPTER_POOL_MAX_IDLE
pool.maxWaitTAOS_ADAPTER_POOL_MAX_WAIT
pool.waitTimeoutTAOS_ADAPTER_POOL_WAIT_TIMEOUT
P, portTAOS_ADAPTER_PORT
prometheus.enableTAOS_ADAPTER_PROMETHEUS_ENABLE
request.default.queryLimitTAOS_ADAPTER_REQUEST_DEFAULT_QUERY_LIMIT
request.default.queryMaxWaitTAOS_ADAPTER_REQUEST_DEFAULT_QUERY_MAX_WAIT
request.default.queryWaitTimeoutTAOS_ADAPTER_REQUEST_DEFAULT_QUERY_WAIT_TIMEOUT
request.excludeQueryLimitSqlTAOS_ADAPTER_REQUEST_EXCLUDE_QUERY_LIMIT_SQL
request.excludeQueryLimitSqlRegexTAOS_ADAPTER_REQUEST_EXCLUDE_QUERY_LIMIT_SQL_REGEX
request.queryLimitEnableTAOS_ADAPTER_REQUEST_QUERY_LIMIT_ENABLE
restfulRowLimitTAOS_ADAPTER_RESTFUL_ROW_LIMIT
smlAutoCreateDBTAOS_ADAPTER_SML_AUTO_CREATE_DB
statsd.allowPendingMessagesTAOS_ADAPTER_STATSD_ALLOW_PENDING_MESSAGES
statsd.dbTAOS_ADAPTER_STATSD_DB
statsd.deleteCountersTAOS_ADAPTER_STATSD_DELETE_COUNTERS
statsd.deleteGaugesTAOS_ADAPTER_STATSD_DELETE_GAUGES
statsd.deleteSetsTAOS_ADAPTER_STATSD_DELETE_SETS
statsd.deleteTimingsTAOS_ADAPTER_STATSD_DELETE_TIMINGS
statsd.enableTAOS_ADAPTER_STATSD_ENABLE
statsd.gatherIntervalTAOS_ADAPTER_STATSD_GATHER_INTERVAL
statsd.maxTCPConnectionsTAOS_ADAPTER_STATSD_MAX_TCP_CONNECTIONS
statsd.passwordTAOS_ADAPTER_STATSD_PASSWORD
statsd.portTAOS_ADAPTER_STATSD_PORT
statsd.protocolTAOS_ADAPTER_STATSD_PROTOCOL
statsd.tcpKeepAliveTAOS_ADAPTER_STATSD_TCP_KEEP_ALIVE
statsd.ttlTAOS_ADAPTER_STATSD_TTL
statsd.userTAOS_ADAPTER_STATSD_USER
statsd.workerTAOS_ADAPTER_STATSD_WORKER
taosConfigDirTAOS_ADAPTER_TAOS_CONFIG_FILE
uploadKeeper.enableTAOS_ADAPTER_UPLOAD_KEEPER_ENABLE
uploadKeeper.intervalTAOS_ADAPTER_UPLOAD_KEEPER_INTERVAL
uploadKeeper.retryIntervalTAOS_ADAPTER_UPLOAD_KEEPER_RETRY_INTERVAL
uploadKeeper.retryTimesTAOS_ADAPTER_UPLOAD_KEEPER_RETRY_TIMES
uploadKeeper.timeoutTAOS_ADAPTER_UPLOAD_KEEPER_TIMEOUT
uploadKeeper.urlTAOS_ADAPTER_UPLOAD_KEEPER_URL

服务管理​

启动/停止 taosAdapter​

在 Linux 系统上 taosAdapter 服务默认由 systemd 管理。使用命令 systemctl start taosadapter 可以启动 taosAdapter 服务。使用命令 systemctl stop taosadapter 可以停止 taosAdapter 服务。使用命令 systemctl status taosadapter 来检查 taosAdapter 运行状态。

升级 taosAdapter​

taosAdapter 和 TDengine TSDB server 需要使用相同版本。请通过升级 TDengine TSDB server 来升级 taosAdapter。 与 taosd 分离部署的 taosAdapter 必须通过升级其所在服务器的 TDengine TSDB server 才能得到升级。

移除 taosAdapter​

使用命令 rmtaos 可以移除包括 taosAdapter 在内的 TDengine TSDB server 软件。

动态配置​

动态修改日志级别​

从 3.3.5.0 版本 开始，taosAdapter 支持通过 HTTP 接口动态修改日志级别。用户可以通过发送 HTTP PUT 请求到 /config 接口，动态调整日志级别。该接口的验证方式与 /rest/sql 接口相同，请求体中需传入 JSON 格式的配置项键值对。

以下是通过 curl 命令将日志级别设置为 debug 的示例：

curl --location --request PUT 'http://127.0.0.1:6041/config' \
-u root:taosdata \
--data '{"log.level": "debug"}'

监听配置文件变更​

从 3.3.6.34/3.4.0.0 版本开始，taosAdapter 支持监听配置文件的变更，支持以下配置自动更新

  • log.level 日志级别参数
  • rejectQuerySqlRegex 拒绝查询 SQL 列表配置参数

IPv6 支持​

taosAdapter 自 3.3.6.13 版本起支持 IPv6，用户无需进行任何额外配置。 taosAdapter 将自动检测系统的 IPv6 支持情况，并在系统支持时自动启用 IPv6，且同时监听 IPv4 和 IPv6 地址。

记录 SQL 到 CSV 文件​

taosAdapter 支持将 SQL 请求记录到 CSV 文件中。用户可以通过配置参数 log.enableSqlToCsvLogging 来启用此功能，或使用 HTTP 请求动态开启和关闭。

配置参数​

  1. 新增配置项 log.enableSqlToCsvLogging 布尔值，默认为 false，表示是否开启 sql 记录到 csv 文件。设置为 true 将开启 sql 记录到 csv 文件任务，开始记录时间为启动时间，结束时间为 2300-01-01 00:00:00。
  2. 文件命名与日志相同规则：taosadapterSql_{instanceId}_{yyyyMMdd}.csv[.index]
    • instanceId：taosAdapter 实例 ID，可通过 instanceId 参数设置。
    • yyyyMMdd：日期，格式为年月日。
    • index：如果存在多个文件，则会在文件名后添加数字后缀。
  3. 保留空间、文件切割、保存路径等使用 log 已存在参数：
    • log.path：保存路径。
    • log.keepDays ：保留天数。
    • log.rotationCount：最多保留份数。
    • log.rotationSize：单个文件最大大小。
    • log.compress：是否启用压缩。
    • log.reservedDiskSize：保留硬盘空间大小。

动态开启​

通过发送 HTTP POST 请求到 /record_sql 接口来动态开启记录，使用与 /rest/sql 相同的鉴权方式，样例如下：

curl --location --request POST 'http://127.0.0.1:6041/record_sql' \
-u root:taosdata \
--data '{"start_time":"2025-07-15 17:00:00","end_time":"2025-07-15 18:00:00","location":"Asia/Shanghai"}'

支持的参数项如下：

  • start_time：[可选参数] 开始采集的时间，格式为 yyyy-MM-dd HH:mm:ss，如果不设置则使用当前时间。
  • end_time：[可选参数] 结束采集的时间，格式为 yyyy-MM-dd HH:mm:ss，如果不设置则使用 2300-01-01 00:00:00。
  • location：[可选参数] 解析采集开始和结束时间使用的时区信息，如果不设置则使用 taosAdapter 所在服务器时区。时区使用 IANA 格式，例如：Asia/Shanghai。

如果所有参数都使用默认值则可以不传 data，样例如下：

curl --location --request POST 'http://127.0.0.1:6041/record_sql' \
-u root:taosdata

成功返回 HTTP code 200，返回结构如下

{"code":0,"desc":""}

失败返回 HTTP code 非 200，返回 json 结构如下，code 非 0，desc 描述错误内容

{"code":65535,"desc":"unmarshal json error"}

动态关闭​

通过发送 HTTP DELETE 请求到 /record_sql 接口来关闭，使用与 /rest/sql 相同的鉴权方式，样例如下：

curl --location --request DELETE 'http://127.0.0.1:6041/record_sql' \
-u root:taosdata

成功返回 HTTP code 200

  1. 任务存在时返回如下
{
        "code": 0,
        "message": "",
        "start_time": "2025-07-23 17:00:00",
        "end_time": "2025-07-23 18:00:00"
}
  • start_time 为取消任务配置的启动时间，时区为 taosAdapter 所在服务器时区。
  • end_time 为取消任务配置的结束时间，时区为 taosAdapter 所在服务器时区。
  1. 任务不存在时返回如下
{
        "code": 0,
        "message": ""
}

查询状态​

通过发送 HTTP GET 请求到 /record_sql 接口来查询任务，使用与 /rest/sql 相同的鉴权方式，样例如下：

curl --location 'http://127.0.0.1:6041/record_sql' \
-u root:taosdata

成功返回 HTTP code 200，返回样例如下

{
        "code": 0,
        "desc": "",
        "exists": true,
        "running": true,
        "start_time": "2025-07-16 17:00:00",
        "end_time": "2025-07-16 18:00:00",
        "current_concurrent": 100
}
  • code：错误码，0 为成功。
  • desc：错误信息，成功为空字符串。
  • exists：任务是否存在。
  • running：任务是否在运行期。
  • start_time：开始时间，时区为 taosAdapter 所在服务器时区。
  • end_time：结束时间，时区为 taosAdapter 所在服务器时区。
  • current_concurrent：当前 SQL 记录并发度。

记录格式​

在 taos_free_result 执行之前和任务结束（到达结束时间或主动关闭）时写入记录。 记录以 CSV 格式存储，无表头，每行记录包含以下字段：

  1. TS：打印日志时间，格式为 yyyy-MM-dd HH:mm:ss.SSSSSS，时区为 taosAdapter 所在服务器时区。
  2. SQL：执行的 SQL，按照 CSV 标准不处理 SQL 中的换行符，当存在特殊字符（\n、\r、"）时使用双引号包裹，包含特殊字符时无法直接复制 SQL 使用，例如：

原始 sql 为：

 select * from t1
 where c1 = "ab"

csv 文件中的记录为：

"select * from t1
where c1 = ""ab"""
  1. IP：客户端 IP。
  2. User：执行此 SQL 的用户名。
  3. ConnType：连接类型（HTTP、WS）。
  4. QID：请求 ID，保存为 16 进制。
  5. ReceiveTime：接收到 SQL 的时间，格式为 yyyy-MM-dd HH:mm:ss.SSSSSS，时区为 taosAdapter 所在服务器时区。
  6. FreeTime：SQL 释放的时间，格式为 yyyy-MM-dd HH:mm:ss.SSSSSS，时区为 taosAdapter 所在服务器时区。
  7. QueryDuration(us)：执行 taos_query_a 到回调完成时间消耗，单位微秒。
  8. FetchDuration(us)：多次执行 taos_fetch_raw_block_a 到回调完成的时间消耗累加值，单位微秒。
  9. GetConnDuration(us)：HTTP 请求从连接池获取连接的时间消耗，单位微秒。
  10. TotalDuration(us)：SQL 请求完成总时间，单位微秒，当 SQL 正常完成时为（SQL 释放的时间 - 接收到 SQL 的时间），当任务结束未完成时为（当前时间 - 接收到 SQL 的时间）。
  11. SourcePort：客户端端口。（3.3.6.26 及以上 / 3.3.8.0 及以上版本添加）
  12. AppName：客户应用 AppName。（3.3.6.26 及以上 / 3.3.8.0 及以上版本添加）

样例如下：

2025-07-23 17:10:08.724775,show databases,127.0.0.1,root,http,0x2000000000000008,2025-07-23 17:10:08.707741,2025-07-23 17:10:08.724775,14191,965,1706,17034,53600,jdbc_test_app

taosAdapter 监控指标​

taosAdapter 目前仅采集 RESTful/WebSocket 相关请求的监控指标，其他接口暂无监控指标。

taosAdapter 将监控指标上报给 taosKeeper，这些监控指标会被 taosKeeper 写入监控数据库，默认是 log 库，可以在 taosKeeper 配置文件中修改。以下是这些监控指标的详细介绍。

adapter_requests 表记录 taosAdapter 监控数据：

详细信息
fieldtypeis_tagcomment
tsTIMESTAMP数据采集时间戳
totalINT UNSIGNED总请求数
queryINT UNSIGNED查询请求数
writeINT UNSIGNED写入请求数
otherINT UNSIGNED其他请求数
in_processINT UNSIGNED正在处理请求数
successINT UNSIGNED成功请求数
failINT UNSIGNED失败请求数
query_successINT UNSIGNED查询成功请求数
query_failINT UNSIGNED查询失败请求数
write_successINT UNSIGNED写入成功请求数
write_failINT UNSIGNED写入失败请求数
other_successINT UNSIGNED其他成功请求数
other_failINT UNSIGNED其他失败请求数
query_in_processINT UNSIGNED正在处理查询请求数
write_in_processINT UNSIGNED正在处理写入请求数
endpointVARCHARTAG请求端点
req_typeTINYINT UNSIGNEDTAG请求类型：0 为 REST，1 为 WebSocket

adapter_status 表记录 taosAdapter 状态数据：

详细信息
fieldtypeis_tagcomment
_tsTIMESTAMP数据采集时间戳
go_heap_sysDOUBLEGo 运行时系统分配的堆内存大小（字节）
go_heap_inuseDOUBLEGo 运行时正在使用的堆内存大小（字节）
go_stack_sysDOUBLEGo 运行时系统分配的栈内存大小（字节）
go_stack_inuseDOUBLEGo 运行时正在使用的栈内存大小（字节）
rssDOUBLE进程实际占用的物理内存大小（字节）
ws_query_connDOUBLE/rest/ws 接口当前 WebSocket 连接数
ws_stmt_connDOUBLE/rest/stmt 接口当前 WebSocket 连接数
ws_sml_connDOUBLE/rest/schemaless 接口当前 WebSocket 连接数
ws_ws_connDOUBLE/ws 接口当前 WebSocket 连接数
ws_tmq_connDOUBLE/rest/tmq 接口当前 WebSocket 连接数
async_c_limitDOUBLEC 同步接口并发限制总数
async_c_inflightDOUBLEC 同步接口当前并发数
sync_c_limitDOUBLEC 异步接口并发限制总数
sync_c_inflightDOUBLEC 异步接口当前并发数
ws_query_conn_incDOUBLE/rest/ws 接口新增连接（3.3.6.10 及以上）
ws_query_conn_decDOUBLE/rest/ws 接口减少连接（3.3.6.10 及以上）
ws_stmt_conn_incDOUBLE/rest/stmt 接口新增连接（3.3.6.10 及以上）
ws_stmt_conn_decDOUBLE/rest/stmt 接口减少连接（3.3.6.10 及以上）
ws_sml_conn_incDOUBLE/rest/schemaless 接口新增连接（3.3.6.10 及以上）
ws_sml_conn_decDOUBLE/rest/schemaless 接口减少连接（3.3.6.10 及以上）
ws_ws_conn_incDOUBLE/ws 接口新增连接（3.3.6.10 及以上）
ws_ws_conn_decDOUBLE/ws 接口减少连接（3.3.6.10 及以上）
ws_tmq_conn_incDOUBLE/rest/tmq 接口新增连接（3.3.6.10 及以上）
ws_tmq_conn_decDOUBLE/rest/tmq 接口减少连接（3.3.6.10 及以上）
ws_query_sql_result_countDOUBLE/rest/ws 接口当前持有 SQL 查询结果数量（3.3.6.10 及以上）
ws_stmt_stmt_countDOUBLE/rest/stmt 接口当前持有 stmt 数量（3.3.6.10 及以上）
ws_ws_sql_result_countDOUBLE/ws 接口当前持有 SQL 查询结果数量（3.3.6.10 及以上）
ws_ws_stmt_countDOUBLE/ws 接口当前持有 stmt 数量（3.3.6.10 及以上）
ws_ws_stmt2_countDOUBLE/ws 接口当前持有 stmt2 数量（3.3.6.10 及以上）
cpu_percentDOUBLEtaosAdapter 的 CPU 占用百分比（v3.3.6.24 及以上 /v3.3.7.7 及以上）
endpointNCHARTAG请求端点

adapter_conn_pool 表记录 taosAdapter 连接池监控数据：

详细信息
fieldtypeis_tagcomment
_tsTIMESTAMP数据采集时间戳
conn_pool_totalDOUBLE连接池的最大连接数限制
conn_pool_in_useDOUBLE连接池当前正在使用的连接数
endpointNCHARTAG请求端点
userNCHARTAG连接池所属的用户名

从 3.3.6.10 版本开始新增 adapter_c_interface 表记录 taosAdapter 调用 C 接口次数数据：

详细信息
fieldtypeis_tagcomment
_tsTIMESTAMP数据采集时间戳
taos_connect_totalDOUBLE尝试建立连接的总次数
taos_connect_successDOUBLE成功建立连接的次数
taos_connect_failDOUBLE建立连接失败的次数
taos_close_totalDOUBLE尝试关闭连接的总次数
taos_close_successDOUBLE成功关闭连接的次数
taos_schemaless_insert_totalDOUBLEschemaless 插入操作的总次数
taos_schemaless_insert_successDOUBLEschemaless 插入成功的次数
taos_schemaless_insert_failDOUBLEschemaless 插入失败的次数
taos_schemaless_free_result_totalDOUBLEschemaless 释放结果集的总次数
taos_schemaless_free_result_successDOUBLEschemaless 成功释放结果集的次数
taos_query_totalDOUBLE执行同步 SQL 的总次数
taos_query_successDOUBLE执行同步 SQL 成功的次数
taos_query_failDOUBLE执行同步 SQL 失败的次数
taos_query_free_result_totalDOUBLE释放同步 SQL 结果集的总次数
taos_query_free_result_successDOUBLE成功释放同步 SQL 结果集的次数
taos_query_a_with_reqid_totalDOUBLE带请求 ID 的异步 SQL 总次数
taos_query_a_with_reqid_successDOUBLE带请求 ID 的异步 SQL 成功次数
taos_query_a_with_reqid_callback_totalDOUBLE带请求 ID 的异步 SQL 回调总次数
taos_query_a_with_reqid_callback_successDOUBLE带请求 ID 的异步 SQL 回调成功次数
taos_query_a_with_reqid_callback_failDOUBLE带请求 ID 的异步 SQL 回调失败次数
taos_query_a_free_result_totalDOUBLE异步 SQL 释放结果集的总次数
taos_query_a_free_result_successDOUBLE异步 SQL 成功释放结果集的次数
tmq_consumer_poll_result_totalDOUBLE消费者 poll 有数据的总次数
tmq_free_result_totalDOUBLE释放 TMQ 数据的总次数
tmq_free_result_successDOUBLE成功释放 TMQ 数据的次数
taos_stmt2_init_totalDOUBLEstmt2 初始化的总次数
taos_stmt2_init_successDOUBLEstmt2 初始化成功的次数
taos_stmt2_init_failDOUBLEstmt2 初始化失败的次数
taos_stmt2_close_totalDOUBLEstmt2 关闭的总次数
taos_stmt2_close_successDOUBLEstmt2 关闭成功的次数
taos_stmt2_close_failDOUBLEstmt2 关闭失败的次数
taos_stmt2_get_fields_totalDOUBLEstmt2 获取字段的总次数
taos_stmt2_get_fields_successDOUBLEstmt2 成功获取字段的次数
taos_stmt2_get_fields_failDOUBLEstmt2 获取字段失败的次数
taos_stmt2_free_fields_totalDOUBLEstmt2 释放字段的总次数
taos_stmt2_free_fields_successDOUBLEstmt2 成功释放字段的次数
taos_stmt_init_with_reqid_totalDOUBLE带请求 ID 的 stmt 初始化总次数
taos_stmt_init_with_reqid_successDOUBLE带请求 ID 的 stmt 初始化成功次数
taos_stmt_init_with_reqid_failDOUBLE带请求 ID 的 stmt 初始化失败次数
taos_stmt_close_totalDOUBLEstmt 关闭的总次数
taos_stmt_close_successDOUBLEstmt 关闭成功的次数
taos_stmt_close_failDOUBLEstmt 关闭失败的次数
taos_stmt_get_tag_fields_totalDOUBLEstmt 获取 tag 字段的总次数
taos_stmt_get_tag_fields_successDOUBLEstmt 成功获取 tag 字段的次数
taos_stmt_get_tag_fields_failDOUBLEstmt 获取 tag 字段失败的次数
taos_stmt_get_col_fields_totalDOUBLEstmt 获取列字段的总次数
taos_stmt_get_col_fields_successDOUBLEstmt 成功获取列字段的次数
taos_stmt_get_col_fields_failDOUBLEstmt 获取列字段失败的次数
taos_stmt_reclaim_fields_totalDOUBLEstmt 释放字段的总次数
taos_stmt_reclaim_fields_successDOUBLEstmt 成功释放字段的次数
tmq_get_json_meta_totalDOUBLEtmq 获取 JSON 元数据的总次数
tmq_get_json_meta_successDOUBLEtmq 成功获取 JSON 元数据的次数
tmq_free_json_meta_totalDOUBLEtmq 释放 JSON 元数据的总次数
tmq_free_json_meta_successDOUBLEtmq 成功释放 JSON 元数据的次数
taos_fetch_whitelist_a_totalDOUBLE异步获取白名单的总次数
taos_fetch_whitelist_a_successDOUBLE异步成功获取白名单的次数
taos_fetch_whitelist_a_callback_totalDOUBLE异步获取白名单回调总次数
taos_fetch_whitelist_a_callback_successDOUBLE异步成功获取白名单回调次数
taos_fetch_whitelist_a_callback_failDOUBLE异步获取白名单回调失败次数
taos_fetch_rows_a_totalDOUBLE异步获取行的总次数
taos_fetch_rows_a_successDOUBLE异步成功获取行的次数
taos_fetch_rows_a_callback_totalDOUBLE异步获取行回调总次数
taos_fetch_rows_a_callback_successDOUBLE异步成功获取行回调次数
taos_fetch_rows_a_callback_failDOUBLE异步获取行回调失败次数
taos_fetch_raw_block_a_totalDOUBLE异步获取原始块的总次数
taos_fetch_raw_block_a_successDOUBLE异步成功获取原始块的次数
taos_fetch_raw_block_a_callback_totalDOUBLE异步获取原始块回调总次数
taos_fetch_raw_block_a_callback_successDOUBLE异步成功获取原始块回调次数
taos_fetch_raw_block_a_callback_failDOUBLE异步获取原始块回调失败次数
tmq_get_raw_totalDOUBLE获取原始数据的总次数
tmq_get_raw_successDOUBLE成功获取原始数据的次数
tmq_get_raw_failDOUBLE获取原始数据失败的次数
tmq_free_raw_totalDOUBLE释放原始数据的总次数
tmq_free_raw_successDOUBLE成功释放原始数据的次数
tmq_consumer_new_totalDOUBLE创建新消费者的总次数
tmq_consumer_new_successDOUBLE成功创建新消费者的次数
tmq_consumer_new_failDOUBLE创建新消费者失败的次数
tmq_consumer_close_totalDOUBLE关闭消费者的总次数
tmq_consumer_close_successDOUBLE成功关闭消费者的次数
tmq_consumer_close_failDOUBLE关闭消费者失败的次数
tmq_subscribe_totalDOUBLE订阅主题的总次数
tmq_subscribe_successDOUBLE成功订阅主题的次数
tmq_subscribe_failDOUBLE订阅主题失败的次数
tmq_unsubscribe_totalDOUBLE取消订阅的总次数
tmq_unsubscribe_successDOUBLE成功取消订阅的次数
tmq_unsubscribe_failDOUBLE取消订阅失败的次数
tmq_list_new_totalDOUBLE创建新主题列表的总次数
tmq_list_new_successDOUBLE成功创建新主题列表的次数
tmq_list_new_failDOUBLE创建新主题列表失败的次数
tmq_list_destroy_totalDOUBLE销毁主题列表的总次数
tmq_list_destroy_successDOUBLE成功销毁主题列表的次数
tmq_conf_new_totalDOUBLEtmq 创建新配置的总次数
tmq_conf_new_successDOUBLEtmq 成功创建新配置的次数
tmq_conf_new_failDOUBLEtmq 创建新配置失败的次数
tmq_conf_destroy_totalDOUBLEtmq 销毁配置的总次数
tmq_conf_destroy_successDOUBLEtmq 成功销毁配置的次数
taos_stmt2_prepare_totalDOUBLEstmt2 准备的总次数
taos_stmt2_prepare_successDOUBLEstmt2 准备成功的次数
taos_stmt2_prepare_failDOUBLEstmt2 准备失败的次数
taos_stmt2_is_insert_totalDOUBLE检查是否为插入的总次数
taos_stmt2_is_insert_successDOUBLE成功检查是否为插入的次数
taos_stmt2_is_insert_failDOUBLE检查是否为插入失败的次数
taos_stmt2_bind_param_totalDOUBLEstmt2 绑定参数的总次数
taos_stmt2_bind_param_successDOUBLEstmt2 成功绑定参数的次数
taos_stmt2_bind_param_failDOUBLEstmt2 绑定参数失败的次数
taos_stmt2_exec_totalDOUBLEstmt2 执行的总次数
taos_stmt2_exec_successDOUBLEstmt2 执行成功的次数
taos_stmt2_exec_failDOUBLEstmt2 执行失败的次数
taos_stmt2_error_totalDOUBLEstmt2 错误检查的总次数
taos_stmt2_error_successDOUBLEstmt2 成功检查错误的次数
taos_fetch_row_totalDOUBLE同步获取行的总次数
taos_fetch_row_successDOUBLE成功同步获取行的次数
taos_is_update_query_totalDOUBLE检查是否为更新语句的总次数
taos_is_update_query_successDOUBLE成功检查是否为更新语句的次数
taos_affected_rows_totalDOUBLESQL 获取影响行数的总次数
taos_affected_rows_successDOUBLESQL 成功获取影响行数的次数
taos_num_fields_totalDOUBLE获取字段数量的总次数
taos_num_fields_successDOUBLE成功获取字段数量的次数
taos_fetch_fields_e_totalDOUBLE获取字段信息的扩展总次数
taos_fetch_fields_e_successDOUBLE成功获取字段信息的扩展次数
taos_fetch_fields_e_failDOUBLE获取字段信息的扩展失败次数
taos_result_precision_totalDOUBLE获取结果精度的总次数
taos_result_precision_successDOUBLE成功获取结果精度的次数
taos_get_raw_block_totalDOUBLE获取原始块的总次数
taos_get_raw_block_successDOUBLE成功获取原始块的次数
taos_fetch_raw_block_totalDOUBLE拉取原始块的总次数
taos_fetch_raw_block_successDOUBLE成功拉取原始块的次数
taos_fetch_raw_block_failDOUBLE拉取原始块失败的次数
taos_fetch_lengths_totalDOUBLE获取字段长度的总次数
taos_fetch_lengths_successDOUBLE成功获取字段长度的次数
taos_write_raw_block_with_reqid_totalDOUBLE带请求 ID 写入原始块的总次数
taos_write_raw_block_with_reqid_successDOUBLE带请求 ID 成功写入原始块的次数
taos_write_raw_block_with_reqid_failDOUBLE带请求 ID 写入原始块失败的次数
taos_write_raw_block_with_fields_with_reqid_totalDOUBLE带请求 ID 和字段写入原始块的总次数
taos_write_raw_block_with_fields_with_reqid_successDOUBLE带请求 ID 和字段成功写入原始块的次数
taos_write_raw_block_with_fields_with_reqid_failDOUBLE带请求 ID 和字段写入原始块失败的次数
tmq_write_raw_totalDOUBLE写入原始数据的 TMQ 总次数
tmq_write_raw_successDOUBLE成功写入原始数据的 TMQ 次数
tmq_write_raw_failDOUBLE写入原始数据的 TMQ 失败次数
taos_stmt_prepare_totalDOUBLEstmt 准备的总次数
taos_stmt_prepare_successDOUBLEstmt 准备成功的次数
taos_stmt_prepare_failDOUBLEstmt 准备失败的次数
taos_stmt_is_insert_totalDOUBLE检查 stmt 是否为插入的总次数
taos_stmt_is_insert_successDOUBLE成功检查 stmt 是否为插入的次数
taos_stmt_is_insert_failDOUBLE检查 stmt 是否为插入失败的次数
taos_stmt_set_tbname_totalDOUBLEstmt 设置表名的总次数
taos_stmt_set_tbname_successDOUBLEstmt 成功设置表名的次数
taos_stmt_set_tbname_failDOUBLEstmt 设置表名失败的次数
taos_stmt_set_tags_totalDOUBLEstmt 设置 tag 的总次数
taos_stmt_set_tags_successDOUBLEstmt 成功设置 tag 的次数
taos_stmt_set_tags_failDOUBLEstmt 设置 tag 失败的次数
taos_stmt_bind_param_batch_totalDOUBLEstmt 批量绑定参数的总次数
taos_stmt_bind_param_batch_successDOUBLEstmt 成功批量绑定参数的次数
taos_stmt_bind_param_batch_failDOUBLEstmt 批量绑定参数失败的次数
taos_stmt_add_batch_totalDOUBLEstmt 添加批处理的总次数
taos_stmt_add_batch_successDOUBLEstmt 成功添加批处理的次数
taos_stmt_add_batch_failDOUBLEstmt 添加批处理失败的次数
taos_stmt_execute_totalDOUBLEstmt 执行的总次数
taos_stmt_execute_successDOUBLEstmt 执行成功的次数
taos_stmt_execute_failDOUBLEstmt 执行失败的次数
taos_stmt_num_params_totalDOUBLEstmt 获取参数数量的总次数
taos_stmt_num_params_successDOUBLEstmt 成功获取参数数量的次数
taos_stmt_num_params_failDOUBLEstmt 获取参数数量失败的次数
taos_stmt_get_param_totalDOUBLEstmt 获取参数的总次数
taos_stmt_get_param_successDOUBLEstmt 成功获取参数的次数
taos_stmt_get_param_failDOUBLEstmt 获取参数失败的次数
taos_stmt_errstr_totalDOUBLEstmt 获取 stmt 错误信息的总次数
taos_stmt_errstr_successDOUBLEstmt 成功获取 stmt 错误信息的次数
taos_stmt_affected_rows_once_totalDOUBLEstmt 获取单次影响行数的总次数
taos_stmt_affected_rows_once_successDOUBLEstmt 成功获取单次影响行数的次数
taos_stmt_use_result_totalDOUBLEstmt 使用结果集的总次数
taos_stmt_use_result_successDOUBLEstmt 成功使用结果集的次数
taos_stmt_use_result_failDOUBLEstmt 使用结果集失败的次数
taos_select_db_totalDOUBLE选择数据库的总次数
taos_select_db_successDOUBLE成功选择数据库的次数
taos_select_db_failDOUBLE选择数据库失败的次数
taos_get_tables_vgId_totalDOUBLE获取表 vgroup ID 的总次数
taos_get_tables_vgId_successDOUBLE成功获取表 vgroup ID 的次数
taos_get_tables_vgId_failDOUBLE获取表 vgroup ID 失败的次数
taos_options_connection_totalDOUBLE设置连接选项的总次数
taos_options_connection_successDOUBLE成功设置连接选项的次数
taos_options_connection_failDOUBLE设置连接选项失败的次数
taos_validate_sql_totalDOUBLE验证 SQL 的总次数
taos_validate_sql_successDOUBLE成功验证 SQL 的次数
taos_validate_sql_failDOUBLE验证 SQL 失败的次数
taos_check_server_status_totalDOUBLE检查服务器状态的总次数
taos_check_server_status_successDOUBLE成功检查服务器状态的次数
taos_get_current_db_totalDOUBLE获取当前数据库的总次数
taos_get_current_db_successDOUBLE成功获取当前数据库的次数
taos_get_current_db_failDOUBLE获取当前数据库失败的次数
taos_get_server_info_totalDOUBLE获取服务器信息的总次数
taos_get_server_info_successDOUBLE成功获取服务器信息的次数
taos_options_totalDOUBLE设置选项的总次数
taos_options_successDOUBLE成功设置选项的次数
taos_options_failDOUBLE设置选项失败的次数
taos_set_conn_mode_totalDOUBLE设置连接模式的总次数
taos_set_conn_mode_successDOUBLE成功设置连接模式的次数
taos_set_conn_mode_failDOUBLE设置连接模式失败的次数
taos_reset_current_db_totalDOUBLE重置当前数据库的总次数
taos_reset_current_db_successDOUBLE成功重置当前数据库的次数
taos_set_notify_cb_totalDOUBLE设置通知回调的总次数
taos_set_notify_cb_successDOUBLE成功设置通知回调的次数
taos_set_notify_cb_failDOUBLE设置通知回调失败的次数
taos_errno_totalDOUBLE获取错误码的总次数
taos_errno_successDOUBLE成功获取错误码的次数
taos_errstr_totalDOUBLE获取错误信息的总次数
taos_errstr_successDOUBLE成功获取错误信息的次数
tmq_consumer_poll_totalDOUBLEtmq 消费者 poll 的总次数
tmq_consumer_poll_successDOUBLEtmq 消费者 poll 成功的次数
tmq_consumer_poll_failDOUBLEtmq 消费者 poll 失败的次数
tmq_subscription_totalDOUBLEtmq 获取订阅信息的总次数
tmq_subscription_successDOUBLEtmq 成功获取订阅信息的次数
tmq_subscription_failDOUBLEtmq 获取订阅信息失败的次数
tmq_list_append_totalDOUBLEtmq 列表追加的总次数
tmq_list_append_successDOUBLEtmq 成功列表追加的次数
tmq_list_append_failDOUBLEtmq 列表追加失败的次数
tmq_list_get_size_totalDOUBLEtmq 获取列表大小的总次数
tmq_list_get_size_successDOUBLEtmq 成功获取列表大小的次数
tmq_err2str_totalDOUBLEtmq 错误码转字符串的总次数
tmq_err2str_successDOUBLEtmq 成功将错误码转为字符串的次数
tmq_conf_set_totalDOUBLEtmq 设置配置的总次数
tmq_conf_set_successDOUBLEtmq 成功设置配置的次数
tmq_conf_set_failDOUBLEtmq 设置配置失败的次数
tmq_get_res_type_totalDOUBLEtmq 获取资源类型的总次数
tmq_get_res_type_successDOUBLEtmq 成功获取资源类型的次数
tmq_get_topic_name_totalDOUBLEtmq 获取主题名称的总次数
tmq_get_topic_name_successDOUBLEtmq 成功获取主题名称的次数
tmq_get_vgroup_id_totalDOUBLEtmq 获取 vgroup ID 的总次数
tmq_get_vgroup_id_successDOUBLEtmq 成功获取 vgroup ID 的次数
tmq_get_vgroup_offset_totalDOUBLEtmq 获取 vgroup 偏移量的总次数
tmq_get_vgroup_offset_successDOUBLEtmq 成功获取 vgroup 偏移量的次数
tmq_get_db_name_totalDOUBLEtmq 获取数据库名称的总次数
tmq_get_db_name_successDOUBLEtmq 成功获取数据库名称的次数
tmq_get_table_name_totalDOUBLEtmq 获取表名称的总次数
tmq_get_table_name_successDOUBLEtmq 成功获取表名称的次数
tmq_get_connect_totalDOUBLEtmq 获取连接的总次数
tmq_get_connect_successDOUBLEtmq 成功获取连接的次数
tmq_commit_sync_totalDOUBLEtmq 同步提交的总次数
tmq_commit_sync_successDOUBLEtmq 同步提交成功的次数
tmq_commit_sync_failDOUBLEtmq 同步提交失败的次数
tmq_fetch_raw_block_totalDOUBLEtmq 获取原始块的总次数
tmq_fetch_raw_block_successDOUBLEtmq 成功获取原始块的次数
tmq_fetch_raw_block_failDOUBLEtmq 获取原始块失败的次数
tmq_get_topic_assignment_totalDOUBLEtmq 获取主题分配的总次数
tmq_get_topic_assignment_successDOUBLEtmq 成功获取主题分配的次数
tmq_get_topic_assignment_failDOUBLEtmq 获取主题分配失败的次数
tmq_offset_seek_totalDOUBLEtmq 偏移量定位的总次数
tmq_offset_seek_successDOUBLEtmq 成功偏移量定位的次数
tmq_offset_seek_failDOUBLEtmq 偏移量定位失败的次数
tmq_committed_totalDOUBLEtmq 获取已提交偏移量的总次数
tmq_committed_successDOUBLEtmq 成功获取已提交偏移量的次数
tmq_commit_offset_sync_failDOUBLEtmq 同步提交偏移量失败的次数
tmq_position_totalDOUBLEtmq 获取当前位置的总次数
tmq_position_successDOUBLEtmq 成功获取当前位置的次数
tmq_commit_offset_sync_totalDOUBLEtmq 同步提交偏移量的总次数
tmq_commit_offset_sync_successDOUBLEtmq 同步提交偏移量成功的次数
endpointNCHARTAG请求端点

从 3.3.6.29/3.3.8.3 版本开始新增 adapter_request_limit 表记录 taosAdapter 查询请求限流数据：

详细信息
fieldtypeis_tagcomment
_tsTIMESTAMP数据采集时间戳
query_limitDOUBLE允许同时执行的查询请求的最大并发数
query_max_waitDOUBLE查询队列中允许等待执行的最大查询数量
query_inflightDOUBLE当前正在执行的、受并发限制的查询数量
query_wait_countDOUBLE当前在队列中等待执行的查询数量
query_countDOUBLE本采集周期内收到的、受并发限制的查询请求总数
query_wait_fail_countDOUBLE本采集周期内因等待超时或超过最大等待队列长度而失败的查询请求数量
endpointNCHARTAG请求端点
userNCHARTAG发起查询请求的认证用户名

httpd 升级为 taosAdapter 的变化​

在 TDengine TSDB server 2.2.x.x 或更早期版本中，taosd 进程包含一个内嵌的 http 服务（httpd）。如前面所述，taosAdapter 是一个使用 systemd 管理的独立软件，拥有自己的进程。并且两者有一些配置参数和行为是不同的，请见下表：

#embedded httpdtaosAdaptercomment
1httpEnableRecordSql--logLevel=debug
2httpMaxThreadsn/ataosAdapter 自动管理线程池，无需此参数
3telegrafUseFieldNum请参考 taosAdapter telegraf 配置方法
4restfulRowLimitrestfulRowLimit内嵌 httpd 默认输出 10240 行数据，最大允许值为 102400。taosAdapter 也提供 restfulRowLimit 但是默认不做限制。您可以根据实际场景需求进行配置
5httpDebugFlag不适用httpdDebugFlag 对 taosAdapter 不起作用
6httpDBNameMandatory不适用taosAdapter 要求 URL 中必须指定数据库名
SOC 2 Certified
ISO 27001 Certified
ISO 27017 Certified
TDengine 专为物联网IoT平台、工业大数据平台设计。其中，TDengine TSDB 是一款高性能、分布式的时序数据库（Time Series Database），同时它还带有内建的缓存、流式计算、数据订阅等系统功能；TDengine IDMP 是一款AI原生工业数据管理平台，它通过树状层次结构建立数据目录，对数据进行标准化、情景化，并通过 AI 提供实时分析、可视化、事件管理与报警等功能。
产品
TDengine TSDB
TDengine IDMP
TDengine Cloud
学习
TSDB 文档
IDMP 文档
博客
资源
公司
关于我们
技术支持
新闻动态
安全性
联系我们
招贤纳士
服务条款
隐私
场景
物联网
工业互联网
车联网
IT 运维
电力能源
金融
TDengine Database
加小 T 为好友
即可加入物联网大数据技术前沿群
点击填写表单
获得解决方案专家帮助
© 2017-2025 涛思数据
京公网安备 11010502047618号
新版时序数据库 TDengine Database v3.0