doc: update connection parameters

This commit is contained in:
Shengliang Guan 2024-12-25 19:50:53 +08:00
parent 579fa34685
commit 21e7e01ce8
1 changed files with 147 additions and 21 deletions

View File

@ -13,7 +13,9 @@ taosd 命令行参数如下
- -c `<directory>`:指定配置文件所在目录
- -s打印 SDB 信息
- -C: 打印配置信息
- -e: 指定环境变量,其格式形如 `-e 'TAOS_FQDN=td1'`
- -e: 指定环境变量的字符串,例如:`-e 'TAOS_FQDN=td1'`
- -E: 指定环境变量的文件路径,默认是 `./.env`.env 文件中的内容可以是 `TAOS_FQDN=td1`
- -o: 指定日志输入方式,可选 `stdout`, `stderr`, `/dev/null`, `<directory>`,` <directory>/<filename>`, `<filename>`
- -k: 获取机器码
- -dm: 启用内存调度
- -V: 打印版本信息
@ -21,29 +23,153 @@ taosd 命令行参数如下
## 配置参数
:::note
配置文件参数修改后,需要重启*taosd*服务,或客户端应用才能生效。
配置文件参数修改后,需要重启*taosd*服务,或客户端应用才能生效
:::
### 连接相关
|参数名称|支持版本|动态修改|参数含义|
|-----------------------|-------------------------|-------------------------|------------|
|firstEp | |不支持动态修改 |taosd 启动时,主动连接的集群中首个 dnode 的 end point默认值 localhost:6030|
|secondEp | |不支持动态修改 |taosd 启动时,如果 firstEp 连接不上,尝试连接集群中第二个 dnode 的 endpoint无默认值|
|fqdn | |不支持动态修改 |taosd 监听的服务地址,默认为所在服务器上配置的第一个 hostname|
|serverPort | |不支持动态修改 |taosd 监听的端口,默认值 6030|
|compressMsgSize | |支持动态修改 重启生效 |是否对 RPC 消息进行压缩;-1所有消息都不压缩0所有消息都压缩N (N>0):只有大于 N 个字节的消息才压缩;默认值 -1|
|shellActivityTimer | |支持动态修改 立即生效 |客户端向 mnode 发送心跳的时长,单位为秒,取值范围 1-120默认值 3 |
|numOfRpcSessions | |支持动态修改 重启生效 |RPC 支持的最大连接数,取值范围 100-100000默认值 30000|
|numOfRpcThreads | |支持动态修改 重启生效 |RPC 收发数据线程数目取值范围1-50,默认值为 CPU 核数的一半|
|numOfTaskQueueThreads | |支持动态修改 重启生效 |客户端处理 RPC 消息的线程数取值, 范围4-16,默认值为 CPU 核数的一半|
|rpcQueueMemoryAllowed | |支持动态修改 立即生效 |dnode允许的已经收到的RPC消息占用的内存最大值单位 bytes取值范围 104857600-INT64_MAX默认值为服务器内存的 1/10 |
|resolveFQDNRetryTime | 3.x 之后取消 |不支持动态修改 |FQDN 解析失败时的重试次数|
|timeToGetAvailableConn | 3.3.4.x之后取消 |支持动态修改 重启生效 |获得可用连接的最长等待时间,取值范围 10-50000000单位为毫秒默认值 500000|
|maxShellConns | 3.x 后取消 |支持动态修改 重启生效 |允许创建的最大链接数|
|maxRetryWaitTime | |支持动态修改 重启生效 |重连最大超时时间, 默认值是 10s|
|shareConnLimit |3.3.4.0 新增 |支持动态修改 重启生效 |一个链接可以共享的请求的数目,取值范围 1-512默认值 10|
|readTimeout |3.3.4.0 新增 |支持动态修改 重启生效 |单个请求最小超时时间,取值范围 64-604800单位为秒默认值 900|
#### firstEp
- 说明taosd 启动时,主动连接的集群中首个 dnode 的 end point
- 类型endpoint
- 默认值localhost:6030
- 动态修改:不支持
- 支持版本:从 v3.0.0.0 版本开始引入
#### secondEp
- 说明taosd 启动时,如果 firstEp 连接不上,尝试连接集群中第二个 dnode 的 endpoint
- 类型endpoint
- 默认值:无
- 动态修改:不支持
- 支持版本:从 v3.0.0.0 版本开始引入
#### fqdn
- 说明taosd 监听的服务地址
- 类型fqdn
- 默认值:所在服务器上配置的第一个 hostname
- 动态修改:不支持
- 支持版本:从 v3.0.0.0 版本开始引入
#### serverPort
- 说明taosd 监听的端口
- 类型:整数
- 默认值6030
- 最小值1
- 最大值65056
- 动态修改:不支持
- 支持版本:从 v3.0.0.0 版本开始引入
#### compressMsgSize
- 说明:是否对 RPC 消息进行压缩;-1所有消息都不压缩0所有消息都压缩N (N>0):只有大于 N 个字节的消息才压缩
- 类型:整数
- 默认值:-1
- 最小值:-1
- 最大值100000000
- 动态修改:支持动态修改,重启后生效
- 支持版本:从 v3.0.0.0 版本开始引入
#### shellActivityTimer
- 说明:客户端向 mnode 发送心跳的时长
- 类型:整数
- 单位:秒
- 默认值3
- 最小值1
- 最大值120
- 动态修改:支持动态修改,立即生效
- 支持版本:从 v3.0.0.0 版本开始引入
#### numOfRpcSessions
- 说明RPC 支持的最大连接数
- 类型:整数
- 默认值30000
- 最小值100
- 最大值100000
- 动态修改:支持动态修改,重启后生效
- 支持版本:从 v3.1.0.0 版本开始引入
#### numOfRpcThreads
- 说明RPC 收发数据的线程数目
- 类型:整数
- 默认值CPU 核数的一半
- 最小值1
- 最大值50
- 动态修改:支持动态修改,重启后生效
- 支持版本:从 v3.0.0.0 版本开始引入
#### numOfTaskQueueThreads
- 说明RPC 处理消息的线程数目
- 类型:整数
- 默认值CPU 核数的一半
- 最小值4
- 最大值16
- 动态修改:支持动态修改,重启后生效
- 支持版本:从 v3.0.0.0 版本开始引入
#### rpcQueueMemoryAllowed
- 说明dnode 已经收到并等待处理的 RPC 消息占用内存的最大值
- 类型:整数
- 单位byte
- 默认值:服务器内存的 1/10
- 最小值104857600
- 最大值INT64_MAX
- 动态修改:支持动态修改,立即生效
- 支持版本:从 v3.0.0.0 版本开始引入
#### resolveFQDNRetryTime
- 说明FQDN 解析失败时的重试次数
- 类型:整数
- 默认值100
- 最小值1
- 最大值10240
- 动态修改:不支持
- 支持版本v3.3.4.0 版本之后取消
#### timeToGetAvailableConn
- 说明:获得可用连接的最长等待时间
- 类型:整数
- 单位:毫秒
- 默认值500000
- 最小值20
- 最大值1000000
- 动态修改:不支持
- 支持版本v3.3.4.0 版本之后取消
#### maxShellConns
- 说明:允许创建的最大链接数
- 类型:整数
- 默认值50000
- 最小值10
- 最大值50000000
- 动态修改:不支持
- 支持版本v3.3.4.0 版本之后取消
#### maxRetryWaitTime
- 说明:重连最大超时时间
- 类型:整数
- 单位:毫秒
- 默认值10000
- 最小值0
- 最大值86400000
- 动态修改:支持动态修改,重启后生效
- 支持版本:从 v3.3.4.0 版本开始引入
#### shareConnLimit
- 说明:一个链接可以共享的请求的数目
- 类型:整数
- 默认值10
- 最小值1
- 最大值512
- 动态修改:支持动态修改,重启后生效
- 支持版本:从 v3.3.4.0 版本开始引入
#### readTimeout
- 说明:单个请求最小超时时间
- 类型:整数
- 单位:秒
- 默认值900
- 最小值64
- 最大值604800
- 动态修改:支持动态修改,重启后生效
- 支持版本:从 v3.3.4.0 版本开始引入
### 监控相关
|参数名称|支持版本|动态修改|参数含义|