配置集群级属性

最近更新时间:2026-05-09 16:59:04

我的收藏

操作场景

集群级属性配置允许您在实例维度统一调整数据保留策略。通过合理配置 Offset 保留时长与事务 ID 过期时间,您可以根据业务需求优化集群的存储压力及事务处理的可靠性。

参数说明

修改提交后,配置将即时生效,无需重启实例。在控制台修改参数前,请参考以下说明:
参数名称
说明
取值范围
默认值
注意事项
Offset 保留时长
清理逻辑:当消费组状态为 Empty(无活跃成员)且其存储的所有 Offset(位点)均已过期时,系统将判定该消费组生命周期结束,并执行自动清理。
清理时长:由实例的 Offset 保留时长 决定。
1天 - 90天
7天
Offset 一旦被清理,当消费者重新上线时,将根据 auto.offset.reset 配置重新确定起始位点,可能导致消息重复消费或丢失。
事务 ID 过期时间
控制事务 ID(Transactional ID)的最大空闲时长。如果在此时间内该事务 ID 未发起任何事务操作,其将被标记为过期。
1小时 - 7天
7天
若业务使用了事务消息(Transactional Message),请确保事务 ID 过期时间大于业务逻辑的生产者发送事务消息最大空闲间隔,避免因事务 ID 过期导致生产失败。
注意:
CKafka 支持多种时间单位(如秒、分钟、小时、天)以适配不同业务场景。系统执行最小值校验时,会统一转换至该配置项的最小允许量级。
例如:若某项配置的取值范围最小值设定为 “ 1 天” ,则输入 “ 60 秒” 或其他等值但低于 1 天的数值将无法通过合规性检测。请在配置时务必确保数值转换后不低于该项定义的最小值。

操作步骤

1. 登录 CKafka 控制台
2. 在左侧导航栏选择实例列表,选择好地域后单击目标实例的“ID”,进入实例基本信息页面。
3. 集群级属性模块,单击右上角的修改配置,根据业务需求调整数值。

4. 单击提交,系统提示设置成功后即可完成配置。