文档中心

消息队列 Kafka版

请输入

实例运维

设置磁盘清理水位

当 Kafka 实例的磁盘使用率超过预设的磁盘清理水位时，后端服务会自动删除旧消息，直至磁盘水位恢复。本文档介绍修改磁盘清理水位的方式。

背景信息

Kafka 实例每个 Broker 的磁盘清理水位相同。如果 Kafka 实例整体磁盘使用率达到磁盘清理水位，或因数据不均衡导致某个 Broker 的磁盘使用率达到磁盘清理水位时，无论消息是否超过消息保留时长，都会按服务端存储消息的时间先后顺序删除对应节点的部分历史消息，直至磁盘水位恢复。避免磁盘使用率过高导致 Kafka 实例异常，以及避免因节点无法同步数据导致的副本不同步。

Kafka 实例默认的磁盘清理水位为 90%，您也可以在实例管理页面自行设置磁盘清理水位，支持设置的范围为 70%~90%。

说明

如果实例当前的磁盘使用率已超过新的水位值，则缩短磁盘清理水位可能会引发实例自动清理已超出水位的数据，请谨慎修改。

推荐设置 Broker 磁盘容量的阈值监控告警，在磁盘使用率接近清理水位之前及时处理，避免消息在自然老化前被删除。推荐设置的告警策略请参考实例磁盘使用容量超过 30% 且磁盘倾斜率超过 30%。

Kafka 3.7.1 版本暂不支持设置磁盘清理水位。

操作步骤

登录消息队列 Kafka版控制台。

在顶部菜单栏中选择实例所在的地域。

在实例列表页面单击指定实例名称。

在实例详情页签的实例配置区域，找到磁盘清理水位。

单击对应的编辑图标，并重新设置磁盘清理水位。

单击确定。

最近更新时间：2026.06.08 15:06:46

这个页面对您有帮助吗？

有用

无用