修改配置参数
更新时间 2023-12-22 15:07:31
最近更新时间: 2023-12-22 15:07:31
本文主要介绍 修改配置参数。
操作场景
分布式消息服务Kafka为实例、Topic、消费者提供了几个常用配置参数的默认值，您可以根据实际业务需求，在控制台自行修改参数值。其他在控制台未列出的配置参数，请参考Kafka配置进行修改。
1.1.0版本实例的参数都为静态参数，2.3.0/2.7版本实例的参数分为动态参数和静态参数：
动态参数：动态参数修改成功后，无需重启实例，立即生效。
静态参数：静态参数修改成功后，需要手动重启实例才能生效。
说明部分老实例不支持修改配置参数，具体以控制台为准，此时请联系客服解决。
前提条件
Kafka实例的状态为“运行中”时，才能修改配置参数。
操作步骤
步骤 1 登录管理控制台。
步骤 2 在管理控制台右上角单击
，选择区域。
说明请选择Kafka实例所在的区域。
步骤 3 在管理控制台左上角单击
，选择“企业中间件”-“分布式消息服务”-“Kafka专享版”，进入分布式消息服务Kafka专享版页面。
步骤 4 单击Kafka实例的名称，进入实例详情页面。
步骤 5 在“配置参数”页签，在待修改参数所在行，单击“编辑”，修改配置参数。1.1.0版本实例的参数说明如下表所示，2.3.0/2.7版本实例的参数说明如下表所示。
表动态参数说明（1.1.0版本）
| 参数 | 参数说明 | 参数范围 | 默认值 |
|---|---|---|---|
| auto.create.groups.enable | 是否开启自动创建消费组功能。 | true/false | true |
表 静态参数说明（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 | true |
| 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允许的最大会话超时时间，单位为ms。超时时间越长，consumer就能在心跳探测周期内有更多时间处理消息，但也会使故障检测花费更长时间。 | 6000 ~ 1800000 | 1800000 |
| default.replication.factor | 自动创建Topic时的默认副本个数。 | 1 ~ 3 | 3 |
| num.partitions | 自动创建Topic时的默认分区数。 | 1 ~ 100 | 3 |
| group.min.session.timeout.ms | consumer允许的最小会话超时时间，单位为ms。超时时间越短，consumer的心跳探测越频繁，可以使故障检测更快，但会导致broker被抢占更多的资源。 | 6000 ~ 300000 | 6000 |
表动态参数说明（2.3.0/2.7版本）
| 参数 | 参数说明 | 参数范围 | 默认值 |
|---|---|---|---|
| min.insync.replicas | 当producer将acks设置为“all”(或“-1”)时，此配置指定必须确认写入才能被认为成功的副本的最小数量。 | 1 ~ 3 | 1 |
| message.max.bytes | 单条消息的最大长度（单位：字节）。 | 0 ~ 10485760 | 10485760 |
| auto.create.groups.enable | 是否开启自动创建消费组功能。 | true/false | true |
| max.connections.per.ip | 每个IP允许的最大连接数。超过此连接数的连接请求将被丢弃。 | 100 ~ 20000 | 1000 |
| unclean.leader.election.enable | 指示是否启用不在ISR集合中的副本选为领导者作为最后的手段，即使这样做可能导致数据丢失。 | true/false | true |
表静态参数说明（2.3.0/2.7版本）
| 参数 | 参数说明 | 参数范围 | 默认值 |
|---|---|---|---|
| connections.max.idle.ms | 此参数用来指定在多少毫秒之后，关闭空闲的连接。 | 5000 ~ 600000 | 600000 |
| log.retention.hours | 日志文件最大保存时间。单位为小时。如果Topic已经设置了老化时间，则此参数对此Topic不生效。仅在Topic未设置老化时间时，此参数才对此Topic生效。 | 1 ~ 168 | 72 |
| group.max.session.timeout.ms | consumer允许的最大会话超时时间，单位为ms。超时时间越长，consumer就能在心跳探测周期内有更多时间处理消息，但也会使故障检测花费更长时间。 | 6000 ~ 1800000 | 1800000 |
| default.replication.factor | 自动创建Topic时的默认副本个数。 | 1 ~ 3 | 3 |
| num.partitions | 自动创建Topic时的默认分区数。 | 1 ~ 100 | 3 |
| group.min.session.timeout.ms | consumer允许的最小会话超时时间，单位为ms。超时时间越短，consumer的心跳探测越频繁，可以使故障检测更快，但会导致broker被抢占更多的资源。 | 6000 ~ 300000 | 6000 |
说明如果需要批量修改参数，单击“批量编辑”，可以一次性编辑多个动态参数或静态参数的运行值。
如果需要恢复默认值，在待修改参数后，单击“恢复默认”。
步骤 6 单击“保存”，完成参数的修改。
说明
动态参数修改成功后，无需重启实例，立即生效。 静态参数修改成功后，需要手动重启实例才能生效。
