Elasticsearch运维常见问题与调试指南

• 分片长期处于UNASSIGNED 状态
• 集群健康状态为yellow或red

• 节点资源不足（磁盘、CPU、内存）
• 分片分配策略限制（如cluster.routing.allocation配置）
• 索引配置问题（如index.routing.allocation设置）
• 主分片丢失（数据损坏或节点故障）

GET _cat/shards?v&h=index,shard,prirep,state,node,unassigned.reason&s=state

GET _cluster/allocation/explain?pretty

• 手动分配分片（适用于已知数据安全的情况）：

POST _cluster/reroute
{
  "commands": [
    {
      "allocate_stale_primary": {
        "index": "my_index",
        "shard": 0,
        "node": "target_node",
        "accept_data_loss": true
      }
    }
  ]
}

• 调整分片分配策略（如放宽磁盘阈值）：

PUT _cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.disk.watermark.low": "90%",
    "cluster.routing.allocation.disk.watermark.high": "95%"
  }
}

• Elasticsearch 进程崩溃，日志出现OutOfMemoryError
• 节点频繁重启

• 堆内存（Heap）不足（-Xms和-Xmx设置不合理）
• 字段数据（Fielddata）占用过高
• 聚合查询或大查询消耗内存
• JVM 内存泄漏

# config/jvm.options
-Xms4g 
-Xmx4g

PUT _cluster/settings
{
  "persistent": {
    "indices.breaker.fielddata.limit": "60%"
  }
}

• 使用 size 限制返回数据量
• 避免 "size": 0 + 大聚合

GET _nodes/stats/jvm

• 集群分裂成多个独立子集群
• 数据不一致，部分节点无法加入集群

• 网络分区（节点间通信中断）
• 主节点选举配置不当（discovery.zen.minimum_master_nodes未正确设置）

# elasticsearch.yml
discovery.zen.minimum_master_nodes: (master_eligible_nodes / 2) + 1

cluster.initial_master_nodes: ["node4", "node5", "node6"]

• 使用多AZ部署 避免单点故障
• 监控节点间网络延迟

• 索引无法打开，报CorruptIndexException
• 分片状态为CORRUPT

• 磁盘故障
• JVM崩溃导致数据未正确写入
• 服务器异常断电或强制终止进程

/export/home/elasticsearch-7.10.1/bin/elasticsearch-shard --index my_index --shard 0 --check

POST my_index/_recover

POST _reindex
{
  "source": { "index": "corrupted_index" },
  "dest": { "index": "recovered_index" }
}