操作场景
集群级属性配置允许您在实例维度统一调整数据保留策略。通过合理配置 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. 单击提交,系统提示设置成功后即可完成配置。