Skip to content

Componentes e confiabilidade

Uma instalação do Optic tem poucos componentes, cada um com seu estado armazenado e suas garantias. Esta página descreve o armazenamento do estado, as consequências de falhas e a compatibilidade nas atualizações. O comportamento do cluster durante uma falha do central é descrito separadamente — Autonomia do streamer.

De que a instalação se compõe

  • O serviço optic na máquina do central — o plano de controle e o streamer local em um só processo.
  • PostgreSQL — o armazenamento de estado do central. Guarda a configuração e os registros do grupo.
  • Os serviços dos streamers — a transmissão; cada um tem seu diretório de estado e seus discos de arquivo.
  • O armazenamento de métricas — integrado, na memória do processo; mantém algumas horas de dados para os gráficos, não um arquivo.

O que é armazenado no PostgreSQL

A configuração e os registros da instalação:

  • as configurações de streams e as configs dos streamers;
  • o registro de streamers — os assentos com a identidade e as chaves das máquinas;
  • a alocação de streams, o diário de decisões e as execuções do layouter;
  • o diário de sessões fechadas;
  • o material TLS do central — a conta ACME e os certificados emitidos.

Um backup do banco permite restaurar a configuração e os registros do grupo. Consulte Backup e restauração.

O que é armazenado em um streamer

O diretório de estado /var/lib/optic de cada máquina:

  • server.id e o cache de ativação — a identidade de licenciamento da máquina;
  • a identidade do streamer no cluster — a chave com a qual ele se apresenta ao central;
  • o cache do slice de configuração aplicado — o que dá a partida a quente sem central;
  • o diário local de sessões fechadas até o central colhê-lo.

O arquivo DVR é armazenado separadamente — nos discos dedicados definidos nas configurações do streamer.

O que sobrevive à perda de quê

Perda O que acontece O que fazer
Todas as instâncias acessíveis do central A transmissão e a gravação continuam; a gestão e a reprodução pelo central ficam indisponíveis Autonomia do streamer; a conexão é restabelecida automaticamente após o início do processo
O banco PostgreSQL O mesmo, com a perda da configuração Restaurar de um dump — os streamers se reconectam automaticamente
O banco, sem backup A transmissão continua; os streamers perderam seu registro Fazer a adesão de cada um novamente: limpar o estado e usar um token novo
O diretório de estado de um streamer A máquina perde sua identidade de licença e de cluster Fazer a adesão da máquina novamente; os streams serão reatribuídos
Um disco DVR O arquivo desse disco é perdido; a transmissão não é afetada Os indicadores do disco no diagnóstico
O armazenamento de métricas (reinício do processo) Algumas horas de histórico dos gráficos são perdidas Nada — os dados voltam a se acumular

Garantias de compatibilidade

  • Versões diferentes convivem. O protocolo de troca cresce só por adição: campos desconhecidos devem ser ignorados pelos dois lados, então central e streamers de versões vizinhas trabalham juntos.
  • O esquema do banco é compatível numa janela de duas versões. Esquema mais novo sob código mais velho é a norma; isso habilita tanto a atualização por etapas quanto o rollback do binário sem rollback do banco.
  • O registro é deliberadamente não idempotente. Aderir de novo a mesma máquina cria um assento novo, e duplicatas por server_id o registro marca deixando a decisão ao operador.