Atualização de domínios do Amazon OpenSearch Service - Amazon OpenSearch Service
Caminhos de atualização com suporteSolução de problemas de falha de validaçãoSolução de problemas em uma atualização

Atualização de domínios do Amazon OpenSearch Service

nota

As atualizações de versão do OpenSearch e do Elasticsearch são diferentes das atualizações do software de serviço. Para obter informações sobre a atualização do software de serviço do seu domínio do OpenSearch Service, consulte Atualizações de software de serviço no Amazon OpenSearch Service.

O Amazon OpenSearch Service oferece atualizações do no local para domínios que executam o OpenSearch 1.0 ou posterior ou o Elasticsearch 5.1 ou posterior. Se você usar serviços como o Amazon Data Firehose ou o Amazon CloudWatch Logs para transmitir continuamente dados para o OpenSearch Service, verifique se esses serviços são compatíveis com a versão mais recente do OpenSearch antes da migração.

Caminhos de atualização com suporte

No momento, o OpenSearch Service oferece suporte aos seguintes caminhos de atualização:

Da versão Para a versão
OpenSearch 1.3 ou 2.x

OpenSearch 3.1

Se você executar o OpenSearch 1.3 ou 2.x, deverá primeiro atualizar para o OpenSearch 2.19 antes de atualizar para o OpenSearch 3.1. Posteriormente, ao atualizar do OpenSearch 2.19 para o OpenSearch 3.1, talvez seja necessário resolver as seguintes configurações de índice incompatíveis. Elas se tornaram obsoletas na versão 2.x e causarão uma falha na validação da verificação de atualização se não forem removidas.

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

Para obter mais informações sobre configurações de índice obsoletas e etapas para corrigi-las, consulte Configurações de índice. Para obter uma lista completa das alterações mais importantes do OpenSearch 3.1, consulte 3.0.0.
OpenSearch 1.3 ou 2.x

OpenSearch 2.x

O OpenSearch 2.17 habilitará a pesquisa simultânea de segmentos por padrão com o modo automático se o domínio atender às seguintes condições:

  • Nenhuma configuração anterior de pesquisa simultânea está explicitamente definida.

  • Todas as instâncias de dados (quentes e mornos) são do tipo 2.xl ou mais.

  • A utilização média da CPU p90 em instâncias de dados (quentes e mornos) por mais de uma semana é abaixo de 45%.

    Para obter mais detalhes sobre as configurações de pesquisa simultâneos de segmentos aqui, consulte Pesquisa simultânea de segmentos.

A versão 2.3 tem as seguintes alterações importantes:

  • O parâmetro type foi removido de todos os endpoints da API do OpenSearch na versão 2.0. Para obter mais informações, consulte alterações que podem causar interrupções.

  • Se seu domínio contiver algum índice (atividade alta, UltraWarm ou baixa atividade) originalmente criado no Elasticsearch 6.8, esses índices não serão compatíveis com o OpenSearch 2.3.

    Antes de atualizar para a versão 2.3, será necessário reindexar os índices incompatíveis. Para índices UltraWarm ou de baixa atividade incompatíveis, migre-os para o armazenamento de atividade muito alta, reindexe os dados e depois migre-os de volta para o armazenamento de atividade alta ou baixa. Também é possível excluir os índices quando eles não são mais necessários.

    Se você, acidentalmente, atualizar seu domínio para a versão 2.3 sem executar essas etapas primeiro, não poderá migrar os índices incompatíveis do nível de armazenamento atual. Sua única opção será excluí-los.
OpenSearch 1.x OpenSearch 1.x
Elasticsearch 7.x

Elasticsearch 7.x ou OpenSearch 1.x

Importante

O OpenSearch 1.x introduz mudanças radicais. Para obter detalhes, consulte Renomeação do Amazon OpenSearch Service: resumo das alterações.

Elasticsearch 6.8

Elasticsearch 7.x ou OpenSearch 1.x

Importante

O Elasticsearch 7.0 e o OpenSearch 1.0 incluem várias alterações importantes. Antes de iniciar uma atualização em operação, recomendamos fazer um snapshot manual do domínio 6.x, restaurá-lo em um domínio de teste 7.x ou OpenSearch 1.x, e usar esse domínio de teste para identificar possíveis problemas de atualização. Para ver as mudanças radicais no OpenSearch 1.0, consulte Renomeação do Amazon OpenSearch Service: resumo das alterações.

Assim como o Elasticsearch 6.x, os índices só podem conter um tipo de mapeamento, mas esse tipo agora deve ser chamado de _doc. Como resultado, determinadas APIs não exigem mais um tipo de mapeamento no corpo da solicitação (como a API _bulk).

Para novos índices, o Elasticsearch 7.x e o OpenSearch 1.x auto-hospedados têm uma contagem de fragmentos padrão de um. Domínios do OpenSearch Service no Elasticsearch 7.x e posteriores retêm o padrão anterior de cinco.

Elasticsearch 6.x

Elasticsearch 6.x
Elasticsearch 5.6

Elasticsearch 6.x

Importante

Os índices criados na versão 6.x não são mais compatíveis com vários tipos de mapeamento. Índices criados na versão 5.x ainda são compatíveis com vários tipos de mapeamento quando restaurados em um cluster 6.x. Verifique se o seu código de cliente cria apenas um único tipo de mapeamento por índice.

Para minimizar o tempo de inatividade durante a atualização do Elasticsearch 5.6 para o 6.x, o OpenSearch Service reindexa o índice .kibana para .kibana-6, exclui o .kibana, cria um alias chamado .kibana e mapeia o novo índice para o novo alias.
Elasticsearch 5.x Elasticsearch 5.x

O processo de atualização consiste em três etapas:

  1. Verificações pré-atualização: o OpenSearch Service verifica se há problemas que possam bloquear uma atualização e não prosseguirá para a próxima etapa, a menos que essas verificações sejam bem-sucedidas.

  2. Snapshot: o OpenSearch Service faz uma cópia de snapshot do cluster do OpenSearch ou Elasticsearch e não prosseguirá para a próxima etapa a menos que o snapshot seja bem-sucedido. Se a atualização falhar, o OpenSearch Service usará esse snapshot para restaurar o cluster ao seu estado original. Para obter mais informações, consulte Não é possível reverter para a versão anterior após a atualização..

  3. Atualizar: o OpenSearch Service inicia a atualização, que pode levar de 15 minutos a várias horas para ser concluída. O OpenSearch Dashboards pode se tornar indisponível durante algumas ou todas as atualizações.

Solução de problemas de falha de validação

Quando você inicia uma atualização da versão do OpenSearch ou do Elasticsearch, o OpenSearch Service primeiro executa uma série de verificações de validação para garantir que o domínio se qualifique para uma atualização. Se alguma dessas verificações falhar, você receberá uma notificação no console contendo os problemas específicos que deverão ser corrigidos antes da atualização do domínio. Para obter uma lista de possíveis problemas e as etapas para resolvê-los, consulte Solução de problemas de erros de validação.

Solução de problemas em uma atualização

As atualizações do no local exigem domínios íntegros. Seu domínio pode não estar qualificado para uma atualização ou não ser atualizado por vários motivos. A tabela a seguir mostra os problemas mais comuns.

Problema Descrição
Plug-in opcional não compatível

Quando você atualiza um domínio com plug-ins opcionais, o OpenSearch Service também atualiza os plug-ins automaticamente. Portanto, a versão de destino do seu domínio também deve oferecer suporte a esses plug-ins opcionais. Se o domínio tiver um plug-in opcional instalado que não esteja disponível para a versão de destino, a solicitação de upgrade falhará.
Muitos fragmentos por nó O OpenSearch e as versões 7.x do Elasticsearch têm uma configuração padrão de até 1.000 fragmentos por nó. Se um nó no cluster atual exceder essa configuração, o OpenSearch Service não permitirá que você atualize. Consulte Limite máximo de fragmentos excedido para obter opções de solução de problemas.
Domínio no processamento O domínio está no meio de uma mudança de configuração. Verifique a qualificação da atualização após a conclusão da operação.
Status de cluster vermelho Um ou mais índices no cluster estão vermelhos. Para obter etapas sobre a solução de problemas, consulte Status de cluster vermelho.
Alta taxa de erros O cluster está retornando um grande número de erros 5xx ao tentar processar solicitações. Geralmente, esse problema é resultado de muitas solicitações de leitura ou gravação simultâneas. Considere reduzir o tráfego para o cluster ou dimensionar seu domínio.
Cérebro dividido Cérebro dividido significa que o cluster tem mais de um nó principal e foi dividido em dois clusters que nunca se juntarão por conta própria. Você pode evitar dividir o cérebro usando o número recomendado de nós principais dedicados. Para ajudar na recuperação do cérebro dividido, entre em contato com Suporte.
Nó principal não encontrado O OpenSearch Service não consegue encontrar o nó principal do cluster. Se o domínio usa multi-AZ, uma falha da zona de disponibilidade pode ter causado a perda de quorum do cluster e a incapacidade de escolher um novo nó principal. Se o problema não se resolver, entre em contato com Suporte.
Muitas tarefas pendentes O nó principal está sob carga pesada e tem muitas tarefas pendentes. Considere reduzir o tráfego para o cluster ou dimensionar seu domínio.
Volume de armazenamento prejudicado O volume de disco de um ou mais nós não está funcionando corretamente. Esse problema geralmente ocorre junto com outros problemas, como uma alta taxa de erros ou muitas tarefas pendentes. Se o problema ocorrer isoladamente e não se resolver, entre em contato com Suporte.
Problema de chave do KMS A chave do KMS usada para criptografar o domínio está inacessível ou ausente. Para obter mais informações, consulte Monitoramento de domínios que criptografam dados em repouso.
Snapshot em andamento O domínio está tirando um snapshot no momento. Verifique a qualificação da atualização após a conclusão do snapshot. Além disso, verifique se é possível listar repositórios de snapshots manuais, listar snapshots nesses repositórios e obter snapshots manuais. Se o OpenSearch Service não conseguir verificar se um snapshot está em andamento, as atualizações poderão falhar.
Tempo limite ou falha de snapshot O snapshot de pré-atualização demorou muito para ser concluído ou falhou. Verifique o status do cluster e tente novamente. Se o problema continuar, entre em contato com o Suporte.
Índices incompatíveis Um ou mais índices são incompatíveis com a versão de destino. Esse problema poderá ocorrer se você tiver migrado os índices de uma versão mais antiga do OpenSearch ou do Elasticsearch. Reindexe os índices e tente novamente.
Uso elevado do disco O uso de disco para o cluster está acima de 90%. Exclua os dados ou dimensione o domínio e tente novamente.
Uso elevado do JVM A pressão de memória JVM está acima de 75%. Reduza o tráfego para o cluster ou dimensione o domínio e tente novamente.
Problema de alias do OpenSearch Dashboards .dashboardsO já está configurado como um alias e mapeia em um índice incompatível, provavelmente de uma versão anterior do OpenSearch Dashboards. Reindexe e tente novamente.
Status de painéis vermelhos O status do OpenSearch Dashboards é vermelho. Tente usar o Dashboards quando a atualização for concluída. Se o status vermelho persistir, resolva-o manualmente e tente novamente.
Compatibilidade entre clusters

Você só pode atualizar se a compatibilidade entre clusters for mantida entre os domínios de origem e de destino após a atualização. Durante o processo de atualização, todas as conexões incompatíveis são identificadas. Para prosseguir, atualize o domínio remoto ou excluir as conexões incompatíveis. Observe que, se a replicação estiver ativa no domínio, você não poderá retomá-la depois de excluir a conexão.

Outro problema de serviço do OpenSearch Service Problemas com o OpenSearch Service em si podem fazer com que seu domínio seja exibido como não qualificado para uma atualização. Se nenhuma das condições anteriores se aplicar ao seu domínio e o problema persistir por mais de um dia, entre em contato com Suporte.