Skip to content

Autonomia do streamer

O central é o plano de controle, não o caminho da mídia. O streamer processa e entrega vídeo de forma independente: recebe a fonte, transcodifica, grava o arquivo e entrega o stream. Portanto, uma falha do central afeta a gestão, não a transmissão. Esta página descreve o que continua funcionando, o que fica indisponível e como a conexão com o central é restabelecida.

Esta página trata do caso em que um streamer não consegue acessar nenhuma instância do central. Para a falha de uma instância enquanto as demais funcionam, consulte Redundância.

O que continua funcionando

  • Transmissão. Os streams continuam funcionando nos streamers: fontes, transcodificação, gravação do arquivo, pushes e entrega de vídeo não dependem do central. A reprodução direta do streamer continua.
  • Gravação DVR. O arquivo é gravado sem pausas; sua janela continua crescendo durante toda a indisponibilidade do central.
  • Mesmo o reinício de um streamer. Se reiniciado enquanto o central está indisponível, o streamer inicia seus streams imediatamente pelo cache local do slice de configuração, sem aguardar uma resposta do central. Ele continua tentando sincronizar:
WARN  sync failed, retrying   error sending request for url (.../node-api-v4/sync)

O que fica indisponível

  • Gestão. O console, a API, a lista de streams, as estatísticas e as sessões: todo o central. As alterações de configuração não são entregues e o layouter não reatribui streams: os streamers usam a última configuração.
  • Reprodução pelo central. O proxy de mídia e os redirecionamentos exigem o central; novas requisições ao seu endereço não recebem resposta. Configure um endereço público de mídia nos streamers: o central será necessário apenas para o redirecionamento inicial, e as conexões estabelecidas com os streamers serão mantidas se ele falhar. Em Cluster → Streamers, abra os ajustes do streamer, vá a Conexão, defina Endereço público de mídia e salve.
  • Streamer local. O streamer dentro do processo do central para junto com ele, assim como seus streams atribuídos. Esse é outro motivo para separar o central e a transmissão em máquinas diferentes em produção.

Como a conexão com o central é restabelecida

O streamer tenta sincronizar com uma pausa exponencial, limitada a aproximadamente um minuto. Quando o central retorna, a conexão é restabelecida automaticamente nesse intervalo: o streamer passa de «Sinal perdido» para «Online» no registro, e as estatísticas e sessões voltam a ficar disponíveis. Não é necessário reiniciar nada.

Dois casos especiais do retorno do central:

  • O central foi restaurado de um backup com versões de configuração anteriores às aplicadas pelo streamer. O central envia um sinal explícito; o streamer aceita o slice completo de configuração como autoritativo e continua usando-o. O retorno a versões anteriores não interrompe o cluster.
  • O central retornou com um banco vazio após a perda do disco sem backup. O streamer não está mais registrado, e seu log informa isso explicitamente:
ERROR node key rejected; streams keep running from the applied slice, operator action required

A transmissão continua com o slice de configuração aplicado. Para retornar ao cluster, pare o serviço do streamer, limpe seu diretório de estado (por padrão /var/lib/optic, onde sua identidade fica armazenada; não altere o arquivo no disco separado), abra a janela de adesão e faça a adesão da máquina com um token novo. Um novo registro é criado, e o layouter atribui os streams novamente. Um token novo não substitui a identidade armazenada: é necessário limpar o estado.

O que garante a autonomia

O funcionamento autônomo se baseia nas seguintes propriedades:

  • O streamer inicia toda a comunicação. O central não tem um stream de controle reverso: o streamer precisa do central para alterar a configuração, não para funcionar.
  • O slice de configuração aplicado fica armazenado no streamer. O cache local permite o início com a configuração armazenada sem o central e a operação com a última configuração durante uma indisponibilidade prolongada.
  • A configuração e os registros do grupo ficam no PostgreSQL. São restaurados de um dump. Os ajustes dos servidores e os diretórios de estado do central são salvos separadamente — consulte Backup e restauração.