Modifying Kafka Instance Configuration Parameters

Prerequisites

You can modify configuration parameters of a Kafka instance when the instance is in the Running state.

Procedure

1. Log in to the console.
2. Click in the upper left corner to select a region.
   

   Select the region where your Kafka instance is located.

3. Click and choose Middleware > Distributed Message Service (for Kafka) to open the console of DMS for Kafka.
4. Click the desired Kafka instance to view the instance details.
5. On the Parameters page, click Edit in the row containing the parameter to modify.

   Parameters of v1.1.0 instances are described in Table 1 and Table 2. Parameters of v2.3.0/v2.7/3.x instances are described in Table 3 and Table 4.

   Table 1 Dynamic parameters (v1.1.0 instances)

   Parameter	Description	Value Range	Default Value
   auto.create.groups.enable	Whether to automatically create consumer groups. You can modify this parameter on the console only for instances created on or after April 25, 2023. For instances created before April 25, 2023, the function of automatically creating consumer groups is enabled by default and cannot be disabled on the console.	true/false	true
   offsets.retention.minutes	The longest period a consumption position can be retained starts from the time of submission. Positions retained beyond this duration will be deleted. Each time a consumption position is submitted to a topic partition, its retention period resets to 0. This is a static parameter for instances created before May 1, 2023.	1440–30240 Unit: minute	20160

   Table 2 Static parameters (v1.1.0 instances)

   Parameter	Description	Value Range	Default Value
   min.insync.replicas	If a producer sets the acks parameter to all (or -1), the min.insync.replicas parameter specifies the minimum number of replicas that must acknowledge a write for the write to be considered successful.	1–3	1
   message.max.bytes	Maximum length of a single message.	0–10,485,760 Unit: byte	10,485,760
   unclean.leader.election.enable	Indicates whether to allow replicas not in the ISR set to be elected as the leader as a last resort, even though doing so may result in data loss.	true or false	false
   connections.max.idle.ms	Idle connection timeout (in ms). Connections that are idle for the duration specified by this parameter will be closed.	5000–600,000 Unit: millisecond	600,000
   log.retention.hours	Maximum duration for storing log files. This parameter takes effect only for topics that have no aging time configured. If there is aging time configured for topics, it overrides this parameter.	1–168 Unit: hour	72
   max.connections.per.ip	The maximum number of connections allowed from each IP address. Request for new connections will be rejected once the limit is reached.	100–20,000	1000
   group.max.session.timeout.ms	Maximum session timeout for consumers. A longer timeout gives consumers more time to process messages between heartbeats but results in a longer time to detect failures.	6000–1,800,000 Unit: millisecond	1,800,000
   default.replication.factor	The default number of replicas configured for an automatically created topic.	1–3	3
   allow.everyone.if.no.acl.found	When this parameter is set to true, all users can access resources without ACL rules. This parameter is displayed only when is enabled for the instance or ciphertext access is used. This parameter cannot be modified for instances created before September 15, 2023.	true/false	true
   num.partitions	The default number of partitions configured for each automatically created topic.	1 ~ 200	3
   group.min.session.timeout.ms	Minimum session timeout for consumers. A shorter timeout enables quicker failure detection but results in more frequent consumer heartbeating, which can overwhelm broker resources.	6000–300,000 Unit: millisecond	6000

   Table 3 Dynamic parameters (v2.3.0/v2.7/v3.x)

   Parameter	Description	Value Range	Default Value
   min.insync.replicas	If a producer sets the acks parameter to all (or -1), the min.insync.replicas parameter specifies the minimum number of replicas that must acknowledge a write for the write to be considered successful.	1–3	1
   message.max.bytes	Maximum length of a single message.	0–10,485,760 Unit: byte	10,485,760
   auto.create.groups.enable	Whether to automatically create consumer groups. You can modify this parameter on the console only for instances created on or after April 25, 2023. For instances created before April 25, 2023, the function of automatically creating consumer groups is enabled by default and cannot be disabled on the console.	true/false	true
   max.connections.per.ip	The maximum number of connections allowed from each IP address. Request for new connections will be rejected once the limit is reached.	100–20,000	1000
   unclean.leader.election.enable	Indicates whether to allow replicas not in the ISR set to be elected as the leader as a last resort, even though doing so may result in data loss.	true or false	false
   offsets.retention.minutes	The longest period a consumption position can be retained starts from the time of submission. Positions retained beyond this duration will be deleted. Each time a consumption position is submitted to a topic partition, its retention period resets to 0. This is a static parameter for instances created before May 1, 2023.	1440–30240 Unit: minute	20160

   Table 4 Static parameters (v2.3.0/v2.7/v3.x)

   Parameter	Description	Value Range	Default Value
   connections.max.idle.ms	Idle connection timeout (in ms). Connections that are idle for the duration specified by this parameter will be closed.	5000–600,000 Unit: millisecond	600,000
   log.retention.hours	Maximum duration for storing log files. This parameter takes effect only for topics that have no aging time configured. If there is aging time configured for topics, it overrides this parameter.	1–168 Unit: hour	72
   group.max.session.timeout.ms	Maximum session timeout for consumers. A longer timeout gives consumers more time to process messages between heartbeats but results in a longer time to detect failures.	6000–1,800,000 Unit: millisecond	1,800,000
   default.replication.factor	The default number of replicas configured for an automatically created topic.	1–3	3
   allow.everyone.if.no.acl.found	When this parameter is set to true, all users can access resources without ACL rules. This parameter is displayed only when is enabled for the instance or ciphertext access is used. This parameter cannot be modified for instances created before September 15, 2023.	true/false	true
   num.partitions	The default number of partitions configured for each automatically created topic.	1 ~ 200	3
   group.min.session.timeout.ms	Minimum session timeout for consumers. A shorter timeout enables quicker failure detection but results in more frequent consumer heartbeating, which can overwhelm broker resources.	6000–300,000 Unit: millisecond	6000

   

   • To modify multiple dynamic or static parameters at a time, click Modify above the parameter list.
   • If you want to restore the default values, click Restore Default in the row containing the desired parameter.

6. Click Save.
   

   Modifying dynamic parameters will not restart the instance. Static parameter modification requires manual restart of the instance.