Todos os produtos
Search
Central de documentação

Elasticsearch:Backup e restauração automáticos

Última atualização: Sep 17, 2026

Ao ativar o backup automático no Alibaba Cloud Elasticsearch, o sistema faz backup dos dados de índice no intervalo configurado. Use esses backups para recuperar dados excluídos acidentalmente ou corrigir erros de lógica da aplicação.

Observações de uso

  • O backup e a restauração de dados exigem o plugin elasticsearch-repository-oss, pré-instalado em todas as instâncias do Alibaba Cloud Elasticsearch e que não pode ser removido. elasticsearch-repository-oss.

    Os snapshots salvam apenas dados de índice — não incluem dados de monitoramento (índices com prefixo .monitoring ou .security_audit ), metadados, translog, configurações, pacotes, plugins ou logs. Os backups automáticos retêm apenas os snapshots dos últimos 7 dias. Snapshots expirados são excluídos automaticamente e não podem ser recuperados. Para reter dados por mais de 7 dias, exporte ou migre os snapshots antes da expiração usando Manual backup and restoration ou Automatically back up snapshots to a local OSS bucket . Os snapshots de backup automático só podem ser restaurados no cluster original. Para restaurar dados em um cluster diferente, use manual backup and restoration .
  • Os metadados de índice para um backup automático não podem exceder 100 MB. Se esse limite for ultrapassado, a tarefa de backup poderá falhar. Use manual backup and restoration como alternativa.

  • O primeiro snapshot é uma cópia completa dos dados e pode levar muito tempo. Use manual backup and restoration para o backup inicial.

  • A ativação do backup automático e a criação do repositório de snapshots (aliyun_auto_snapshot) são gratuitas.

  • O primeiro backup automático, ou qualquer backup que acione uma cópia completa, realiza uma cópia integral dos dados e consome recursos de CPU e I/O do cluster, o que pode afetar o desempenho das operações. Agende o backup automático fora do horário de pico, como na madrugada, para reduzir o impacto no desempenho.

Ativar backup automático e configurar alertas do cluster

Ativar backup automático

  1. Faça login no console do Alibaba Cloud Elasticsearch.

  2. No painel de navegação à esquerda, clique em Elasticsearch Clusters.

  3. Na barra de menus superior, selecione um grupo de recursos e uma região.

  4. Na página Elasticsearch Clusters, clique no ID da instância de destino.

  5. No painel de navegação à esquerda, clique em Data Backup.

  6. Na área Snapshots (Free Trial), ative a chave Auto Snapshot.

  7. Clique em Set ao lado de Auto Snapshot Period.

    O sistema gera o horário de backup automático das instâncias e não permite alterações.
  8. No painel Auto Snapshot Configuration, selecione uma Frequency (frequência de execução do backup automático).

    Ciclo de backup

    Descrição

    Every 30 minutes

    Faz backup a cada 30 minutos.

    Daily

    Faz backup diário em um horário personalizável.

    Custom

    Permite definir ciclo e horário personalizados.

    O horário do backup automático segue o fuso horário local da região da instância.
  9. Clique em OK.

Configurar alertas do cluster

Após ativar o backup automático, configure cluster alerts para monitorar o status do backup de snapshots. Um snapshot status (value) igual a 2 na página de monitoramento indica falha na tarefa de snapshot.

Execute /_cat/snapshots/aliyun_auto_snapshot?format=json para verificar o status do snapshot mais recente. Faça um manual backup se necessário.

O status do snapshot pode assumir um dos seguintes valores:

  • SUCCESS: Todos os shards foram copiados com êxito.

  • PARTIAL: Alguns shards não foram copiados.

  • FAILED: A tarefa de backup falhou.

Se não houver snapshot recente, o backup não foi acionado. Exceções no nível do cluster ou do nó podem impedir a execução dos backups automáticos.

Visualizar snapshots de backup

Depois de ativar o backup automático, use a API _snapshot no console do Kibana para visualizar os snapshots. Connect to a cluster through Kibana.

  • Visualize o repositório de snapshots.

    GET _snapshot

    Exemplo de resposta:

    {
      "aliyun_auto_snapshot" : {
        "type" : "oss",
        "settings" : {
          "compress" : "true",
          "base_path" : "cf95b9-185320276651****/es-cn-09k2053us0003****",
          "endpoint" : "http://oss-cn-hangzhou-internal.aliyuncs.com"
        }
      }
    }

    Parâmetro

    Descrição

    aliyun_auto_snapshot

    Repositório de snapshots automáticos, criado durante o primeiro snapshot. Sempre nomeado como aliyun_auto_snapshot. Um repositório armazena múltiplos snapshots, cada um contendo dados de backup de todos, de alguns ou de um único índice.

    type

    Meio de armazenamento. oss indica Object Storage Service (OSS).

    compress

    Define se os arquivos de metadados do snapshot (mapeamentos e configurações de índice) serão compactados. Não afeta os arquivos de dados. Padrão: false.

    base_path

    Caminho de armazenamento no OSS.

    endpoint

    Endpoint do bucket do OSS correspondente à região da instância.

  • Consulte as informações de todos os snapshots no repositório aliyun_auto_snapshot.

    GET _snapshot/aliyun_auto_snapshot/_all

    Exemplo de resposta:

    {
      "snapshots": [
        {
          "snapshot": "es-cn-09k2053us0003****_20210117030003",
          "uuid": "vIdSCkthTeGa0nSj4D****",
          "version_id": 5050399,
          "version": "5.5.3",
          "indices": [
            ".kibana"
          ],
          "state": "SUCCESS",
          "start_time": "2018-06-28T01:22:39.609Z",
          "start_time_in_millis": 1530148959609,
          "end_time": "2018-06-28T01:22:39.923Z",
          "end_time_in_millis": 1530148959923,
          "duration_in_millis": 314,
    
          "failures": [ ],
    
          "shards": {
            "total": 1,
            "failed": 0,
            "successful": 1
          }
        },
        {
          "snapshot": "es-cn-09k2053us0003****_20210118030004",
          "uuid": "XKO_Uwz_Qu6mZrU3Am****",
          "version_id": 5050399,
          "version": "5.5.3",
          "indices": [
            ".kibana"
          ],
          "state": "SUCCESS",
          "start_time": "2018-06-28T01:25:00.764Z",
          "start_time_in_millis": 1530149100764,
          "end_time": "2018-06-28T01:25:01.482Z",
          "end_time_in_millis": 1530149101482,
          "duration_in_millis": 718,
    
          "failures": [ ],
    
          "shards": {
            "total": 1,
            "failed": 0,
            "successful": 1
          }
        }
      ]
    }
    Os backups automáticos são agendados no horário local da região da instância, mas a resposta da API retorna timestamps em UTC. O Horário Padrão da China (UTC+8) está 8 horas à frente do UTC.

    O campo state indica o status do snapshot:

    Status do snapshot

    Descrição

    IN_PROGRESS

    Snapshot em andamento.

    SUCCESS

    Snapshot concluído. Todos os dados dos shards foram armazenados.

    FAILED

    Falha no snapshot.

    PARTIAL

    Sucesso parcial. Pelo menos um shard não foi armazenado.

    INCOMPATIBLE

    Snapshot incompatível com a versão da instância do Alibaba Cloud Elasticsearch.

    Os snapshots de backup automático possuem os seguintes parâmetros padrão adicionais:

    Parâmetro

    Descrição

    max_snapshot_bytes_per_sec

    Throughput máximo de snapshot por nó. Padrão: 40 MB/s.

    max_restore_bytes_per_sec

    Throughput máximo de restauração por nó. Padrão: 40 MB/s.

    chunk_size

    Tamanho do bloco para divisão de arquivos grandes durante o snapshot (por exemplo, 1g, 10m, 5k). Padrão: null (sem limite).

  • Obtenha detalhes sobre um snapshot específico no repositório aliyun_auto_snapshot.

    GET _snapshot/aliyun_auto_snapshot/<snapshot>/_status

    <snapshot>: Nome do snapshot de backup automático (obtido no comando de listagem acima). Exemplo: es-cn-09k2053us0003****_20210118030004.

    Exemplo de resposta:

    {
      "snapshots": [
        {
          "snapshot": "es-cn-09k2053us0003****_20210118030004",
          "repository": "aliyun_auto_snapshot",
          "uuid": "XKO_Uwz_Qu6mZrU3Am****",
          "state": "SUCCESS",
          "shards_stats": {
            "initializing": 0,
            "started": 0,
            "finalizing": 0,
            "done": 1,
            "failed": 0,
            "total": 1
          },
          "stats": {
            "number_of_files": 4,
            "processed_files": 4,
            "total_size_in_bytes": 3296,
            "processed_size_in_bytes": 3296,
            "start_time_in_millis": 1530148959688,
            "time_in_millis": 77
          },
          "indices": {
            ".kibana": {
              "shards_stats": {
                "initializing": 0,
                "started": 0,
                "finalizing": 0,
                "done": 1,
                "failed": 0,
                "total": 1
              },
              "stats": {
                "number_of_files": 4,
                "processed_files": 4,
                "total_size_in_bytes": 3296,
                "processed_size_in_bytes": 3296,
                "start_time_in_millis": 1530148959688,
                "time_in_millis": 77
              },
              "shards": {
                "0": {
                  "stage": "DONE",
                  "stats": {
                    "number_of_files": 4,
                    "processed_files": 4,
                    "total_size_in_bytes": 3296,
                    "processed_size_in_bytes": 3296,
                    "start_time_in_millis": 1530148959688,
                    "time_in_millis": 77
                  }
                }
              }
            }
          }
        }
      ]
    }

Restaurar dados de um backup automático

A restauração de índices de sistema (prefixo . ) pode tornar o Kibana inacessível. Não restaure índices de sistema.

No console do Kibana, execute os comandos abaixo para restaurar dados de índice a partir de um snapshot:

  • Restaure todos os índices de um snapshot específico (execução em segundo plano).

    POST _snapshot/aliyun_auto_snapshot/<snapshot>/_restore

    <snapshot>: Nome do snapshot de backup automático, por exemplo, es-cn-abcdefghij****_20180627091600.

  • Restaure todos os índices de um snapshot específico e aguarde a conclusão da tarefa.

    A API _restore é assíncrona. Adicione wait_for_completion para aguardar a finalização:

    POST _snapshot/aliyun_auto_snapshot/<snapshot>/_restore?wait_for_completion=true

    <snapshot>: Nome do snapshot de backup automático, por exemplo, es-cn-abcdefghij****_20180627091600.

  • Restaure índices específicos de um snapshot e renomeie-os durante o processo (execução em segundo plano).

    POST _snapshot/aliyun_auto_snapshot/<snapshot>/_restore
    {
    "indices": "index_1",
    "rename_pattern": "index_(.+)",
    "rename_replacement": "restored_index_$1"
    }

    Parâmetro

    Descrição

    <snapshot>

    Nome do snapshot de backup automático, por exemplo, es-cn-abcdefghij****_20180627091600.

    indices

    Nome do índice a ser restaurado.

    rename_pattern

    Opcional. Expressão regular para corresponder aos nomes dos índices que você deseja restaurar.

    rename_replacement

    Opcional. Padrão de substituição para renomear os índices correspondentes.

Desativar backup automático

  1. Faça login no console do Alibaba Cloud Elasticsearch.

  2. No painel de navegação à esquerda, clique em Elasticsearch Clusters.

  3. Na barra de menus superior, selecione um grupo de recursos e uma região.

  4. Na página Elasticsearch Clusters, clique no ID da instância de destino.

  5. No painel de navegação à esquerda, clique em Data Backup.

  6. Na área Snapshots (Free Trial), desative a chave Auto Snapshot.

Perguntas frequentes

Por que o backup automático falha ou por que os snapshots incrementais demoram tanto quanto os completos?

O backup automático pode falhar ou os snapshots incrementais podem levar o mesmo tempo que os completos quando o limite de consultas por segundo (QPS) do OSS é excedido, resultando no erro QpsLimitExceeded. Isso é mais comum em horários de pico, como entre 00:00 e 02:00.

Para resolver esse problema:

  • Ajuste o agendamento do backup automático para horários fora de pico, como entre 03:00 e 04:00, para reduzir a probabilidade de limitação de QPS do OSS.

  • Se ocorrer falha no backup, aguarde e tente novamente mais tarde. Esse problema costuma ser transitório e não afeta as operações normais do cluster ou as cargas de trabalho.

Como visualizo os snapshots de backup automático no console?

Para instâncias PaaS nativas da nuvem do Elasticsearch, o console não oferece uma entrada direta para visualizar snapshots de backup automático. Use um dos métodos a seguir:

  • Kibana: Faça login no console do Kibana do seu cluster e acesse Management > Snapshot and Restore para ver os snapshots disponíveis.

  • API: Execute o comando abaixo no console Dev Tools do Kibana ou chame diretamente a API do Elasticsearch:

    GET _snapshot/aliyun_auto_snapshot/_all

    Esse comando retorna todos os snapshots no repositório aliyun_auto_snapshot, incluindo nome do snapshot, status, hora de início e informações dos índices.

O que fazer se uma tarefa de backup automático permanecer no estado IN_PROGRESS por muito tempo ou se os backups subsequentes falharem?

O Elasticsearch permite apenas uma tarefa de snapshot por vez no mesmo repositório. Se uma tarefa anterior travar durante a fase de inicialização devido a uma flutuação transitória do cluster (o status mostra IN_PROGRESS, mas nenhum dado está sendo gravado), as tarefas subsequentes de backup automático são ignoradas silenciosamente para evitar conflitos de dados. Como resultado, os backups podem falhar continuamente.

Para resolver esse problema:

  1. Faça login no console do Kibana do seu cluster e execute o comando abaixo para identificar o snapshot travado:

    GET _snapshot/aliyun_auto_snapshot/_all
  2. Execute o seguinte comando para cancelar e limpar a tarefa de snapshot travada:

    POST _snapshot/aliyun_auto_snapshot/<snapshot>/_cancel

Configure uma regra de alerta personalizada para detectar tarefas de snapshot que permaneçam no estado IN_PROGRESS por mais de 1 hora, permitindo identificar e tratar tais problemas rapidamente.

O que fazer se o backup automático parar e nenhum novo snapshot for gerado após uma atualização de instância ou alteração de configuração?

Geralmente, esse problema é causado por uma configuração de repositório entre clusters que referencia o próprio cluster, impedindo a gravação dos snapshots.

Para resolver esse problema:

  1. Remova a configuração incorreta do repositório entre clusters e o repositório de snapshots automáticos existente (aliyun_auto_snapshot).

  2. No console do Alibaba Cloud Elasticsearch, desative o backup automático e ative-o novamente.

O sistema recriará automaticamente o repositório de snapshots e retomará os backups normais no próximo horário agendado.