diff --git a/docs/zh/14-reference/01-components/01-taosd.md b/docs/zh/14-reference/01-components/01-taosd.md index 7a0a306a41..7c6354f533 100644 --- a/docs/zh/14-reference/01-components/01-taosd.md +++ b/docs/zh/14-reference/01-components/01-taosd.md @@ -13,7 +13,9 @@ taosd 命令行参数如下 - -c ``：指定配置文件所在目录 - -s：打印 SDB 信息 - -C: 打印配置信息 -- -e: 指定环境变量，其格式形如 `-e 'TAOS_FQDN=td1'` +- -e: 指定环境变量的字符串，例如：`-e 'TAOS_FQDN=td1'` +- -E: 指定环境变量的文件路径，默认是 `./.env`，.env 文件中的内容可以是 `TAOS_FQDN=td1` +- -o: 指定日志输入方式，可选 `stdout`, `stderr`, `/dev/null`, ``,` /`, `` - -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 版本开始引入 ### 监控相关 |参数名称|支持版本|动态修改|参数含义|