{
  "id": "redis/sentinel-arbiter-unreachable-failover-delayed",
  "signature": "SENTINEL: arbiter node unreachable, failover delayed for master 'mymaster'",
  "signature_zh": "SENTINEL：仲裁节点不可达，针对主节点 'mymaster' 的故障转移延迟",
  "regex": "SENTINEL: arbiter node unreachable, failover delayed for master '.+'",
  "domain": "redis",
  "category": "network_error",
  "subcategory": null,
  "root_cause": "Sentinel cannot connect to the arbiter node (a Redis instance configured as quorum participant) within the failover timeout, preventing the quorum from being reached and delaying failover.",
  "root_cause_type": "generic",
  "root_cause_zh": "Sentinel 无法在故障转移超时内连接到仲裁节点（配置为法定人数参与的 Redis 实例），阻止达成法定人数并延迟故障转移。",
  "versions": [
    {
      "version": "Redis 6.2.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Redis 7.0.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Redis 7.2.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Increasing sentinel failover timeout (sentinel failover-timeout mymaster 60000) may allow more time but doesn't fix the underlying network or arbiter issue.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Removing the arbiter from the configuration reduces quorum resilience and may cause split-brain scenarios.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Restarting the arbiter without checking its network connectivity or configuration will result in the same unreachable state.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Check the arbiter's network connectivity using ping and redis-cli -h <arbiter-ip> -p <port> PING, then fix firewall rules or DNS resolution if needed.",
      "success_rate": 0.85,
      "how": "Check the arbiter's network connectivity using ping and redis-cli -h <arbiter-ip> -p <port> PING, then fix firewall rules or DNS resolution if needed.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Temporarily adjust the quorum to exclude the arbiter by reducing sentinel monitor mymaster <ip> <port> <quorum> to a lower value (e.g., from 3 to 2) until the arbiter is restored.",
      "success_rate": 0.75,
      "how": "Temporarily adjust the quorum to exclude the arbiter by reducing sentinel monitor mymaster <ip> <port> <quorum> to a lower value (e.g., from 3 to 2) until the arbiter is restored.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Ensure the arbiter Redis instance is running with a minimal configuration (e.g., port 26379) and is reachable from all sentinel nodes; verify sentinel.conf for correct arbiter IP.",
      "success_rate": 0.8,
      "how": "Ensure the arbiter Redis instance is running with a minimal configuration (e.g., port 26379) and is reachable from all sentinel nodes; verify sentinel.conf for correct arbiter IP.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "使用 ping 和 redis-cli -h <arbiter-ip> -p <port> PING 检查仲裁节点的网络连接，然后根据需要修复防火墙规则或 DNS 解析。",
    "通过将 sentinel monitor mymaster <ip> <port> <quorum> 降低到较小值（例如从 3 降到 2），临时调整法定人数以排除仲裁节点，直到仲裁节点恢复。",
    "确保仲裁 Redis 实例以最小配置运行（例如端口 26379），并且所有 Sentinel 节点都可访问；验证 sentinel.conf 中的仲裁节点 IP 是否正确。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://redis.io/docs/latest/operate/oss_and_stack/management/sentinel/",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.86,
  "fix_success_rate": 0.82,
  "resolvable": "partial",
  "first_seen": "2024-11-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}