远程集群初始连接超时配置

配置项作用 #

cluster.remote.initial_connect_timeout 配置项用于控制节点启动时建立到远程集群初始连接的超时时间。

当 Easysearch 节点启动时，如果配置了远程集群，系统会尝试与这些远程集群建立连接。此配置决定了等待这些初始连接建立完成的最长时间。

配置项属性 #

• 配置路径: cluster.remote.initial_connect_timeout
• 数据类型: TimeValue（时间值）
• 默认值: 30s（30秒）
• 是否可选: 是
• 作用域: 节点级别（NodeScope）

配置项详解 #

超时机制 #

节点启动
    │
    ↓
读取远程集群配置
    │
    ↓
尝试连接远程集群
    │
    ├───→ 远程集群 A ─────→ 连接成功
    │                        │
    ├───→ 远程集群 B ─────→ 连接成功
    │                        │
    └───→ 远程集群 C ─────→ 等待...
                              │
                    (最多等待 initial_connect_timeout)
                              │
                         ┌────┴────┐
                        成功      超时
                         │          │
                    记录警告     继续启动

工作流程 #

1. 节点启动: 节点开始启动流程
2. 读取配置: 读取所有已配置的远程集群信息
3. 建立连接: 并行尝试连接到每个远程集群
4. 等待完成: 等待所有连接建立完成
5. 超时处理: 如果超过超时时间，记录警告并继续启动

超时后的行为 #

如果连接超时：

⚠️ [警告] failed to connect to remote clusters within 30s

• 记录警告日志
• 节点继续启动流程
• 远程集群连接会在后台继续尝试
• 不影响本地集群的正常运行

配置建议 #

生产环境（标准） #

cluster.remote.initial_connect_timeout: 30s

建议: 保持默认值 30s。适用于大多数生产环境。

高延迟网络环境 #

cluster.remote.initial_connect_timeout: 60s

建议: 增加到 60s-90s。当远程集群之间存在高网络延迟（如跨地域、跨云服务商）时使用。

多个远程集群 #

cluster.remote.initial_connect_timeout: 45s

建议: 适当增加到 45s-60s。当配置了多个远程集群时，连接所有集群需要更长时间。

快速启动要求 #

cluster.remote.initial_connect_timeout: 15s

建议: 减少到 15s-20s。当需要快速启动节点，且远程连接不是关键路径时使用。

本地开发环境 #

cluster.remote.initial_connect_timeout: 10s

建议: 减少到 10s。开发环境中可以设置较短的超时以加快启动速度。

代码示例 #

easysearch.yml 配置 #

cluster:
  remote:
    # 初始连接超时配置
    initial_connect_timeout: 30s

    # 远程集群配置
    production:
      seeds: ["prod-node1:9300", "prod-node2:9300"]
    dr:
      seeds: ["dr-node1:9300"]

跨地域部署配置 #

cluster:
  remote:
    # 跨地域部署需要更长超时
    initial_connect_timeout: 90s

    us_east:
      seeds: ["us-east-1.example.com:9300"]
    eu_west:
      seeds: ["eu-west-1.example.com:9300"]

快速启动配置 #

cluster:
  remote:
    # 减少超时以加快启动
    initial_connect_timeout: 15s

    backup:
      seeds: ["backup-node1:9300"]

相关配置 #

超时设置指南 #

启动过程时间分析 #

节点启动时间受此配置影响：

启动时间 = 本地集群启动时间 + min(远程连接时间, initial_connect_timeout)

例如：
- 本地启动: 10s
- 远程连接: 25s
- initial_connect_timeout: 30s

总启动时间 = 10s + 25s = 35s

注意事项 #

1. 仅影响初始连接: 此配置只影响节点启动时的初始连接，不影响运行时的重连。

2. 启动继续: 超时后节点会继续启动，不会阻止本地集群的正常运行。

3. 后台重连: 即使初始连接超时，系统会在后台继续尝试连接。

4. 非动态配置: 修改此配置需要重启节点才能生效。

5. 并行连接: 对多个远程集群的连接尝试是并行进行的。

6. 警告监控: 如果频繁出现超时警告，考虑：

   • 检查网络连接
   • 增加超时时间
   • 检查远程集群状态

7. 与 seeds 的关系: 确保 seeds 配置正确，错误的种子节点会导致连接超时。