properties-系統(tǒng)
application.properties
中的鍵值對 key-value 主要分為以下兩類:
自定義配置:指 key 值是由用戶指定,被用戶程序代碼使用的自定義配置,這類配置不會影響 SOFABoot 框架,具體含義與用途完全由用戶決定。
系統(tǒng)配置:指 key 值是由 SOFABoot 框架指定,并能影響框架運行的配置。
本文列出了支持在 config/application.properties
中進行配置的所有系統(tǒng)配置項。
SOFABoot 系統(tǒng)配置項
默認配置項
下表列出了默認的系統(tǒng)配置項:
配置項 | 類型 | 配置項說明 | 默認值 | 取值范圍 |
| STRING | 應(yīng)用名稱。 | 無 | 必填。 由 a~z 小寫字母和 “-” 組成的字符串,不包含任何其他符號。如 helloworld 、hello-world。 |
| STRING | SOFA 框架以及各中間件的日志輸出目錄。 |
| 表示目錄的字符串。
|
| STRING | 使用工程原型創(chuàng)建的業(yè)務(wù)應(yīng)用的日志級別。 | INFO | 表示業(yè)務(wù)應(yīng)用的日志打印級別,可配置以下值:
|
RPC 配置項
下表列出了 RPC 相關(guān)的系統(tǒng)配置項:
配置項 | 類型 | 配置項說明 | 默認值 | 取值范圍 |
| STRING | RPC 路由模式。 | 空 |
|
| BOOLEAN | 是否開啟 SOFARouter。 | true(1.0.0 版本); false(1.1.0 - 2.1.4 版本)。 |
|
| INTEGER | RPC 對于同一服務(wù)多次引用時拋出異常的閾值。 | 3 | 正整數(shù),如 5。 |
| INTEGER | 服務(wù)器線程池最小線程數(shù)。 | 20 | 正整數(shù),如 100。 |
| INTEGER | TR 服務(wù)器線程池最大線程數(shù)。 | 200 | 正整數(shù),如 600。 |
| INTEGER | TR 服務(wù)器線程池隊列大小。 | 0 | 正整數(shù),如 2000。 |
| INTEGER | TR 端口號 | 12200 | 正整數(shù),如 12201。 |
| INTEGER | 預(yù)熱調(diào)用超時時間,單位毫秒。 | 10000 | 正整數(shù),如10000。 |
| INTEGER | TR 客戶端會自動重連已斷連的服務(wù)端的時間間隔 ,單位毫秒。 | 10000 | 正整數(shù),如20000。 |
另外,以下 RPC 系統(tǒng)配置項需要配合 JVM 參數(shù)進行設(shè)置,具體可參考 技術(shù)棧使用指南。
配置項 | 類型 | 說明 | 默認值 | 取值范圍 |
| STRING | 服務(wù)器綁定固定網(wǎng)卡。 | 空,此時會從可獲取網(wǎng)卡列表中取第一個。 | 通過 |
| STRING | 服務(wù)器綁定本地 IP 范圍。 | 空,此時會從可獲取網(wǎng)卡列表中取第一個。 | 格式: |
| STRING | 預(yù)熱轉(zhuǎn)發(fā)和權(quán)重配置。 | 空 |
|
| STRING | 僅用于標識預(yù)熱轉(zhuǎn)發(fā)目標集群。 | 空 | 自定義字符串,如 abc。 |
Tracer 配置項
下表列出了 Tracer 相關(guān)的系統(tǒng)配置項:
配置項 | 類型 | 說明 | 默認值 | 取值范圍 |
| STRING | 日志輸出目錄。 | Tracer 會優(yōu)先輸出到 | 正確的日志路徑。 |
| STRING | Tracer 日志的滾動策略。 | 默認不配置按照天滾動。 |
|
| INTEGER | Tracer 日志的保留天數(shù)。 | 默認保留 7 天 | 正整數(shù),如 8、9。 |
| INTEGER | 統(tǒng)計日志的時間間隔。 | 默認 60 秒統(tǒng)計日志輸出一次。 | 正整數(shù),單位為秒。 |
| INTEGER | 透傳數(shù)據(jù)能夠允許存放的最大長度。 | 1024 | 正整數(shù)。 |
| BOOLEAN | 是否關(guān)閉所有集成 Tracer 組件摘要日志打印。 | false |
|
| BOOLEAN | 是否關(guān)閉指定 | false |
|
SOFABoot 健康檢查配置項
配置項 | 類型 | 說明 | 默認值 | 取值范圍 |
| BOOLEAN | 是否跳過整個自檢階段。 | false |
|
| BOOLEAN | 是否跳過組件的自檢。 | false |
|
| BOOLEAN | 是否跳過HealthIndicator的健康檢查自檢。 | false |
|
| INTEGER | 流量入口組件自檢的失敗重試次數(shù),超過這個次數(shù),就不會再進行健康檢查,服務(wù)就起不來了。 | 20 | 正整數(shù),例如12。 |
| BOOLEAN | 是否對流量入口組件進行嚴格的組件自檢。 | true |
|
Java啟動參數(shù)設(shè)置(啟動時以-D參數(shù)的方式配置):
配置項 | 默認值 | 說明 |
| 3000 | 獲取配置中心返回地址的等待時間,單位:毫秒。 |
| 27 | TR 心跳的間隔時間,單位:秒。 |