Atualize um cluster no Timestream para o InfluxDB 3

Depois que seu cluster for criado, você poderá modificar determinados parâmetros de configuração para se adaptar às mudanças nos requisitos de workload no Amazon Timestream. Observar que algumas modificações podem causar tempo de inatividade temporário durante o processo de atualização.

Atualize um cluster usando o Console de gerenciamento da AWS

1. Faça login no AWS Management Console e abra o console Amazon Timestream for InfluxDB.

2. No painel de navegação, escolha bancos de dados InfluxDB.

3. Selecione o cluster que deseja modificar.

4. Escolha Modificar.

5. Atualize as configurações disponíveis:

   • Classe de instância: aumente ou diminua os recursos de computação (aplica-se a todos os nós do cluster e requer a reinicialização do cluster).

   • Grupo de parâmetros: associe um grupo de parâmetros diferente para alterar a configuração do mecanismo ou a forma do cluster (requer reinicialização do cluster).

   • Configuração de entrega de registros: habilite ou modifique a exportação de CloudWatch registros.

   • Edição: Atualização do Core para o Enterprise (unidirecional). Para obter detalhes, consulte Atualização da edição Core para a Enterprise.

6. Selecione Continuar para revisar suas escolhas.

7. Selecione quando aplicar as alterações:

   • Aplique imediatamente: as alterações são aplicadas imediatamente (podem causar um breve tempo de inatividade).

8. Escolha Modificar Cluster.

Atualize um cluster usando o AWS CLI

Atualize o tipo de instância:

aws timestream-influxdb update-db-cluster \
  --region us-east-1 \
  --identifier "my-influxdb3-cluster" \
  --db-instance-type db.influxIOIncluded.2xlarge \
  --apply-immediately

Atualizar grupo de parâmetros (incluindo escalabilidade de cluster):

Para modificar a configuração do cluster, incluindo a escalabilidade do número de nós, crie um novo grupo de parâmetros com a configuração desejada e aplique-o ao cluster:

# Step 1: Create a new parameter group with desired node configuration
aws timestream-influxdb create-db-parameter-group \
  --name "scaled-enterprise-pg" \
  --parameters '{
    "InfluxDBv3Enterprise": {
      "ingestQueryInstances": 4,
      "queryOnlyInstances": 10,
      "dedicatedCompactor": true,
      "dataFusionNumThreads": 8,
      "bufferMemLimitMb": 32768
    }
  }'

# Step 2: Apply the new parameter group to your cluster using the parameter group identifier
aws timestream-influxdb update-db-cluster \
  --region us-east-1 \
  --identifier "my-influxdb3-cluster" \
  --db-parameter-group-identifier "<parameter-group-identifier>" \
  --apply-immediately

Dimensionando seu cluster (edição Enterprise)

Para clusters da edição Enterprise, você pode escalar o tamanho do cluster aplicando um novo grupo de parâmetros com a configuração de nó desejada. Para obter orientação detalhada, consulteEscalando um cluster.

• Aumente a escala: adicione nós aumentando ingestQueryInstances (até 4) ou queryOnlyInstances (até 13)

• Diminuir: remova os nós diminuindo esses valores

• Alterar os modos dos nós: ajuste a proporção de writer/reader nós em relação aos nós somente para leitores

Importante: clusters com 3 ou mais nós exigem um compactador dedicado (dedicatedCompactor: true). Ao escalar, os nós são distribuídos automaticamente em várias zonas de disponibilidade para alta disponibilidade.

Considerações ao atualizar um cluster

Parâmetros modificáveis

Os parâmetros a seguir podem ser modificados após a criação do cluster:

Parâmetro	Descrição	Impacto
Instance class	Aumente ou diminua a escala de compute/memory recursos	Requer reinicialização contínua dos nós
Grupo de parâmetros	Alterar a configuração do mecanismo de banco de dados ou a forma do cluster (contagem e modos de nós)	Requer reiniciar o cluster
Entrega de logs	Configurar exportação CloudWatch de registros	Aplicado imediatamente
Edição	Atualização do Core para o Enterprise (unidirecional). Consulte Atualização da edição Core para a Enterprise.	Requer reiniciar o cluster

Parâmetros não modificáveis

Os parâmetros a seguir não podem ser modificados após a criação do cluster:

• VPC e sub-redes: a localização da rede é fixa.

• Grupos de segurança: os controles de acesso à rede não podem ser alterados.

• Acessibilidade pública: a configuração de acessibilidade à internet é permanente.

• Identificador de cluster de banco de dados: o nome do cluster não pode ser alterado.

Impacto do tempo de inatividade:

• Mudanças na classe da instância: reinicialização contínua (tempo de inatividade mínimo com clusters de vários nós).

• Alterações no grupo de parâmetros (incluindo escalabilidade do cluster): é necessário reiniciar o cluster. Para clusters de vários nós usando endpoints de cluster, o tráfego é redistribuído automaticamente para os nós disponíveis durante o processo de atualização.

• Alterações na configuração do log: sem tempo de inatividade.

Práticas recomendadas:

• Planeje cuidadosamente a configuração da rede antes da criação do cluster, pois ela não pode ser alterada.

• Teste as alterações primeiro em ambientes que não sejam de produção.

• Monitore as métricas durante e após as atualizações para verificar o desempenho.

• Use endpoints de cluster para garantir um failover transparente durante atualizações contínuas e operações de escalabilidade.

• Evite endpoints específicos de nós durante as operações de atualização, pois nós individuais podem ser reiniciados ou substituídos.

• Ao escalar, considere seus padrões de carga de trabalho para determinar a proporção ideal entre nós e writer/reader nós somente para leitores.

Validação:

• O sistema valida todas as alterações antes de aplicá-las.

• As configurações inválidas são rejeitadas com mensagens de erro descritivas.

• Algumas combinações de parâmetros podem não ser compatíveis (por exemplo, clusters com mais de 3 nós exigem um compactador dedicado).

Reversão:

• Mantenha as configurações anteriores do grupo de parâmetros para facilitar a reversão.

• Documente as configurações atuais antes de fazer alterações.

• Para mudanças críticas, crie instantâneos do cluster antes da atualização.

• Para reverter uma operação de escalabilidade, crie um grupo de parâmetros com a configuração anterior do nó e aplique-o ao cluster.

Monitore o progresso da atualização

Acompanhe o status da atualização por meio de:

1. Console: o status do cluster mostra “Modificando” durante as atualizações.

2. CLI: status do cluster de consulta:

   aws timestream-influxdb get-db-cluster \
     --identifier "my-influxdb3-cluster"
   

   Os possíveis status de um cluster são:

   • CREATING

   • UPDATING

   • DELETING

   • AVAILABLE

   • FAILED

   • DELETED

   • UPDATING_INSTANCE_TYPE

   • PARTIALLY_AVAILABLE(Aplicável somente para clusters de vários nós quando alguns nós ainda estão sendo criados ou atualizados)

3. CloudWatch Métricas: monitore as métricas de desempenho durante as atualizações.

Limitações

Limitações atuais para atualizações de cluster:

• Não é possível modificar a VPC, as sub-redes, os grupos de segurança ou a acessibilidade pública após a criação.

• A atualização do Core para o Enterprise é suportada (unidirecional), mas você não pode fazer o downgrade do Enterprise para o Core. Consulte Atualização da edição Core para a Enterprise.

• Não é possível renomear o cluster (o identificador do cluster de banco de dados é imutável).

• Todos os nós devem usar a mesma classe de instância (exceto o compactador).

• Os grupos de parâmetros são imutáveis (é necessário criar novos para alterações).

• As operações de escalabilidade de cluster (adicionar/remover nós) exigem a criação e a aplicação de um novo grupo de parâmetros.

Ao compreender esses recursos e limitações de atualização, você pode gerenciar e escalar com eficácia seus clusters do InfluxDB 3 para atender aos requisitos de workload em evolução. Ao mesmo tempo, você pode planejar adequadamente as configurações que devem ser configuradas no momento da criação do cluster.