主节点选举持续时间配置

配置项作用 #

cluster.election.duration 配置项指定每次主节点选举尝试的持续时间。此配置控制候选主节点在选举过程中等待其他节点响应的最长时间。

配置项类型 #

该配置项为静态配置，需要在启动时设置，修改后需要重启节点才能生效。

默认值 #

500ms（500毫秒）

是否必需 #

可选配置项（有默认值）

取值范围 #

1ms ~ 300s（300秒）

配置格式 #

# 默认配置
cluster.election.duration: 500ms

# 短时间（快速网络）
cluster.election.duration: 200ms

# 长时间（高延迟网络）
cluster.election.duration: 10s

# 极端情况（跨地域）
cluster.election.duration: 30s

相关配置项 #

工作原理 #

主节点选举过程：

┌─────────────────────────────────────────────────────────────────┐
│                    主节点选举流程                                │
└─────────────────────────────────────────────────────────────────┘

当前主节点失效
    │
    ▼
触发重新选举
    │
    ▼
等待 initial_timeout + random_delay
    │
    ▼
开始选举尝试
    │
    ├── 向其他候选节点发送投票请求
    │
    ├── 等待响应（最多 duration 时间）
    │   │
    │   ├── 获得多数票 → 成为新主节点
    │   │
    │   └── 未获得多数票 → 选举失败
    │
    └── 等待 back_off_time 后再次尝试

使用场景 #

1. 默认配置（本地/低延迟网络） #

cluster.election.duration: 500ms

适用于同一数据中心或低延迟网络环境。

2. 快速网络优化 #

cluster.election.duration: 200ms
cluster.election.initial_timeout: 50ms
cluster.election.max_timeout: 5s

适用于万兆网络或同机架部署。

3. 跨地域部署 #

cluster.election.duration: 10s
cluster.election.initial_timeout: 500ms
cluster.election.max_timeout: 30s

适用于跨数据中心或高延迟网络。

4. 高不稳定网络 #

cluster.election.duration: 30s
cluster.election.initial_timeout: 1s
cluster.election.max_timeout: 60s
cluster.election.back_off_time: 1s

选举机制详解 #

选举时间计算：

第 n 次选举的延迟范围:
(0, min(initial_timeout + (n-1) × back_off_time, max_timeout)]

示例 1: 使用默认值
initial_timeout = 100ms
back_off_time = 100ms
max_timeout = 10s

第 1 次: (0, 100ms] → 随机延迟后开始选举
第 2 次: (0, 200ms] → 随机延迟后开始选举
第 3 次: (0, 300ms] → 随机延迟后开始选举
...
第 N 次: (0, 10000ms] → 达到最大值

配置关系 #

选举超时时间递增:
┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│  initial_timeout = 100ms                                        │
│  back_off_time = 100ms                                          │
│  max_timeout = 10s                                              │
│                                                                 │
│  尝试次数        延迟范围                                        │
│  ─────────     ─────────────────                                │
│    1           (0, 100ms]                                       │
│    2           (0, 200ms]                                       │
│    3           (0, 300ms]                                       │
│    ...         ...                                             │
│   100          (0, 10000ms] ← 达到 max_timeout                  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

推荐设置建议 #

监控建议 #

# 查看集群状态
GET /_cluster/health

# 查看主节点信息
GET /_cat/master?v

# 查看节点角色
GET /_cat/nodes?v&h=name,master

常见问题 #

问题 1：选举频繁失败

可能原因： duration 设置过短

解决方案：

# 增加选举持续时间
cluster.election.duration: 2s

问题 2：主节点切换缓慢

可能原因： duration 设置过长

解决方案：

# 减少选举持续时间
cluster.election.duration: 300ms

问题 3：脑裂

原因： duration 过长导致多个节点认为自己是主节点

解决方案：

# 确保配置合理的超时时间
cluster.election.duration: 500ms
cluster.election.max_timeout: 10s

注意事项 #

1. 静态配置：修改需要重启节点
2. 网络延迟：根据实际网络延迟设置合适的值
3. 与 initial_timeout 配合：确保 initial_timeout < duration
4. 与 max_timeout 配合：确保 duration < max_timeout
5. 避免过长：过长的 duration 会导致故障恢复缓慢
6. 避免过短：过短的 duration 可能导致选举失败