Pular para o conteúdo
JelinaJelina DocumentationDocumentação técnica
Voltar ao site oficial

Arquivamento periódico do histórico

O arquivamento periódico salva dados continuamente, conforme um plano, em diretórios locais ou discos externos. É adequado à retenção de longo prazo, análise offline e transferência de dados.

É possível criar vários planos, cada um com diretório, escopo e periodicidade próprios. Por exemplo, um pode preservar os valores históricos necessários às tendências e outro, os registros de negócio e snapshots de configuração.

Item de configuração Descrição
Periodicidade 1 a 30 dias do calendário local
Fuso horário e primeiro ponto de corte Determinam cada janela contínua de arquivamento; o primeiro ponto de corte deve estar no futuro
Escopo do histórico Seleciona todos ou determinados pontos do histórico de aquisição, agregação e compartilhamento
Categorias de negócio Seleciona registros, configurações e relações por categoria, ou todas as tabelas de negócio
Arquivos operacionais Pode incluir ems.yaml, arquivos de configuração do CommBridge e arquivos display, quando existentes
Destino de armazenamento Diretório local existente ou disco externo montado e com identidade validada; cada plano pode usar um disco diferente

Diretórios locais são práticos. Para isolar falhas do dispositivo completo ou do mesmo disco, escolha armazenamento independente. O modo externo verifica a montagem e a identidade do disco para evitar gravações indevidas no disco do sistema quando o disco externo não está montado.

  1. Selecione escopo, destino e periodicidade e salve primeiro o plano.
  2. Confira o destino de armazenamento e o período de retenção antes de habilitar o plano.
  3. Aguarde o encerramento da janela de arquivamento e consulte o estado de execução, os volumes e os erros.
  4. Confirme o manifesto, os resultados de verificação e o marcador de conclusão; só então a janela estará arquivada.

Salvar ou habilitar com sucesso não significa que a primeira proteção já foi concluída. O arquivamento avança por janelas contínuas. Desconexão do disco, falta de espaço ou falha de verificação impedem o avanço da posição concluída; após restabelecer as condições, é possível continuar a mesma janela ou tentar novamente.

Valores históricos são salvos em CSV e outras tabelas de negócio em JSONL, com geração de volumes ZIP, verificações SHA256 e um manifesto geral. O arquivamento é executado em segmentos conforme as janelas de execução e o orçamento de recursos, compartilhando os recursos de consulta com exportações manuais; estas podem receber prioridade nos limites entre segmentos.

A página de recursos sinaliza primeira execução ainda incompleta, escopo incompleto, lacunas de retenção ou problemas no disco de destino. A periodicidade do arquivamento deve ser compatível com a retenção dos dados: se eles forem removidos antes do arquivamento, uma nova tentativa não poderá recuperá-los.

Atualmente, não há interface de restauração online dos arquivos, e as várias tabelas não formam necessariamente um snapshot completo do mesmo instante. Arquivos de arquivamento não podem ser enviados diretamente como pacotes de restauração de backup de configuração.

O gerenciamento de múltiplos planos usa /ems-data/archive/plans; categorias, estados e registros de execução usam, respectivamente, /categories, /status e /runs (todos sob /ems-data/archive). Atualizações e habilitação/desabilitação de planos exigem o revision mais recente para evitar sobrescrever alterações de outros administradores.

Antes de configurar, consulte Capacidade de armazenamento e políticas de retenção. Para gerar um arquivo uma única vez, use Exportação do histórico. Consulte as etapas detalhadas de chamada na Skill de arquivamento.