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
- Faça logon no console de gerenciamento.
- Clique em
no canto superior esquerdo para selecionar uma região.
Selecione a região onde sua instância do Kafka está localizada.
- Clique em
e escolha Middleware > Distributed Message Service (for Kafka) para abrir o console do DMS for Kafka. - Clique na instância do Kafka desejada para exibir os detalhes da instância.
- 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.
- 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.
