El enlace PCI Express es común a los puertos de la tarjeta. Un ancho eléctrico reducido disminuye la banda disponible, pero por sí solo no indica un fallo de la captura actual. La comparación de carga y las acciones del operador se explican más abajo.

Tarjetas de captura¶

La sección Tarjetas de captura responde a las preguntas que antes se resolvían leyendo la configuración a ojo y acercándose al servidor: qué tarjetas hay en las máquinas del clúster, cuántos puertos tienen, qué señal hay en esos puertos, qué stream los ha ocupado ya y si una tarjeta se está recalentando.

Qué se muestra de una tarjeta¶

El enlace PCI Express se marca como reducido si la tarjeta está instalada en una ranura con menos líneas de las que ella misma admite. El enlace es común a todos los puertos de la tarjeta, así que fija el límite de ancho de banda para todos a la vez. Un enlace reducido no desactiva ningún puerto: reduce el número de flujos que la tarjeta alcanza a entregar. Un flujo 2160p50 ocupa unos 1,1 GB/s: una ranura x4 Gen 3 transporta unos 3,5 GB/s, es decir, tres flujos así; una ranura x4 Gen 2, la mitad, es decir, uno.

La variante de firmware define cuántos canales tiene la tarjeta, cuáles de ellos son entradas y cuáles salidas, y qué llevan: SDI o ASI. En la captura la DTA-2178 está en la variante «2x (12G-SDI+3G-SDI/ASI) with Genlock»: de sus ocho canales, los puertos 2 y 5 son entradas, los puertos 1 y 6 son salidas y los otros cuatro son salidas internas. Otra variante de firmware distribuiría los mismos ocho conectores de otra manera, así que la dirección de un puerto no se puede deducir de su número. La lista completa de variantes de cada modelo está en la documentación de DekTec.

La variante de firmware no se cambia desde la interfaz: es una reprogramación de la tarjeta con la utilidad de DekTec y un apagado, y durante la reprogramación la captura se detiene en todos los puertos de la tarjeta.

Puertos¶

La fila de una tarjeta se despliega en una tabla de puertos.

El estado de un puerto se nombra con una palabra de un vocabulario cerrado, porque detrás de cada palabra hay una acción distinta del operador:

En la sección no hay un «ocupado» genérico: cada estado tiene su propia acción, y la tabla la nombra.

Aparte del estado está la dirección. La marca «no puede ser entrada» junto a ella no habla de en qué está ocupado el puerto ahora, sino de que la variante de firmware no lo hizo entrada. Una salida normal no lleva la marca: el firmware puede pasarla a entrada. Una salida interna la lleva siempre: el firmware la entregó a un puerto vecino. Solo una reprogramación cambia esto, véase más arriba.

Dos clases de puerto no reciben señal en absoluto y no siempre tienen conector en el soporte:

• genlock — entrada de referencia: por ella la tarjeta toma la señal de referencia, no la señal a grabar;
• virtual — no hay conector alguno; con él la tarjeta declara su propia referencia libre, es decir el estado «no está atada a nada».

La columna Tipo muestra para qué tipo de señal está configurado el puerto ahora mismo: sd_sdi, hd_sdi, 3g_sdi o 12g_sdi. Es un ajuste, no el límite del puerto: un puerto libre conserva el último valor, y en cuanto se conecta una señal 12G a un puerto con hd_sdi el tipo cambia solo.

La columna Línea dice lo que la tarjeta ve en el puerto ahora mismo:

• resolución y frecuencia — hay señal, y es esta. La letra tras la frecuencia es el nivel de la señal 3G, A o B;
• «sin señal» — un puerto de entrada en el que la tarjeta no ve nada;
• «desconocido» — la tarjeta no informó del estado de la línea. Las salidas, el genlock y el puerto virtual nunca lo tienen, y no significa ausencia de señal.

Si la tarjeta escala la señal por su cuenta (recibe 12G y entrega 3G hacia arriba) o detecta en la línea un tipo de señal distinto de aquel para el que está configurado el puerto, se indica con una nota al lado. Sin esa marca, la discrepancia entre el estándar de la línea y la resolución del stream se lee como un defecto que no existe.

El puerto y el stream se enlazan en ambos sentidos¶

Desde la fila de un puerto sale un enlace a la ficha del stream que lo ha ocupado. El enlace inverso — «Ver en tarjetas de captura» — está en la sección de entrada del stream, junto al campo del número de serie.

Desde ahí mismo se eligen la tarjeta y el puerto: los campos de la sección SDI (DekTec) toman sus valores de ese mismo inventario. Los detalles están en Captura SDI.

La asignación se coteja con el firmware, pero la configuración no se rechaza por ello: tiene que aplicarse tanto antes de instalar la tarjeta como en otro streamer. Un stream asignado a un puerto que según la última instantánea no es una entrada recibe ese hecho en las estadísticas de su entrada. Eso es lo que explica el rechazo «puerto ocupado» sin ningún proceso que retenga el puerto.

Cuando no se ven las tarjetas¶

La sección distingue tres «vacíos» distintos porque las acciones son distintas:

• No hay tarjetas. El sondeo se hizo y en la máquina no había tarjetas. Esos streamers no aparecen en la lista en absoluto.
• Inventario desconocido. El sondeo falló. El streamer se lista en una fila aparte con la causa y la antigüedad del último sondeo que sí salió bien.
• Streamer inaccesible. No hay comunicación con el streamer. También en una fila aparte con su propia causa.

Un sondeo fallido nombra su causa:

• el sondeador no está instalado — el paquete dektec-bridge no está en el host;
• no llegó a tiempo — el sondeo no terminó dentro del plazo;
• terminó con error — código de salida distinto de cero;
• respondió algo ilegible — no se pudo leer su salida;
• causa desconocida para esta versión — el streamer nombró una causa para la que el panel no tiene palabra.

Los datos los toma dektec_probe, una llamada única y no un demonio: el streamer lo lanza una vez por minuto, lee el JSON de su salida y deja que el proceso termine. El sondeador no abre puertos en absoluto, así que no puede estorbar a la captura. Se instala con el paquete dektec-bridge junto a dektec_ingest; que el paquete no esté en el host es un estado normal, en el que la sección dice «inventario desconocido» en vez de mostrar un parque vacío.

Qué va a la monitorización¶

A Prometheus van tres series: capture_card_info con los datos estáticos de la tarjeta en las etiquetas, capture_card_temperature_celsius y capture_card_fan_rpm. La clave de unión es el número de serie, no la dirección en el bus: una tarjeta se cambia de ranura, y el historial por bus/slot se cortaría aunque la tarjeta sea la misma.

La temperatura y las revoluciones van a la monitorización siempre, no solo cuando los valores son preocupantes: una serie que apareciera solo con el recalentamiento no se distinguiría de la ausencia de datos.

Una tarjeta de refrigeración pasiva no tiene serie de revoluciones en absoluto. No son cero revoluciones: «no hay ventilador» y «el ventilador se ha parado» son cosas distintas y no deben confundirse.

De los puertos no hay series: su estado no cambia entre scrapes y no genera alertas, y el estado de línea de un puerto ocupado ya viaja por el lado del stream.

Cómo leer la indicación PCIe¶

La columna Bus muestra las direcciones de la tarjeta y de los puertos PCIe anteriores. Cada enlace indica su velocidad y ancho actuales y, entre paréntesis, los máximos. 8 GT/s ×4 (max 8 GT/s ×8) significa cuatro líneas Gen3 activas en un enlace que admite ocho: el tamaño físico del conector de la placa base no determina la conexión eléctrica.

Captura de vídeo / límite PCIe, entradas activas describe la captura activa, no todos los streams configurados. GB/s significa gigabytes por segundo, no gigabits.

• Ancho de banda PCIe insuficiente — la carga calculada de las capturas activas supera el límite físico de al menos un enlace. La tarjeta y sus entradas activas muestran una indicación roja.
• Límite físico PCIe no superado — los datos disponibles no muestran un exceso. Esto no garantiza una captura correcta ni ancho de banda disponible.
• Ancho de banda desconocido — faltan datos para un diagnóstico actual o la instantánea está desactualizada.

La tarjeta de entrada de la página del stream también muestra un indicador rojo PCIe y un enlace Carga total / capacidad PCIe a las tarjetas de captura. El error puede aparecer aunque sigan llegando fotogramas. «Asignado a stream» describe la asignación, no la calidad del vídeo.

La carga de vídeo es un límite inferior (≥); la capacidad PCIe, uno superior (≤). El cálculo usa el tamaño del fotograma transferido, incluido el paso de fila, y la frecuencia de fotogramas. Es vídeo sin comprimir entre la tarjeta y la memoria, no el bitrate H.264/H.265 de salida. La capacidad depende del enlace actual y de los límites de los puertos anteriores; en un puerto compartido se suman las cargas conocidas de las capturas activas. El audio, la sobrecarga PCIe y otros dispositivos reducen el margen.

Ejemplo: cuatro entradas HDMI¶

Las capturas de pantalla de demostración muestran una DeckLink Quad HDMI Recorder con cuatro entradas activas y un enlace Gen3 ×4. Es la interfaz real con instantáneas API fijas, no una medición del estado actual de una instalación de producción.

Para Gen3 ×4, el límite superior tras la codificación de línea es 8 × 10⁹ × 4 × 128/130 ÷ 8 ≈ 3.938 GB/s. La tarjeta del ejemplo transfiere ARGB, cuatro bytes por píxel, sin relleno adicional de filas.

Cuatro capturas 3840×2160 a 30 fps necesitan al menos 4 × 3840 × 2160 × 4 × 30 = 3 981 312 000 bytes/s, es decir, 3.981 GB/s. Superan 3.938 GB/s: la tarjeta y las cuatro entradas muestran un error.

Al cambiar las cuatro fuentes a 1920×1080 a 60 fps, la carga baja a 4 × 1920 × 1080 × 4 × 60 = 1 990 656 000 bytes/s. La interfaz la redondea a 1.991 GB/s. La indicación roja desaparece y aparece «Límite físico PCIe no superado».

El ejemplo fija la señal y el formato: estas cifras no se aplican a otro formato de píxel, relleno de filas o frecuencia.

Cómo resolver la falta de ancho de banda¶

1. Siga el enlace desde la tarjeta de entrada y compruebe el enlace activo, el número de capturas y el formato de señal.
2. Reduzca la resolución o frecuencia de la señal de salida real de la fuente, o detenga capturas innecesarias que comparten el bus. La resolución del escritorio de Windows puede diferir del «Modo de señal activa»: reducir solo el escritorio no reduce una señal HDMI 4K.
3. Si necesita el modo original, mueva la tarjeta a una ranura con suficiente ancho eléctrico y compruebe los puertos PCIe anteriores. Apague el servidor según las instrucciones del fabricante antes de mover la tarjeta.
4. Recargue la página tras actualizarse las estadísticas, compruebe que desaparece el error y revise por separado el vídeo y los errores de entrada del stream.

Reducir el bitrate del transcodificador no reduce la transferencia de fotogramas sin comprimir por PCIe. La indicación roja no modifica la fuente ni detiene automáticamente la captura.

Cuando faltan datos¶

Una velocidad o un ancho de enlace desconocidos, la falta del formato de captura activa o los datos de un streamer antiguo no indican que haya ancho de banda suficiente. Si se pierde la conexión con el streamer o falla la consulta, el inventario puede seguir visible, pero la indicación roja antigua del puerto deja de mostrarse como error actual.

Restablezca la conexión o resuelva el fallo de consulta y obtenga estadísticas nuevas. Reinstalar el controlador no es una solución universal para un ancho eléctrico PCIe insuficiente.