FE 配置项
FE 参数分为动态参数和静态参数。
-
动态参数可通过 SQL 命令进行在线配置和调整,方便快捷。需要注意通过 SQL 命令所做的动态设置在重启 FE 后会失效。如果想让设置长期生效,建议同时修改 fe.conf 文件。
-
静态参数必须在 FE 配置文件 fe.conf 中进行配置和调整。调整完成后,需要重启 FE 使变更生效。
参数是否为动态参数可通过 ADMIN SHOW CONFIG 返回结果中的 IsMutable
列查看。TRUE
表示动态参数。
静态和动态参数均可通过 fe.conf 文件进行修改。
查看 FE 配置项
FE 启动后,您可以在 MySQL 客户端执行 ADMIN SHOW FRONTEND CONFIG 命令来查看参数配置。如果您想查看具体参数的配置,执行如下命令:
ADMIN SHOW FRONTEND CONFIG [LIKE "pattern"];
详细的命令返回字段解释,参见 ADMIN SHOW CONFIG。
备注
只有拥有 cluster_admin
角色的用户才可以执行集群管理相关命令。
配置 FE 参数
配置 FE 动态参数
您可以通过 ADMIN SET FRONTEND CONFIG 命令在线修改 FE 动态参数。
ADMIN SET FRONTEND CONFIG ("key" = "value");
备注
动态设置的配置项,在 FE 重启之后会恢复成 fe.conf 文件中的配置或者默认值。如果需要让配置长期生效,建议设置完之后同时修改 fe.conf 文件,防止重启后修改失效。
配置 FE 静态参数
备注
FE 静态参数不支持在线修改,您需要在 fe.conf
中修改并重启 FE 以使修改生效。
FE 参数描述
日志
log_roll_size_mb
- 默认值:1024
- 类型:Int
- 单位:MB
- 是否动态:否
- 描述:单个系统日志或审计日志文件的大小上限。
- 引入版本:-
sys_log_dir
- 默认值:StarRocksFE.STARROCKS_HOME_DIR + "/log"
- 类型:String
- 单位:-
- 是否动态:否
- 描述:系统日志文件的保存目录。
- 引入版本:-
sys_log_level
- 默认值:INFO
- 类型:String
- 单位:-
- 是否动态:否
- 描述:系统日志的级别,从低到高依次为
INFO
、WARN
、ERROR
、FATAL
。 - 引入版本:-
sys_log_roll_num
- 默认值:10
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:每个
sys_log_roll_interval
时间段内,允许保留的系统日志文件的最大数目。 - 引入版本:-
sys_log_verbose_modules
- 默认值:空字符串
- 类型:String[]
- 单位:-
- 是否动态:否
- 描述:打印系统日志的模块。如果设置参数取值为
org.apache.starrocks.catalog
,则表示只打印 Catalog 模块下的日志。 - 引入版本:-
sys_log_roll_interval
- 默认值:DAY
- 类型:String
- 单位:-
- 是否动态:否
- 描述:系统日志滚动的时间间隔。取值范围:
DAY
和HOUR
。- 取值为
DAY
时,日志文件名的后缀为yyyyMMdd
。 - 取值为
HOUR
时,日志文件名的后缀为yyyyMMddHH
。
- 取值为
- 引入版本:-
sys_log_delete_age
- 默认值:7d
- 类型:String
- 单位:-
- 是否动态:否
- 描述:系统日志文件的保留时长。默认值
7d
表示系统日志文件可以保留 7 天,保留时长超过 7 天的系统日志文件会被删除。 - 引入版本:-
audit_log_dir
- 默认值:StarRocksFE.STARROCKS_HOME_DIR + "/log"
- 类型:String
- 单位:-
- 是否动态:否
- 描述:审计日志文件的保存目录。
- 引入版本:-
audit_log_roll_num
- 默认值:90
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:每个
audit_log_roll_interval
时间段内,允许保留的审计日志文件的最大数目。 - 引入版本:-
audit_log_modules
- 默认值:slow_query, query
- 类型:String[]
- 单位:-
- 是否动态:否
- 描述:打印审计日志的模块。默认打印
slow_query
和query
模块的日志。自 v3.0 起 支持connection
模块,即连接日志。可以指定多个模块,模块名称之间用英文逗号加一个空格分隔。 - 引入版本:-
qe_slow_log_ms
- 默认值:5000
- 类型:Long
- 单位:Milliseconds
- 是否动态:是
- 描述:Slow query 的认定时长。如果查询的响应时间超过此阈值,则会在审计日志
fe.audit.log
中记录为 slow query。 - 引入版本:-
audit_log_roll_interval
- 默认值:DAY
- 类型:String
- 单位:-
- 是否动态:否
- 描述:审计日志滚动的时间间隔。取值范围:
DAY
和HOUR
。- 取值为
DAY
时,日志文件名的后缀为yyyyMMdd
。 - 取值为
HOUR
时,日志文件名的后缀为yyyyMMddHH
。
- 取值为
- 引入版本:-
audit_log_delete_age
- 默认值:30d
- 类型:String
- 单位:-
- 是否动态:否
- 描述:审计日志文件的保留时长。默认值
30d
表示审计日志文件可以保留 30 天,保留时长超过 30 天的审计日志文件会被删除。 - 引入版本:-
dump_log_dir
- 默认值:StarRocksFE.STARROCKS_HOME_DIR + "/log"
- 类型:String
- 单位:-
- 是否动态:否
- 描述:Dump 日志文件的保存目录。
- 引入版本:-
dump_log_roll_num
- 默认值:10
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:每个
dump_log_roll_interval
时间内,允许保留的 Dump 日志文件的最大数目。 - 引入版本:-
dump_log_modules
- 默认值:query
- 类型:String[]
- 单位:-
- 是否动态:否
- 描述:打印 Dump 日志的模块。默认打印 query 模块的日志。可以指定多个模块,模块名称之间用英文逗号加一个空格分隔。
- 引入版本:-
dump_log_roll_interval
- 默认值:DAY
- 类型:String
- 单位:-
- 是否动态:否
- 描述:Dump 日志滚动的时间间隔。取值范围:
DAY
和HOUR
。- 取值为
DAY
时,日志文件名的后缀为yyyyMMdd
。 - 取值为
HOUR
时,日志文件名的后缀为yyyyMMddHH
。
- 取值为
- 引入版本:-
dump_log_delete_age
- 默认值:7d
- 类型:String
- 单位:-
- 是否动态:否
- 描述:Dump 日志文件的保留时长。默认值
7d
表示 Dump 日志文件可以保留 7 天,保留时长超过 7 天的 Dump 日志文件会被删除。 - 引入版本:-
Server
frontend_address
- 默认值:0.0.0.0
- 类型:String
- 单位:-
- 是否动态:否
- 描述:FE 节点的 IP 地址。
- 引入版本:-
priority_networks
- 默认值:空字符串
- 类型:String
- 单位:-
- 是否动态:否
- 描述:为那些有多个 IP 地址的服务器声明一个选择策略。 请注意,最多应该有一个 IP 地址与此列表匹配。这是一个以分号分隔格式的列表,用 CIDR 表示法,例如
10.10.10.0/24
。 如果没有匹配这条规则的ip,会随机选择一个。 - 引入版本:-
http_port
- 默认值:8030
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:FE 节点上 HTTP 服务器的端口。
- 引入版本:-
http_worker_threads_num
- 默认值:0
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:Http Server 用于处理 HTTP 请求的线程数。如果配置为负数或 0 ,线程数将设置为 CPU 核数的 2 倍。
- 引入版本:v2.5.18,v3.0.10,v3.1.7,v3.2.2
http_backlog_num
- 默认值:1024
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:HTTP 服务器支持的 Backlog 队列长度。
- 引入版本:-
cluster_name
- 默认值:StarRocks Cluster
- 类型:String
- 单位:-
- 是否动态:否
- 描述:FE 所在 StarRocks 集群的名称,显示为网页标题。
- 引入版本:-
rpc_port
- 默认值:9020
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:FE 节点上 Thrift 服务器的端口。
- 引入版本:-
thrift_server_max_worker_threads
- 默认值:4096
- 类型:Int
- 单位:-
- 是否动态:是
- 描述:Thrift 服务器支持的最大工作线程数。
- 引入版本:-
thrift_server_queue_size
- 默认值:4096
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:Thrift 服务器 pending 队列长度。如果当前处理线程数量超过了配置项
thrift_server_max_worker_threads
的值,则将超出的线程加入 Pending 队列。 - 引入版本:-
thrift_client_timeout_ms
- 默认值:5000
- 类型:Int
- 单位:Milliseconds
- 是否动态:否
- 描述:Thrift 客户端链接的空闲超时时间,即链接超过该时间无新请求后则将链接断开。
- 引入版本:-
thrift_backlog_num
- 默认值:1024
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:Thrift 服务器支持的 Backlog 队列长度。
- 引入版本:-
brpc_idle_wait_max_time
- 默认值:10000
- 类型:Int
- 单位:ms
- 是否动态:否
- 描述:bRPC 的空闲等待时间。
- 引入版本:-
query_port
- 默认值:9030
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:FE 节点上 MySQL 服务器的端口。
- 引入版本:-
mysql_nio_backlog_num
- 默认值:1024
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:MySQL 服务器支持的 Backlog 队列长度。
- 引入版本:-
mysql_service_nio_enabled
- 默认值:true
- 类型:Boolean
- 单位:-
- 是否动态:否
- 描述:是否开启 MySQL 服务器的异步 I/O 选项。
- 引入版本:-
mysql_service_io_threads_num
- 默认值:4
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:MySQL 服务器中用于处理 I/O 事件的最大线程数。
- 引入版本:-
max_mysql_service_task_threads_num
- 默认值:4096
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:MySQL 服务器中用于处理任务的最大线程数。
- 引入版本:-
mysql_server_version
- 默认值:5.1.0
- 类型:String
- 单位:-
- 是否动态:是
- 描述:MySQL 服务器的版本。修改该参数配置会影响以下场景中返回的版本号:
select version();
- Handshake packet 版本
- 全局变量
version
的取值 (show variables like 'version';
)
- 引入版本:-
qe_max_connection
- 默认值:4096
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:FE 支持的最大连接数,包括所有用户发起的连接。默认值由 v3.1.12、v3.2.7 起由
1024
变为4096
。 - 引入版本:-
max_connection_scheduler_threads_num
- 默认值:4096
- 类型:Int
- 单位:-
- 是否动态:否
- 描述:连接调度器支持的最大线程数。
- 引入版本:-
元数据与集群管理
cluster_id
- 默认值:-1