---
title: "分片分配磁盘水位配置"
date: 2026-03-02
lastmod: 2026-03-02
description: "控制磁盘水位阈值的配置说明"
tags: ["分片分配", "磁盘水位", "存储管理"]
summary: "配置项概述 #  磁盘水位配置项用于控制基于磁盘使用率的分片分配决策。
   配置项 默认值 说明     cluster.routing.allocation.disk.watermark.low 85% 低水位   cluster.routing.allocation.disk.watermark.high 90% 高水位   cluster.routing.allocation.disk.watermark.flood_stage 95% 洪水阶段水位    cluster.routing.allocation.disk.watermark.low #  配置项作用：低水位阈值，当磁盘使用率低于此值时，允许分片分配到该节点。
默认值：85%
配置格式：
cluster.routing.allocation.disk.watermark.low: 85% cluster.routing.allocation.disk.watermark.high #  配置项作用：高水位阈值，当磁盘使用率超过此值时，停止分配新分片到该节点。
默认值：90%
配置格式：
cluster.routing.allocation.disk.watermark.high: 90% cluster.routing.allocation.disk.watermark.flood_stage #  配置项作用：洪水阶段水位，当磁盘使用率超过此值时，索引将设置为只读模式。
默认值：95%
配置格式：
cluster.routing.allocation.disk.watermark.flood_stage: 95% 工作原理 #  ┌─────────────────────────────────────────────────────────┐ │ 磁盘水位管理 │ └─────────────────────────────────────────────────────────┘ 磁盘使用率 │ ├── < 85% (低水位) │ └── 正常分配分片 │ ├── 85% - 90% │ └── 不分配新分片 │ ├── 90% - 95% │ └── 迁移分片到其他节点 │ └── >= 95% (洪水阶段) └── 索引设为只读 推荐设置 #     环境 low high flood_stage     默认 85% 90% 95%   大容量 90% 95% 98%   安全模式 75% 80% 85%    配置验证 #  # 查看当前配置 GET /_cluster/settings?"
---


## 配置项概述

磁盘水位配置项用于控制基于磁盘使用率的分片分配决策。

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `cluster.routing.allocation.disk.watermark.low` | 85% | 低水位 |
| `cluster.routing.allocation.disk.watermark.high` | 90% | 高水位 |
| `cluster.routing.allocation.disk.watermark.flood_stage` | 95% | 洪水阶段水位 |

## cluster.routing.allocation.disk.watermark.low

**配置项作用**：低水位阈值，当磁盘使用率低于此值时，允许分片分配到该节点。

**默认值**：`85%`

**配置格式**：
```yaml
cluster.routing.allocation.disk.watermark.low: 85%
```

## cluster.routing.allocation.disk.watermark.high

**配置项作用**：高水位阈值，当磁盘使用率超过此值时，停止分配新分片到该节点。

**默认值**：`90%`

**配置格式**：
```yaml
cluster.routing.allocation.disk.watermark.high: 90%
```

## cluster.routing.allocation.disk.watermark.flood_stage

**配置项作用**：洪水阶段水位，当磁盘使用率超过此值时，索引将设置为只读模式。

**默认值**：`95%`

**配置格式**：
```yaml
cluster.routing.allocation.disk.watermark.flood_stage: 95%
```

## 工作原理

```
┌─────────────────────────────────────────────────────────┐
│                   磁盘水位管理                            │
└─────────────────────────────────────────────────────────┘

磁盘使用率
    │
    ├── < 85% (低水位)
    │   └── 正常分配分片
    │
    ├── 85% - 90%
    │   └── 不分配新分片
    │
    ├── 90% - 95%
    │   └── 迁移分片到其他节点
    │
    └── >= 95% (洪水阶段)
        └── 索引设为只读
```

## 推荐设置

| 环境 | low | high | flood_stage |
|------|-----|------|-------------|
| 默认 | 85% | 90% | 95% |
| 大容量 | 90% | 95% | 98% |
| 安全模式 | 75% | 80% | 85% |

## 配置验证

```bash
# 查看当前配置
GET /_cluster/settings?filter_path=*.cluster.routing.allocation.disk.watermark.*

# 查看磁盘使用情况
GET /_cat/allocation?v&h=name,disk.used_percent
```

## 注意事项

1. **动态配置**：可以在运行时修改
2. **百分比格式**：使用百分比表示
3. **只读模式**：洪水阶段会影响写入
4. **磁盘监控**：应定期监控磁盘使用情况