Modificação de parâmetros do Kafka

Cenário

Suas instâncias, tópicos e consumidores do Kafka vêm com definições de parâmetros de configuração padrão. Você pode modificar parâmetros comuns no console do Kafka. Para obter detalhes sobre os parâmetros que não estão listados no console, consulte o site oficial do Kafka.

As instâncias de Kafka têm parâmetros dinâmicos e estáticos:

• Parâmetros dinâmicos: a modificação de parâmetros dinâmicos não reiniciará a instância.
• Parâmetros estáticos: depois que os parâmetros estáticos são modificados, você deve reiniciar manualmente a instância.

Os parâmetros de configuração de algumas instâncias anteriores não podem ser modificados. Verifique se os parâmetros da instância podem ser modificados no console. Se não puderem ser modificados, entre em contato com o atendimento ao cliente.

Pré-requisitos

Você pode modificar os parâmetros de configuração de uma instância do Kafka quando a instância estiver no estado Running.

Procedimento

1. Faça logon no console de gerenciamento.
2. Clique em no canto superior esquerdo para selecionar uma região.
   

   Selecione a região onde sua instância do Kafka está localizada.

3. Clique em e escolha Middleware > Distributed Message Service (for Kafka) para abrir o console do DMS for Kafka.
4. Clique na instância do Kafka desejada para exibir os detalhes da instância.
5. Na página Parameters, clique em Edit na linha que contém o parâmetro a ser modificado. Os parâmetros das instâncias v1.1.0 são descritos em Tabela 2 e Tabela 1. Os parâmetros das instâncias v2.3.0/v2.7 são descritos em Tabela 3 e Tabela 4.

   Tabela 1 Parâmetros dinâmicos (instâncias v1.1.0)

   Parâmetro	Descrição	Intervalo de valor	Valor padrão
   auto.create.groups.enable	Se criar automaticamente grupos de consumidores. Você pode modificar esse parâmetro no console somente para instâncias criadas em ou após 25 de abril de 2023. Para instâncias criadas antes de 25 de abril de 2023, a função de criar grupos de consumidores automaticamente é ativada por padrão e não pode ser desativada no console.	true/false	true
   offsets.retention.minutes	O período mais longo que uma posição de consumo pode ser mantida começa a partir do momento da submissão. As posições retidas para além desta duração serão eliminadas. Cada vez que uma posição de consumo é submetida a uma partição de tópico, seu período de retenção é redefinido para 0. A unidade é minuto. Este é um parâmetro estático para instâncias criadas antes de 1º de maio de 2023.	1440–30240	20160

   Tabela 2 Parâmetros estáticos (instâncias v1.1.0)

   Parâmetro	Descrição	Intervalo de valor	Valor padrão
   min.insync.replicas	Se um produtor definir o parâmetro acks como all (ou -1), o parâmetro min.insync.replicas especificará a quantidade mínima de réplicas que devem reconhecer uma gravação para que a gravação seja considerada bem-sucedida.	1–3	1
   message.max.bytes	O comprimento máximo de uma única mensagem, em bytes.	0–10.485.760	10.485.760
   unclean.leader.election.enable	Indica se deve permitir que réplicas que não estejam no conjunto de ISR sejam eleitas como líder como um último recurso, mesmo que isso possa resultar em perda de dados.	true ou false	true
   connections.max.idle.ms	Tempo limite de conexão ociosa (em ms). As conexões que estiverem ociosas pela duração especificada por este parâmetro serão fechadas.	5000–600.000	600.000
   log.retention.hours	Duração (em horas) para reter um arquivo de log. Este parâmetro tem efeito somente para tópicos que não têm tempo de envelhecimento configurado. Se houver tempo de envelhecimento configurado para tópicos, ele substituirá esse parâmetro.	1–168	72
   max.connections.per.ip	A quantidade máxima de conexões permitida de cada endereço IP. A solicitação de novas conexões será rejeitada quando o limite for atingido.	100–20.000	1000
   group.max.session.timeout.ms	O tempo limite máximo de sessão (em ms) para os consumidores. Um tempo limite mais longo dá aos consumidores mais tempo para processar mensagens entre batimentos cardíacos, mas resulta em um tempo mais longo para detectar falhas.	6000–1.800.000	1.800.000
   default.replication.factor	A quantidade padrão de réplicas configuradas para um tópico criado automaticamente.	1–3	3
   allow.everyone.if.no.acl.found	Quando esse parâmetro é definido como true, todos os usuários podem acessar recursos sem regras de ACL. Este parâmetro é exibido somente quando SASL está habilitada para a instância ou o acesso ao texto cifrado é usado. Este parâmetro não pode ser modificado para instâncias criadas antes de 15 de setembro de 2023.	true/false	true
   num.partitions	A quantidade padrão de partições configuradas para cada tópico criado automaticamente.	1–100	3
   group.min.session.timeout.ms	O tempo limite mínimo de sessão (em ms) para os consumidores. Um tempo limite mais curto possibilita maior rapidez na detecção de falhas, mas resulta em uma maior frequência dos batimentos cardíacos de consumidores, podendo sobrecarregar recursos do broker.	6000–300.000	6000

   Tabela 3 Parâmetros dinâmicos (instâncias v2.3.0/v2.7)

   Parâmetro	Descrição	Intervalo de valor	Valor padrão
   min.insync.replicas	Se um produtor definir o parâmetro acks como all (ou -1), o parâmetro min.insync.replicas especificará a quantidade mínima de réplicas que devem reconhecer uma gravação para que a gravação seja considerada bem-sucedida.	1–3	1
   message.max.bytes	O comprimento máximo de uma única mensagem, em bytes.	0–10.485.760	10.485.760
   auto.create.groups.enable	Se criar automaticamente grupos de consumidores. Você pode modificar esse parâmetro no console somente para instâncias criadas em ou após 25 de abril de 2023. Para instâncias criadas antes de 25 de abril de 2023, a função de criar grupos de consumidores automaticamente é ativada por padrão e não pode ser desativada no console.	true/false	true
   max.connections.per.ip	A quantidade máxima de conexões permitida de cada endereço IP. A solicitação de novas conexões será rejeitada quando o limite for atingido.	100–20.000	1000
   unclean.leader.election.enable	Indica se deve permitir que réplicas que não estejam no conjunto de ISR sejam eleitas como líder como um último recurso, mesmo que isso possa resultar em perda de dados.	true ou false	true
   offsets.retention.minutes	O período mais longo que uma posição de consumo pode ser mantida começa a partir do momento da submissão. As posições retidas para além desta duração serão eliminadas. Cada vez que uma posição de consumo é submetida a uma partição de tópico, seu período de retenção é redefinido para 0. A unidade é minuto. Este é um parâmetro estático para instâncias criadas antes de 1º de maio de 2023.	1440–30240	20160

   Tabela 4 Parâmetros estáticos (instâncias v2.3.0/v2.7)

   Parâmetro	Descrição	Intervalo de valor	Valor padrão
   connections.max.idle.ms	Tempo limite de conexão ociosa (em ms). As conexões que estiverem ociosas pela duração especificada por este parâmetro serão fechadas.	5000–600.000	600.000
   log.retention.hours	Duração (em horas) para reter um arquivo de log. Este parâmetro tem efeito somente para tópicos que não têm tempo de envelhecimento configurado. Se houver tempo de envelhecimento configurado para tópicos, ele substituirá esse parâmetro.	1–168	72
   group.max.session.timeout.ms	O tempo limite máximo de sessão (em ms) para os consumidores. Um tempo limite mais longo dá aos consumidores mais tempo para processar mensagens entre batimentos cardíacos, mas resulta em um tempo mais longo para detectar falhas.	6000–1.800.000	1.800.000
   default.replication.factor	A quantidade padrão de réplicas configuradas para um tópico criado automaticamente.	1–3	3
   allow.everyone.if.no.acl.found	Quando esse parâmetro é definido como true, todos os usuários podem acessar aos recursos sem ACL. Este parâmetro é exibido somente quando SASL está habilitada para a instância ou o acesso ao texto cifrado é usado. Este parâmetro não pode ser modificado para instâncias criadas antes de 15 de setembro de 2023.	true/false	true
   num.partitions	A quantidade padrão de partições configuradas para cada tópico criado automaticamente.	1–100	3
   group.min.session.timeout.ms	O tempo limite mínimo de sessão (em ms) para os consumidores. Um tempo limite mais curto possibilita maior rapidez na detecção de falhas, mas resulta em uma maior frequência dos batimentos cardíacos de consumidores, podendo sobrecarregar recursos do broker.	6000–300.000	6000

   

   • Para modificar vários parâmetros dinâmicos ou estáticos ao mesmo tempo, clique em Modify acima da lista de parâmetros.
   • Se desejar restaurar os valores padrão, clique em Restore Default na linha que contém o parâmetro desejado.

6. Clique em Save.
   

   Modificar parâmetros dinâmicos não reiniciará a instância. A modificação do parâmetro estático requer a reinicialização manual da instância.