Atualizando domínios do Amazon OpenSearch Service

nota

OpenSearch e as atualizações de versão do Elasticsearch diferem das atualizações do software de serviço. Para obter informações sobre como atualizar o software de serviço para seu domínio OpenSearch de serviço, consulteAtualizações de software de serviço no Amazon OpenSearch Service.

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

Caminhos de atualização com suporte

Atualmente, 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 2. x 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 foi definida explicitamente. Todas as instâncias de dados (quentes e quentes) são do tipo 2.xl ou mais. A utilização média da CPU p90 em instâncias de dados (quentes e quentes) por mais de uma semana está abaixo de 45%. Para obter mais detalhes sobre as configurações de pesquisa de segmentos simultâneos aqui, consulte Pesquisa de segmentos simultâneos. A versão 2.3 tem as seguintes alterações importantes: O type parâmetro foi removido de todos os OpenSearch API endpoints 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 (quente ou frio) que tenha sido originalmente criado no Elasticsearch 6.8, esses índices não são compatíveis com 2.3. UltraWarm OpenSearch Antes de atualizar para a versão 2.3, será necessário reindexar os índices incompatíveis. Para índices incompatíveis UltraWarm ou frios, migre-os para o armazenamento ativo, reindexe os dados e, em seguida, migre-os de volta para o armazenamento quente ou frio. 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 OpenSearch 1. x introduz várias mudanças significativas. 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 OpenSearch 1.0 incluem várias mudanças importantes. Antes de iniciar uma atualização no local, recomendamos tirar um instantâneo manual do 6. domínio x, restaurando-o em um teste 7. x ou OpenSearch 1. domínio x e usando esse domínio de teste para identificar possíveis problemas de atualização. Para alterações significativas na OpenSearch versão 1.0, consulteRenomeaçã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, alguns APIs não exigem mais um tipo de mapeamento no corpo da solicitação (como o _bulkAPI). Para novos índices, o Elasticsearch 7 auto-hospedado. x e OpenSearch 1. x têm uma contagem de fragmentos padrão de um. OpenSearch Domínios de serviço no Elasticsearch 7. x e posteriores mantê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 6. x, o OpenSearch serviço reindexa o .kibana índice.kibana-6, exclui.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 de pré-atualização — O OpenSearch serviço verifica se há problemas que podem bloquear uma atualização e não prossegue para a próxima etapa, a menos que essas verificações sejam bem-sucedidas.

2. Snapshot — O OpenSearch serviço tira um snapshot do cluster OpenSearch ou do Elasticsearch e não passa 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 estado original. Para ter mais informações, consulte Não é possível reverter para a versão anterior após a atualização..

3. Atualização — O OpenSearch serviço inicia a atualização, que pode levar de 15 minutos a várias horas para ser concluída. OpenSearch Os painéis podem estar indisponíveis durante parte ou toda a atualização.

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

Quando você inicia uma atualização da versão OpenSearch ou do Elasticsearch, o OpenSearch Service primeiro executa uma série de verificações de validação para garantir que seu domínio esteja qualificado 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 automaticamente os plug-ins. 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ó	OpenSearch, bem como 7. As versões x do Elasticsearch têm uma configuração padrão de no máximo 1.000 fragmentos por nó. Se um nó em seu cluster atual exceder essa configuração, o OpenSearch Serviço não permitirá que você faça o upgrade. 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 Support.
Nó principal não encontrado	OpenSearch O serviço 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 Support.
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 Support.
KMSquestão-chave	A KMS chave 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 Serviço não conseguir verificar se um snapshot está em andamento, as atualizações podem 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 Support.
Índices incompatíveis	Um ou mais índices são incompatíveis com a versão de destino. Esse problema pode ocorrer se você migrou os índices de uma versão mais antiga do Elasticsearch OpenSearch . 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.
Alto JVM uso	JVMa pressão da memória está acima de 75%. Reduza o tráfego para o cluster ou dimensione o domínio e tente novamente.
OpenSearch Problema de alias de painéis	.dashboardsjá está configurado como um alias e mapeia para um índice incompatível, provavelmente de uma versão anterior do Dashboards. OpenSearch Reindexe e tente novamente.
Status de painéis vermelhos	OpenSearch O status dos painéis é 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 OpenSearch serviço	Problemas com o OpenSearch serviço em si podem fazer com que seu domínio seja exibido como inelegível para um upgrade. 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 Support.