Triggers

Triggers son un mecanismo de análisis de líneas de log en Senta que permite la ejecución automática de acciones cuando se detectan condiciones específicas.

El propósito principal de los triggers es monitorear el estado del stream y reiniciar automáticamente los streams cuando se detectan problemas.

El sistema admite dos tipos de triggers:

• Estáticos
• Dinámicos (personalizados)

---

Triggers Estáticos

Los triggers estáticos están integrados en el sistema. Actualmente, está disponible un trigger estático — el trigger de análisis de bitrate.

Trigger Estático de Bitrate

• Tiene un ID = 1 fijo
• Preinstalado en el sistema
• No se puede eliminar
• Se puede asignar y desasignar de los canales

Cómo Funciona

A pesar del nombre, el trigger no analiza ni compara valores de bitrate — no mide ningún parámetro del stream por medios externos (por ejemplo, ffprobe). Su única fuente de datos es la salida de progreso en texto que imprime el propio proceso ffmpeg: el trigger observa el campo time= de esa salida (la marca de tiempo del último fotograma procesado). Si esa marca deja de avanzar entre líneas del log, ffmpeg está atascado — aunque el proceso siga técnicamente en ejecución — y el trigger lo interpreta como una congelación del stream.

En tales casos, el trigger ejecuta automáticamente un reinicio del stream.

Cómo Asignar un Trigger Estático

1. Vaya a la página Disparadores.

2. Seleccione el trigger Bitrate

3. Marque las casillas de los canales deseados en la lista de canales

4. Guarde los cambios

Después de esto, los canales seleccionados serán monitoreados automáticamente por bitrate.

---

Triggers Dinámicos (Personalizados)

Los triggers dinámicos le permiten crear sus propias reglas de análisis de logs.

El sistema puede:

• buscar ocurrencias de subcadenas en líneas de log
• verificar líneas de log contra expresiones regulares

Cuando se cumple una condición, se ejecuta una acción especificada (p. ej., reinicio del stream).

---

Creación de un Trigger Personalizado

Para crear un nuevo trigger:

1. Vaya a la página Disparadores.

2. Haga clic en Agregar disparador

   

3. Introduzca el nombre del trigger

4. Si es necesario, active la opción Expresión regular

5. Introduzca el texto a buscar en el campo Coincidencia de subcadena (o Expresión regular, si activaste esa opción arriba — la etiqueta del campo cambia en consecuencia)

   

6. Guarde el trigger

7. Seleccione la lista de streams a los que se debe aplicar este trigger

Después de guardar, el trigger comenzará a analizar los logs de los streams seleccionados.