全部产品
云市场

系统配置参数

更新时间:2019-11-06 15:08:02

本文列出了支持全局配置的所有系统配置,即 SOFABoot 已支持以下配置,且支持在 config/application.properties 中进行设置并全局生效。

SOFABoot 配置

下表列出了 SOFABoot 相关的系统配置项:

配置项 类型 配置项说明 默认值 取值范围
spring.application.name STRING 应用名称 必填,由 a~z 小写字母和 “-” 组成的字符串,不包含任何其他符号,如 helloworld 、hello-world。
logging.path STRING SOFA 框架以及各中间件的日志输出目录 ./logs 表示目录的字符串。支持相对路径,如 ./logs;也支持绝对路径,如 /home/admin/logs
logging.level.${groupId} STRING 使用工程原型创建的业务应用的日志级别 INFO 表示业务应用的日志打印级别,可配置以下值:
  • INFO:表示基础信息日志;
  • WARN:表示警告日志;
  • DEBUG:表示调试日志。

RPC 配置

下表列出了 RPC 相关的系统配置项:

配置项 类型 配置项说明 默认值 取值范围
run.mode / run_mode STRING RPC 路由模式
  • DEV:表示 RPC 路由时,强制用本地模式(客户端和服务端均在一台机器);
  • TEST:表示 RPC 路由时,强制用 test-url 参数指定的地址(点对点连接);
  • NORMAL:表示 RPC 路由时,使用软负载的路由,也是线上正确的模式。
rpc.sofarouter BOOLEAN 是否开启 SOFARouter true(1.0.0 版本);false(1.1.0 - 2.1.4 版本)
  • true:开启 SOFARouter 的功能;
  • false:关闭 SOFARouter 的功能。
rpc.reference.duplicate.limit INTEGER RPC 对于同一服务多次引用时抛出异常的阈值 3 正整数,如 5。
rpc.min.pool.size.tr INTEGER 服务器线程池最小线程数 20 正整数,如 100。
rpc.max.pool.size.tr INTEGER TR 服务器线程池最大线程数 200 正整数,如 600。
rpc.pool.queue.size.tr INTEGER TR 服务器线程池队列大小 0 正整数,如 2000。

另外,以下 RPC 系统配置项需要配合 JVM 参数进行设置,具体可参考 JVM 参数支持

配置项 类型 说明 默认值 取值范围
rpc_bind_network_interface STRING 服务器绑定固定网卡 空,此时会从可获取网卡列表中取第一个 通过 ifconfig 获取的网卡名字,如 eth0。
rpc_enabled_ip_range STRING 服务器绑定本地 IP 范围 空,此时会从可获取网卡列表中取第一个 格式:IP_RANGE1:IP_RANGE2,IP_RANGE
例如:rpc_enabled_ip_range=10.1:10.2,11 表示 RPC 路由时会在 10.1.0.0~10.2.255.255 和 11.0.0.0~11.255.255.255 两个 IP 段内选择目标地址。
core_proxy_url STRING 预热转发和权重配置
  • 格式 1:x.x.x.x,即合法转发目标 URL;
  • 格式 2:weightStarting:0.3,during:60,weightStarted:0.2,address:x.x.x.x,uniqueId:core_unique,即包含了预热期转发权重、预热时间、预热后转发权重、目标地址、集群标识符的格式。
core_unique STRING 仅用于标识预热转发目标集群 自定义字符串,如 abc。

Tracer 配置

下表列出了 Tracer 相关的系统配置项:

配置项 类型 说明 默认值 取值范围
logging.path STRING 日志输出目录 Tracer 会优先输出到 logging.path 目录下;如果没有配置日志输出目录,那默认输出到 ${user.home} 正确的日志路径
com.alipay.sofa.tracer.tracerGlobalRollingPolicy STRING Tracer 日志的滚动策略 默认不配置按照天滚动。 yyyy-MM-dd:按照天滚动;
yyyy-MM-dd_HH:按照小时滚动。
com.alipay.sofa.tracer.tracerGlobalLogReserveDay INTEGER Tracer 日志的保留天数 默认保留 7 天 正整数,如 8、9。
com.alipay.sofa.tracer.statLogInterval INTEGER 统计日志的时间间隔 默认 60 秒统计日志输出一次 正整数,单位为秒
com.alipay.sofa.tracer.baggageMaxLength INTEGER 透传数据能够允许存放的最大长度 默认值 1024 正整数
com.alipay.sofa.tracer.disableDigestLog BOOLEAN 是否关闭所有集成 Tracer 组件摘要日志打印 false true
false
com.alipay.sofa.tracer.disableConfiguration[${logType}] BOOLEAN 关闭指定 ${logType} 的 SOFATracer 组件摘要日志打印。${logType} 是指具体的日志类型,如:spring-mvc-digest.log false true
false