Desbordamiento de eventos
Lo que hace el desbordamiento de eventos
El Desbordamiento de Eventos es una salvaguarda de estabilidad a nivel de plataforma en GCXONE que protege automáticamente el sistema de ser inundado por un dispositivo que no funciona o está mal configurado. Sin esta protección, un solo sensor ruidoso podría enviar miles de alarmas en minutos, sobrecargando potencialmente toda la infraestructura de procesamiento de alarmas e afectando a todos los clientes de la plataforma.
Por qué importa
Sin protección contra desbordamiento de eventos, un solo sensor ruidoso podría inundar toda la plataforma, afectando no solo a un cliente, sino a todos los que comparten la infraestructura. El sistema de umbral garantiza que un dispositivo mal configurado no pueda desactivar el procesamiento de alarmas para todos los demás.
Cómo funciona
GCXONE — Nivel de dispositivo
GCXONE opera por defecto a nivel de plataforma para evitar el agotamiento de recursos. El sistema monitoriza las alarmas entrantes a nivel individual del dispositivo/sensor:
- **Umbral: **Si un solo dispositivo envía más de 25 alarmas en cualquier ventana de 5 minutos, se supera el umbral de desbordamiento.
- **Tipo de alarma: **El sistema genera un tipo de alarma interna llamado event.overflow para registrar y señalizar el incidente.
- **Supresión: **Todas las alarmas adicionales de ese sensor específico se descartan durante el resto de la ventana de 5 minutos.
- **Recurrencia: **El sistema vuelve a comprobar al inicio de cada nueva ventana de 5 minutos. Si la tasa de alarma se mantiene por encima del umbral, se incrementa otro evento. El desbordamiento y continúa la supresión.
Talos (CMS) — Nivel de sitio
Incluso si los conteos de alarma de dispositivos individuales pasan por GCXONE, pueden seguir bloqueándose a nivel CMS (Evalink Talos), que aplica lógica de desbordamiento a nivel de sitio — en todos los dispositivos de un sitio:
- **Umbral a nivel de sitio: **Talos agrega alarmas en todos los sensores de un sitio. Por ejemplo, si dos dispositivos envían cada uno 15 alarmas (por debajo del umbral de 25 por dispositivo de GCXONE), GCXONE las permite pasar individualmente — pero Talos detecta un total de 30 alarmas para el sitio y las bloquea.
- **Código de error: **En Talos, esto aparece como el código de error Límite de alarma excedido.
Capacidades clave
Configuración y personalización
Los umbrales por defecto están diseñados para la seguridad general de los andenes. Para inquilinos con requisitos legítimos de alarma de alto volumen, estos umbrales pueden ajustarse utilizando Propiedades Personalizadas:
- **Umbrales configurables: **Para inquilinos específicos de alta prioridad, el límite por defecto de 25 alarmas puede aumentarse (por ejemplo, a 50 o 100). Esto se establece a nivel de inquilino o proveedor de servicios.
- **Nombre personalizado de la propiedad: **El parámetro utilizado para ajustar esto es style.overflow.threshold.
- **Duración del aislamiento: **El defaultIsolationDuration (establecido a nivel de proveedor de servicios, en minutos) puede configurarse si un cliente requiere un comportamiento diferente de supresión de notificaciones.
Nota importante para los CSM — Los cambios en los umbrales deben coordinarse con el equipo de I&D y solo deben aplicarse tras confirmar que el alto volumen de alarma es legítimo (por ejemplo, sitios industriales con alta actividad de sensores) y no el resultado de un dispositivo mal configurado.
Mejores prácticas
Recordatorio clave — El desbordamiento de eventos es una característica protectora — no un error. Cuando se activa, significa que el sistema está funcionando según lo diseñado para proteger la plataforma. La prioridad siempre es identificar y corregir la configuración subyacente del dispositivo que genera un volumen de alarma excesivo.
- Cambiar de Detección Básica de Movimiento a Eventos Inteligentes (IVS) — El cruce de líneas y la detección de intrusiones solo se dirigen a eventos reales, eliminando la causa raíz de la mayoría de los incidentes de desbordamiento.
- Ejecuta el cliente de prueba del fabricante antes de escalar al equipo de plataforma: si también se inunda, se confirma que el problema es el dispositivo, no GCXONE.
- Coordina con el equipo de investigación y desarrollo antes de ajustar los umbrales — solo aumenta los límites después de confirmar que el alto volumen de alarma es legítimo y no el resultado de un dispositivo mal configurado.
- Notifica al cliente cuando haya desbordamiento activo — infórmale de que se están descartando alarmas para que pueda decidir si es notificado de inmediato o si prefiere una ventana de supresión con tiempo.
Detalles adicionales
Solución de problemas — Identificación de la causa
Cuando un dispositivo se bloquea por desbordamiento, casi nunca es un error de plataforma. La causa raíz casi siempre es un problema de configuración a nivel del sitio físico.
- Paso 1 — Abre el panel de GCXONE y busca sensores que muestren un estado bloqueado o entradas de registro de evento.overflow.
- Paso 2 — Accede al NVR físico o a los registros de la cámara para verificar si realmente está produciendo una avalancha de eventos.
- Paso 3 — Ejecutar el cliente de pruebas del fabricante (por ejemplo, Cliente de Pruebas Hikvision, Herramienta de Configuración Dahua). Si el cliente de prueba también se inunda, el problema es el dispositivo, no la plataforma.
Soluciones recomendadas
Una vez identificada la causa, utiliza los siguientes métodos de remediación:
Recomendado: Cambiar a Eventos Inteligentes (IVS) — La causa raíz más común del desbordamiento es el uso de la Detección Básica de Movimiento, que se activa en cualquier cambio de píxel — viento, lluvia, reflejos, insectos. Recomendamos encarecidamente cambiar a eventos de Sistema de Vídeo Inteligente (IVS):
- Detección de cruces de líneas — se activa solo cuando un objeto cruza una línea definida.
- Detección de intrusiones — se activa solo cuando un objeto entra en una zona definida.
- Filtros para personas/vehículos — aplica IA en el lado del borde para ignorar movimientos no humanos o no vehiculares antes de enviar cualquier señal.
Opciones adicionales de mitigación
- Reducir la sensibilidad de la detección de movimiento: Reducir la sensibilidad de la cámara o el NVR, o aumentar el umbral mínimo de tamaño de objeto, para que pequeños cambios ambientales no activen alarmas.
- Ajustar el tiempo umbral: Configura el dispositivo para que requiera una duración sostenida de detección (por ejemplo, 2 segundos de movimiento continuo) antes de enviar una alarma — esto filtra los disparadores fugaces y no amenazantes.
- Notifique al cliente: Si un dispositivo entra en desbordamiento durante un periodo de monitorización activa, informe al cliente de que se están descartando alarmas. Deberían decidir si reciben notificaciones inmediatamente cuando empiece el desbordamiento, o prefieren una ventana de supresión temporizada.