O arquivo DVR¶
O arquivo transforma um stream de «só ao vivo» em um nPVR: o espectador retrocede, alcança o início do programa, assiste ao episódio de ontem. A gravação é feita pelo streamer onde o stream roda, ou por um streamer DVR do namespace dele quando há um; esta página prepara os discos, liga a gravação e mostra como conferir que o arquivo está mesmo sendo gravado e tocado.
Prepare os discos do streamer¶
O armazenamento do arquivo é uma configuração do streamer, não do stream. Abra o streamer no registro, o bloco DVR das configurações dele:
- Raiz do arquivo — o diretório onde os discos do arquivo estão montados.
- Discos — um por dispositivo físico: diretórios filhos da raiz.
- Verificar montagens antes de gravar — ligado por padrão: um diretório sem montagem própria é reportado como «não montado», e o streamer se recusa a gravar o arquivo na partição raiz do sistema — um jeito garantido de derrubar a máquina junto com o arquivo. Desligue só de forma consciente.
Os discos se montam assim: monte cada disco como diretório filho de um diretório comum — /storage/dvr/disk1, /storage/dvr/disk2, /storage/dvr/disk3 —, indique o diretório comum como Raiz do arquivo e inclua cada disco na lista de discos como seu diretório filho:

Pressione Salvar alterações — o central entrega o armazenamento ao streamer, e os indicadores de aplicação mostram quando entrou em vigor. Sem armazenamento configurado a gravação não começa, por mais streams que a peçam.
O streamer local de uma instalação de uma só máquina não é exceção: ele se abre a partir do mesmo registro, e seu armazenamento se configura no mesmo bloco DVR do console.
JBOD em vez de RAID¶
O subsistema de arquivo do Catena é um application RAID: o próprio streamer distribui a gravação entre dispositivos independentes, ele mesmo percebe um disco caído e continua gravando nos restantes. Por isso os discos são entregues a ele separadamente — JBOD: cada um com seu sistema de arquivos e seu ponto de montagem, como na montagem acima. Perder um disco custa exatamente a parte do arquivo daquele disco: os demais continuam gravando, e o indicador DVR fica vermelho no registro de streamers.
Não recomendamos RAID por hardware nem por software sob o arquivo — e prometemos que com essas soluções de engenharia você vai esbarrar em problemas. A gravação do arquivo é um fluxo contínuo para todos os streams da máquina ao mesmo tempo, e sob essa carga um array se comporta pior que a soma dos seus discos: a degradação ou o rebuild de um único disco freia o array inteiro, e os atrasos e omissões de gravação crescem em todos os streams ao mesmo tempo. É exatamente assim que a sobrecarga do arquivo aparece no gráfico de gravação da aba DVR: as curvas de omissões e atrasos sobem em todos os streams da máquina de uma vez.
Ligue a gravação¶
Na página do stream abra a aba DVR:
- Gravar no DVR — liga a gravação.
- Retenção (horas) — quantas horas de transmissão manter; o que sai da profundidade é apagado sozinho.
Desligar Gravar no DVR não apaga o arquivo na hora: os streamers guardam o gravado por mais um dia e o apagam aos poucos, e a gravação religada continua o arquivo anterior. O apagamento pela profundidade também não para no streamer de onde o stream se mudou — veja Restos do arquivo.
Pressione Salvar. Em um ou dois minutos a mesma aba mostra o Estado atual da gravação: um indicador com o veredicto e a janela do arquivo — do início da gravação até agora. Quando o streamer reporta estatísticas estendidas, aparecem aqui também as horas com dados (com buracos, se a gravação foi interrompida), o tamanho do arquivo, as velocidades de gravação ao vivo e o gráfico de gravação — a história dessas velocidades junto com erros e omissões.

Cópia de segurança do arquivo¶
Com a gravação ativada, abra Layout do stream, defina Cópias de backup DVR e salve. Para cada cópia, o layouter selecionará outro streamer, que receberá o stream processado e o gravará sem transcodificar novamente.
Para publicações SRT, a cópia recebe o stream do processador. O streamer da cópia deve ter armazenamento de arquivo configurado e Recepção inicial de publicações desativada. O papel de cópia de segurança preserva o arquivo gravado, mas não mantém a transcodificação se o processador falhar.
Confira a atribuição dvr backup em Layout. Se não houver streamer adequado, aparecerá uma demanda não atendida com o motivo da recusa.
Faça cache do arquivo de outro¶
Na mesma aba há um segundo interruptor — Cachear o arquivo. Não é uma configuração da gravação, e sim uma propriedade independente: as leituras do arquivo do stream assentam nos discos de cache do streamer, e uma solicitação repetida da mesma parte é servida localmente, sem ir à fonte.

Não é preciso ligar a gravação para isso, e é justamente esse o ponto: um edge faz cache do arquivo de outro sem gravar o seu. A distribuição típica é um origin que grava o arquivo e edges mais perto dos espectadores guardando o que de fato é assistido.
O cache só funciona onde o streamer tem discos de cache configurados. Um stream com o cache ligado num streamer sem eles não é um erro: o cache simplesmente não funciona e um aviso vai para o log. Isso é normal num cluster, onde um mesmo documento de stream se espalha por máquinas diferentes.
Quanto o cache ocupou e que proporção de solicitações ele atende — na seção DVR do cluster.
Vigie a gravação¶
Na lista de streams, a coluna DVR de um stream com arquivo mostra quanto está de fato gravado, mais um indicador de saúde:
- Verde — a gravação vai, sem erros.
- Amarelo — a gravação está degradada (fragmentos gravados com atraso ou pulados), ou o DVR está configurado mas não grava.
- Vermelho — erros de gravação: dados estão sendo perdidos agora mesmo.
- Um traço — o stream não tem arquivo configurado.

A saúde dos discos mora do lado do streamer: quando um disco cai ou enche, o indicador DVR do registro de streamers fica vermelho.
O que o espectador recebe¶
O arquivo é servido pelos mesmos endereços HLS que o ao vivo — o reprodutor não precisa de nada especial:
- Retrocesso:
/streaming/v/<nome>/rewind/<segundos>/index.m3u8— o mesmo stream deslocado ao passado pelo número de segundos indicado.rewind/3600é uma hora atrás. - Faixas gravadas:
/streaming/dvr-ranges/<nome>— JSON com a lista de intervalos gravados. Sobre ele se constroem as linhas do tempo de arquivo nos reprodutores: dá para ver o que está gravado e onde há buracos. - Clipe de preview:
/streaming/dvr-preview-mp4/<nome>/<utc_ms>— um MP4 curto ao redor de um momento (UTC em milissegundos). Útil para interfaces editoriais e de moderação: mostrar um pedaço do arquivo sem levantar um reprodutor. É montado das miniaturas gravadas no arquivo — configure os previews com «Guardar miniaturas no DVR» ligado, ou o endereço responderá que não há quadros.
Se a gravação não vai¶
- «DVR configurado mas não está gravando». Ou o stream não está no ar — não há o que gravar — ou o streamer não tem armazenamento de arquivo configurado, ou no namespace há um streamer DVR e a gravação nele não foi criada. Confira o status do stream, o bloco DVR nas configurações do streamer e a aba Layout do stream.
- «Erros de gravação do arquivo — dados estão sendo perdidos». O disco está cheio, caiu ou não está montado. Olhe o indicador DVR e as configurações de discos no registro de streamers.
- A janela do arquivo é mais curta que a retenção. É normal logo após ligar: a janela cresce com a gravação e só alcança a profundidade depois dessas horas.
Quanto espaço é usado no cluster¶
A capacidade de arquivo de todos os streamers de uma vez, a divisão do espaço ocupado entre arquivo ativo e órfão, o destino do arquivo de streams excluídos e a reconstrução do índice estão na página DVR do cluster.
Índice de navegação rápida do arquivo¶
No separador DVR de um fluxo ou modelo, ative Navegação rápida do arquivo nos dois sentidos. A gravação DVR deve estar ativada. O índice é criado a partir das capturas obtidas após ativar a opção e é conservado juntamente com o arquivo.
- Intervalo de capturas (segundos) — tempo mínimo entre capturas; o valor predefinido é 60 segundos e o intervalo permitido é 1–86400. Se um quadro não estiver disponível, conserva-se a hora real da captura obtida.
- Quadros por GOP — número de capturas num grupo que pode ser reproduzido de forma independente; o valor predefinido é 30 e o intervalo permitido é 1–100. Esta definição não altera o intervalo de capturas.
- Primeiro vídeo do índice — fica disponível quando um grupo está completo. Na mudança de hora, as capturas restantes formam um grupo mais curto para permitir a visualização de uma hora incompleta.
Com um intervalo de um minuto, um dia completo sem falhas produz 1440 quadros: a reprodução a 25 fps demora 57,6 segundos. Um intervalo maior reduz o número de quadros e a precisão da pesquisa de eventos; um GOP menor disponibiliza mais cedo o próximo grupo completo.
As definições DVR do modelo seguem as regras habituais: a secção dvr própria do fluxo substitui integralmente a do modelo. Os grupos existentes não mudam quando os parâmetros são alterados; os novos valores aplicam-se aos grupos não confirmados. Desativar o índice interrompe a sua criação; os dados existentes são eliminados juntamente com o arquivo correspondente, de acordo com o respetivo período de retenção.
O índice está disponível para streams sem criptografia.