Transport TCP Keep-Alive 探测间隔配置

配置项作用 #

transport.tcp.keep_interval 配置项用于控制TCP keep-alive 探测之间的间隔时间（秒）。

配置项属性 #

• 配置路径: transport.tcp.keep_interval
• 数据类型: Integer（整数，秒）
• 默认值: -1（使用操作系统默认值）
• 是否可选: 是
• 作用域: NodeScope（节点级别）
• 动态更新: 否（需要重启节点生效）

配置建议 #

默认配置 #

transport:
  tcp:
    keep_interval: -1  # 使用操作系统默认值

快速检测场景 #

transport:
  tcp:
    keep_alive: true
    keep_idle: 60       # 60秒空闲后开始探测
    keep_interval: 10   # 每10秒发送一次探测
    keep_count: 9       # 9次探测失败后声明连接死亡（总共150秒超时）

标准配置 #

transport:
  tcp:
    keep_alive: true
    keep_idle: 60       # 60秒空闲后开始探测
    keep_interval: 5    # 每5秒发送一次探测
    keep_count: 3       # 3次探测失败后声明连接死亡（总共75秒超时）

注意事项 #

1. 非动态更新: 需要重启节点生效。

2. 操作系统默认值: 设置为 -1 时使用操作系统默认值，不同平台默认值不同。

3. 超时计算: 配合 keep_idle 和 keep_count 共同决定连接被声明死亡的总时间：

   • 例如：keep_idle=60, keep_interval=10, keep_count=9
   • 表示：60秒空闲后，每10秒发送一次探测，9次失败后（90秒）声明连接死亡
   • 总超时时间 = 60 + 10 × 9 = 150秒

4. Linux 系统对应: 此设置配置 Linux 系统的 TCP_KEEPINTVL socket 选项。

5. 配置关系: 需要配合 transport.tcp.keep_idle 和 transport.tcp.keep_count 使用，共同控制 TCP keep-alive 行为。

6. 使用场景: 特别适用于有防火墙或负载均衡器的环境，确保空闲连接不会因超时被丢弃。