O link PCI Express é comum às portas da placa. Uma largura elétrica reduzida diminui a banda disponível, mas não indica, por si só, uma falha da captura atual. A comparação de carga e as ações do operador estão descritas abaixo.

Placas de captura¶

A seção Placas de captura responde às perguntas que antes se resolviam lendo a configuração a olho e indo até o servidor: quais placas estão nas máquinas do cluster, quantas portas elas têm, que sinal há nessas portas, qual stream já as ocupou e se alguma placa está superaquecendo.

O que se mostra de uma placa¶

O link PCI Express é marcado como reduzido se a placa está instalada em um slot com menos linhas do que ela própria suporta. O link é comum a todas as portas da placa, portanto define o limite de banda para todas ao mesmo tempo. Um link reduzido não desativa nenhuma porta: ele reduz o número de fluxos que a placa consegue entregar. Um fluxo 2160p50 ocupa cerca de 1,1 GB/s: um slot x4 Gen 3 transporta cerca de 3,5 GB/s, ou seja, três fluxos assim; um slot x4 Gen 2, a metade, ou seja, um.

A variante de firmware define quantos canais a placa tem, quais deles são entradas e quais são saídas, e o que passa por eles: SDI ou ASI. Na captura de tela a DTA-2178 está na variante «2x (12G-SDI+3G-SDI/ASI) with Genlock»: dos seus oito canais, as portas 2 e 5 são entradas, as portas 1 e 6 são saídas e as outras quatro são saídas internas. Outra variante de firmware distribuiria os mesmos oito conectores de outra forma, portanto a direção de uma porta não pode ser deduzida do seu número. A lista completa de variantes de cada modelo está na documentação da DekTec.

A variante de firmware não se troca pela interface: é uma regravação da placa com o utilitário da DekTec e um desligamento, e durante a regravação a captura para em todas as portas da placa.

Portas¶

A linha de uma placa se expande em uma tabela de portas.

O estado de uma porta é nomeado com uma palavra de um vocabulário fechado, porque atrás de cada palavra há uma ação diferente do operador:

Na seção não há um «ocupada» genérico: cada estado tem a sua própria ação, e a tabela a nomeia.

À parte do estado está a direção. A marca «não pode ser entrada» junto a ela não fala do que ocupa a porta agora, mas de que a variante de firmware não a fez entrada. Uma saída comum não leva a marca: o firmware pode passá-la a entrada. Uma saída interna a leva sempre: o firmware a entregou a uma porta vizinha. Só uma regravação muda isso, veja acima.

Duas classes de porta não recebem sinal nenhum e nem sempre têm conector no suporte:

• genlock — entrada de referência: por ela a placa toma o sinal de referência, não o sinal a gravar;
• virtual — não há conector algum; com ele a placa declara a própria referência livre, ou seja, o estado «não está presa a nada».

A coluna Tipo mostra para que tipo de sinal a porta está configurada agora: sd_sdi, hd_sdi, 3g_sdi ou 12g_sdi. É uma configuração, não o limite da porta: uma porta livre guarda o último valor, e assim que um sinal 12G é ligado a uma porta com hd_sdi o tipo muda sozinho.

A coluna Linha diz o que a placa vê na porta agora mesmo:

• resolução e frequência — há sinal, e é este. A letra depois da frequência é o nível do sinal 3G, A ou B;
• «sem sinal» — uma porta de entrada em que a placa não vê nada;
• «desconhecido» — a placa não informou o estado da linha. Saídas, genlock e a porta virtual nunca o têm, e isso não significa ausência de sinal.

Se a placa escala o sinal por conta própria (recebe 12G e entrega 3G para cima) ou detecta na linha um tipo de sinal diferente daquele para o qual a porta está configurada, isso é indicado por uma nota ao lado. Sem essa marca, a divergência entre o padrão da linha e a resolução do stream é lida como um defeito que não existe.

A porta e o stream se ligam nos dois sentidos¶

Da linha de uma porta sai um link para a ficha do stream que a ocupou. O link inverso — «Ver em placas de captura» — está na seção de entrada do stream, ao lado do campo do número de série.

Dali mesmo se escolhem a placa e a porta: os campos da seção SDI (DekTec) tomam seus valores desse mesmo inventário. Os detalhes estão em Captura SDI.

A atribuição é conferida com o firmware, mas a configuração não é rejeitada por isso: ela tem de se aplicar tanto antes de a placa ser instalada quanto em outro streamer. Um stream atribuído a uma porta que, segundo o último instantâneo, não é entrada recebe esse fato nas estatísticas da sua entrada. É isso que explica a recusa «porta ocupada» sem nenhum processo retendo a porta.

Quando as placas não aparecem¶

A seção distingue três «vazios» diferentes porque as ações são diferentes:

• Não há placas. A sondagem ocorreu e não havia placas na máquina. Esses streamers não aparecem na lista de forma alguma.
• Inventário desconhecido. A sondagem falhou. O streamer é listado em uma linha à parte com a causa e há quanto tempo foi a última sondagem bem-sucedida.
• Streamer inacessível. Não há comunicação com o próprio streamer. Também em uma linha à parte, com sua própria causa.

Uma sondagem malsucedida nomeia sua causa:

• o sondador não está instalado — o pacote dektec-bridge não está no host;
• não coube no tempo — a sondagem não terminou dentro do prazo;
• terminou com erro — código de saída diferente de zero;
• respondeu algo ilegível — não foi possível ler sua saída;
• causa desconhecida para esta versão — o streamer nomeou uma causa para a qual o painel não tem palavra.

Os dados são coletados pelo dektec_probe, uma chamada única e não um daemon: o streamer o executa uma vez por minuto, lê o JSON da sua saída e deixa o processo terminar. O sondador não abre portas de forma alguma, então não pode atrapalhar a captura. Ele é instalado pelo pacote dektec-bridge junto com o dektec_ingest; a ausência do pacote no host é um estado normal, no qual a seção diz «inventário desconhecido» em vez de mostrar um parque vazio.

O que vai para o monitoramento¶

Para o Prometheus vão três séries: capture_card_info com os dados estáticos da placa nos rótulos, capture_card_temperature_celsius e capture_card_fan_rpm. A chave de junção é o número de série, e não o endereço no barramento: uma placa é trocada de slot, e o histórico por bus/slot se cortaria embora a placa seja a mesma.

A temperatura e as rotações vão para o monitoramento sempre, não só quando os valores são preocupantes: uma série que aparecesse só com o superaquecimento não se distinguiria da ausência de dados.

Uma placa de refrigeração passiva não tem série de rotações de forma alguma. Não são zero rotações: «não há ventilador» e «o ventilador parou» são coisas diferentes e não devem ser confundidas.

Das portas não há séries: seu estado não muda entre scrapes e não gera alertas, e o estado de linha de uma porta ocupada já viaja pelo lado do stream.

Como ler a indicação PCIe¶

A coluna Barramento mostra os endereços da placa e das portas PCIe anteriores. Cada link indica sua velocidade e largura atuais e, entre parênteses, os máximos. 8 GT/s ×4 (max 8 GT/s ×8) significa quatro pistas Gen3 ativas num link que suporta oito: o tamanho físico do conector da placa-mãe não determina a conexão elétrica.

Captura de vídeo / limite PCIe, entradas ativas descreve a captura ativa, não todos os streams configurados. GB/s significa gigabytes por segundo, não gigabits.

• Largura de banda PCIe insuficiente — a carga calculada das capturas ativas excede o limite físico de pelo menos um link. A placa e suas entradas ativas exibem uma indicação vermelha.
• Limite físico PCIe não excedido — os dados disponíveis não mostram excesso. Isso não garante uma captura correta nem banda disponível.
• Largura de banda desconhecida — faltam dados para um diagnóstico atual ou o snapshot está desatualizado.

O cartão de entrada na página do stream também mostra um indicador vermelho PCIe e um link Carga total / capacidade PCIe para as placas de captura. O erro pode aparecer mesmo com a chegada de quadros. «Atribuído a stream» descreve a atribuição, não a qualidade do vídeo.

A carga de vídeo é um limite inferior (≥); a capacidade PCIe, um limite superior (≤). O cálculo usa o tamanho do quadro transferido, incluindo o passo da linha, e a taxa de quadros. É vídeo sem compressão entre a placa e a memória, não o bitrate H.264/H.265 de saída. A capacidade depende do link atual e dos limites das portas anteriores; numa porta compartilhada somam-se as cargas conhecidas das capturas ativas. Áudio, sobrecarga PCIe e outros dispositivos reduzem a margem.

Exemplo: quatro entradas HDMI¶

As capturas de tela de demonstração mostram uma DeckLink Quad HDMI Recorder com quatro entradas ativas e um link Gen3 ×4. É a interface real com snapshots API fixos, não uma medição do estado atual de uma instalação de produção.

Para Gen3 ×4, o limite superior após a codificação de linha é 8 × 10⁹ × 4 × 128/130 ÷ 8 ≈ 3.938 GB/s. A placa do exemplo transfere ARGB, quatro bytes por pixel, sem preenchimento adicional nas linhas.

Quatro capturas 3840×2160 a 30 fps exigem pelo menos 4 × 3840 × 2160 × 4 × 30 = 3 981 312 000 bytes/s, ou 3.981 GB/s. Isso excede 3.938 GB/s: a placa e as quatro entradas mostram um erro.

Ao mudar as quatro fontes para 1920×1080 a 60 fps, a carga cai para 4 × 1920 × 1080 × 4 × 60 = 1 990 656 000 bytes/s. A interface arredonda para 1.991 GB/s. A indicação vermelha desaparece e surge «Limite físico PCIe não excedido».

O exemplo fixa o sinal e o formato: esses números não se aplicam a outro formato de pixel, preenchimento de linhas ou taxa de quadros.

Como resolver a falta de banda¶

1. Siga o link do cartão de entrada e confira o link ativo, o número de capturas e o formato do sinal.
2. Reduza a resolução ou a taxa de quadros do sinal de saída real da fonte, ou pare capturas desnecessárias que compartilham o barramento. A resolução da área de trabalho do Windows pode diferir do «Modo de sinal ativo»: reduzir apenas a área de trabalho não reduz um sinal HDMI 4K.
3. Se precisar do modo original, mova a placa para um slot com largura elétrica suficiente e confira as portas PCIe anteriores. Desligue o servidor conforme as instruções do fabricante antes de mover a placa.
4. Recarregue a página após a atualização das estatísticas, confirme que o erro desapareceu e confira separadamente o vídeo e os erros da entrada do stream.

Reduzir o bitrate do transcodificador não reduz a transferência de quadros sem compressão por PCIe. A indicação vermelha não altera a fonte nem para a captura automaticamente.

Quando faltam dados¶

Velocidade ou largura de link desconhecidas, formato de captura ativa ausente ou dados de um streamer antigo não significam banda suficiente. Quando o streamer fica inacessível ou a consulta falha, o inventário pode continuar visível, mas a indicação vermelha antiga da porta deixa de ser apresentada como erro atual.

Restabeleça a conexão ou resolva a falha de consulta e obtenha estatísticas novas. Reinstalar o driver não é uma solução universal para largura elétrica PCIe insuficiente.