- 最新动态
- 功能总览
- 服务公告
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- 开发指南
- API参考
- SDK参考
-
常见问题
-
实例问题
- 为什么可用区不能选择2个?
- 创建实例时为什么无法查看子网和安全组等信息?
- 如何选择Kafka实例的存储空间?
- Kafka实例的超高IO和高IO如何选择?
- 如何选择Kafka实例存储容量阈值策略?
- Kafka服务端支持版本是多少?
- Kafka实例的ZK地址是什么?
- 创建的Kafka实例是集群模式么?
- Kafka实例是否支持修改访问端口?
- Kafka实例的SSL证书有效期多长?
- 如何将Kafka实例中的数据同步到另一个Kafka实例中?
- Kafka实例的SASL_SSL开关如何修改?
- SASL认证机制如何修改?
- 如何修改安全协议?
- 修改企业项目,是否会导致Kafka重启?
- 100MB/s的带宽怎样开启公网访问?
- Kafka服务和ZK是部署在相同的虚拟机中,还是分开部署?
- Kafka包周期实例支持删除吗?
- Kafka支持哪些加密套件?
- 购买实例时选择的单AZ,怎样可以扩展为多AZ?
- Kafka是否支持跨AZ容灾?已经购买的实例在哪里查看是否为跨AZ?
- Kafka支持磁盘加密吗?
- Kafka实例创建后,能修改VPC和子网吗?
- 有没有Kafka Stream的案例?
- Kafka实例版本可以升级吗?
- 怎样重新绑定公网IP?
- 实例规格变更问题
-
连接问题
- 选择和配置安全组
- Kafka实例是否支持公网访问?
- Kafka实例的连接地址默认有多少个?
- 是否支持跨Region访问?
- Kafka实例是否支持跨VPC访问?
- Kafka实例是否支持不同的子网?
- Kafka是否支持Kerberos认证,如何开启认证?
- Kafka实例是否支持无密码访问?
- 开启公网访问后,在哪查看公网IP地址?
- Kafka支持服务端认证客户端吗?
- 连接开启SASL_SSL的Kafka实例时,ssl truststore文件可以用PEM格式的吗?
- 下载的证书JKS和CRT有什么区别?
- Kafka支持哪个版本的TLS?
- Kafka实例连接数有限制吗?
- 客户端单IP连接的个数为多少?
- Kafka实例的内网连接地址可以修改吗?
- 不同实例中,使用的SSL证书是否一样?
- 为什么不建议使用Sarama客户端收发消息?
- Topic和分区问题
- 消费组问题
- 消息问题
-
Kafka Manager问题
- 登录Kafka Manager的账号是否可以设置为只读账号?
- 登录到Kafka Manager页面,为什么获取不到节点信息?
- Yikes! Insufficient partition balance when creating topic : projectman_project_enterprise_project Try again.
- Kafka Manager能否查询到消息的正文?
- Kafka Manager WebUI的端口能否修改?
- 在Kafka Manager上支持修改Topic的哪些属性?
- Kafka Manager和云监控显示的信息不一致
- Kafka Manager如何修改Topic的分区Leader?
- 实例版本在控制台和Kafka Manager上显示不一致?
- 为什么实例中存在默认名为__trace和__consumer_offsets的Topic?
- 客户端删除消费组后,在Kafka Manager中仍可以看到此消费组?
- 监控告警问题
- Kafka体验版使用说明
-
实例问题
- 故障排除
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
修改Kafka实例配置参数
分布式消息服务Kafka版为实例、Topic、消费者提供了几个常用配置参数的默认值,您可以根据实际业务需求,在控制台自行修改参数值。其他在控制台未列出的配置参数,请参考Kafka配置进行修改。
Kafka实例的参数分为动态参数和静态参数:
- 动态参数:动态参数修改成功后,无需重启实例,立即生效。
- 静态参数:静态参数修改成功后,需要手动重启实例才能生效。
约束与限制
- 部分老实例不支持修改配置参数,具体以控制台为准,请联系客服解决。
- 单机实例不支持修改配置参数。
前提条件
Kafka实例的状态为“运行中”时,才能修改配置参数。
修改Kafka实例配置参数
- 登录管理控制台。
- 在管理控制台左上角单击
,选择Kafka实例所在的区域。
- 在管理控制台左上角单击
,选择“应用中间件 > 分布式消息服务Kafka版”,进入分布式消息服务Kafka专享版页面。
- 在左侧导航栏单击“Kafka实例”,进入Kafka实例列表页面。
- 单击Kafka实例的名称,进入实例详情页面。
- 在“配置参数”页面,在待修改参数所在行,单击“编辑”,修改配置参数。
1.1.0版本实例的参数说明如表1和表2所示,2.3.0/2.7/3.x版本实例的参数说明如表3和表4所示。
表1 动态参数说明(1.1.0版本) 参数
参数说明
参数范围
默认值
auto.create.groups.enable
是否开启自动创建消费组功能。
2023年4月25日及以后创建的实例支持在控制台修改此参数,在此之前创建的实例默认开启自动创建消费组功能,无法在控制台关闭此功能。
true/false
true
offsets.retention.minutes
消费位点保留时间是消费位点最大保留时间,从提交消费位点的时间开始计算,超过该时间的消费位点将被删除。消费者每次向Topic分区提交一次消费位点时,该消费位点的保留时间将会被重置为0。
2023年5月1日前创建的实例,此参数为静态参数。
1440 ~ 30240
单位:分钟
20160
表2 静态参数说明(1.1.0版本) 参数
参数说明
参数范围
默认值
min.insync.replicas
当producer将acks设置为“all”(或“-1”)时,此配置指定必须确认写入才能被认为成功的副本的最小数量。
1 ~ 3
1
message.max.bytes
单条消息的最大长度。
0 ~ 10485760
单位:字节
10485760
unclean.leader.election.enable
指示是否启用不在ISR集合中的副本选为领导者作为最后的手段,即使这样做可能导致数据丢失。
true/false
false
connections.max.idle.ms
此参数用来指定在多少毫秒之后,关闭空闲的连接。
5000 ~ 600000
单位:毫秒
600000
log.retention.hours
日志文件最大保存时间。
如果Topic已经设置了老化时间,则此参数对此Topic不生效。仅在Topic未设置老化时间时,此参数才对此Topic生效。
1 ~ 168
单位:小时
72
max.connections.per.ip
每个IP允许的最大连接数。超过此连接数的连接请求将被丢弃。
100 ~ 20000
1000
group.max.session.timeout.ms
consumer允许的最大会话超时时间。超时时间越长,consumer就能在心跳探测周期内有更多时间处理消息,但也会使故障检测花费更长时间。
6000 ~ 1800000
单位:毫秒
1800000
default.replication.factor
自动创建Topic时的默认副本个数。
1 ~ 3
3
allow.everyone.if.no.acl.found
- 如果设置为true,没有给资源配置ACL时,允许所有用户访问。
- 如果设置为false,初始用户拥有所有操作的权限,其他用户需要配置权限才能进行对应的操作。
仅在实例开启密文接入时,存在此参数。
2023年9月15日前创建的实例不支持修改此参数。
true/false
true
num.partitions
自动创建Topic时的默认分区数。
1 ~ 200
3
group.min.session.timeout.ms
consumer允许的最小会话超时时间。超时时间越短,consumer的心跳探测越频繁,可以使故障检测更快,但会导致broker被抢占更多的资源。
6000 ~ 300000
单位:毫秒
6000
表3 动态参数说明(2.3.0/2.7/3.x版本) 参数
参数说明
参数范围
默认值
min.insync.replicas
当producer将acks设置为“all”(或“-1”)时,此配置指定必须确认写入才能被认为成功的副本的最小数量。
1 ~ 3
1
message.max.bytes
单条消息的最大长度。
0 ~ 10485760
单位:字节
10485760
auto.create.groups.enable
是否开启自动创建消费组功能。
2023年4月25日及以后创建的实例支持在控制台修改此参数,在此之前创建的实例默认开启自动创建消费组功能,无法在控制台关闭此功能。
true/false
true
max.connections.per.ip
每个IP允许的最大连接数。超过此连接数的连接请求将被丢弃。
100 ~ 20000
1000
unclean.leader.election.enable
指示是否启用不在ISR集合中的副本选为领导者作为最后的手段,即使这样做可能导致数据丢失。
true/false
false
offsets.retention.minutes
消费位点保留时间是消费位点最大保留时间,从提交消费位点的时间开始计算,超过该时间的消费位点将被删除。消费者每次向Topic分区提交一次消费位点时,该消费位点的保留时间将会被重置为0。
2023年5月1日前创建的实例,此参数为静态参数。
1440 ~ 30240
单位:分钟
20160
表4 静态参数说明(2.3.0/2.7/3.x版本) 参数
参数说明
参数范围
默认值
connections.max.idle.ms
此参数用来指定在多少毫秒之后,关闭空闲的连接。
5000 ~ 600000
单位:毫秒
600000
log.retention.hours
日志文件最大保存时间。
如果Topic已经设置了老化时间,则此参数对此Topic不生效。仅在Topic未设置老化时间时,此参数才对此Topic生效。
1 ~ 168
单位:小时
72
group.max.session.timeout.ms
consumer允许的最大会话超时时间。超时时间越长,consumer就能在心跳探测周期内有更多时间处理消息,但也会使故障检测花费更长时间。
6000 ~ 1800000
单位:毫秒
1800000
default.replication.factor
自动创建Topic时的默认副本个数。
1 ~ 3
3
allow.everyone.if.no.acl.found
- 如果设置为true,没有给资源配置ACL时,允许所有用户访问。
- 如果设置为false,初始用户拥有所有操作的权限,其他用户需要配置权限才能进行对应的操作。
仅在实例开启密文接入时,存在此参数。
2023年9月15日前创建的实例不支持修改此参数。
true/false
true
num.partitions
自动创建Topic时的默认分区数。
1 ~ 200
3
group.min.session.timeout.ms
consumer允许的最小会话超时时间。超时时间越短,consumer的心跳探测越频繁,可以使故障检测更快,但会导致broker被抢占更多的资源。
6000 ~ 300000
单位:毫秒
6000
- 如果需要批量修改参数,单击“批量编辑”,可以一次性编辑多个动态参数或静态参数的运行值。
- 如果需要恢复默认值,在待修改参数后,单击“恢复默认”。
- 单击“保存”,完成参数的修改。
动态参数修改成功后,无需重启实例,立即生效。静态参数修改成功后,需要手动重启实例才能生效。