Instalación de videoanalítica¶

La analítica detecta objetos y crea episodios para búsqueda y visualización. Requiere servicios y modelos. Watcher/watcher-streamer recibe y graba vídeo; la analítica se conecta aparte.

El módulo contiene:

• Inference — analiza streams y detecta objetos.
• Identification — identifica objetos y trabaja con datos de personas.

Preparar servidor¶

Dedique un servidor con acceso a Watcher, Central y vídeo. La carga depende de streams, resolución, frecuencia y detectores. Compartir con grabación exige comprobar reserva de recursos.

Puede probar conexión con CPU. Para producción, elija acelerador y memoria según pruebas con sus streams; consulte recursos de analítica. El controlador debe corresponder al hardware y runtime. Compruebe compatibilidad de SO y equipo con el conjunto suministrado.

Vision 26.11 ofrece cpu, cuda, jetson y vulkan. CPU x86-64 especifica AVX2. Cada opción necesita modelos y runtime; compruebe hardware con sus versiones reales.

El contenedor Inference 26.11 usa Ubuntu 22.04. Es el entorno interno: host y controladores se comprueban aparte. CUDA se compila con 11.5 en x86-64 y 10.2 en ARM64; Jetson usa SDK L4T R32.7.5. No establece compatibilidad universal con GPU, Jetson o JetPack. Seleccione compute capability mínima y memoria según modelos y medidas.

Instalar paquetes¶

Ejecute como root. Configure el repositorio estable si falta; consulte instalación Watcher.

apt update
apt-get -s install flussonic-vision
apt install flussonic-vision

Revise el plan: 26.11 incluye vision-inference y vision-identification 26.11 y vision-models. Los modelos de distintas plataformas se suministran juntos.

El instalador crea configuración y ejemplos en /etc/vision/. Complete los archivos operativos: instalar paquetes no conecta cámaras automáticamente.

Añadir analítica a Watcher¶

Registre cada servicio como nodo separado mediante Admin API, con permisos de administrador Watcher. Use hostname único, rol y API URL. En el mismo servidor use puertos diferentes.

El rol se establece con role. Streamers → Añadir streamer crea uno ordinario y no permite elegir Inference o Identification. Use estas solicitudes con autenticación administrativa.

Sustituya direcciones y claves de ejemplo. No publique solicitudes completas: api_url y cluster_key contienen acceso al servicio.

Añadir Inference¶

Envíe PUT /watcher/admin-api/v3/streamers/inference1 con:

{
  "hostname": "inference1",
  "role": "inference",
  "api_url": "http://INFERENCE_API_KEY@vision.example.com:9030",
  "cluster_key": "INFERENCE_API_KEY"
}

INFERENCE_API_KEY debe coincidir con API_KEY del servicio. Se usa inference1 en CONFIG_EXTERNAL.

Añadir Identification¶

Envíe PUT /watcher/admin-api/v3/streamers/identification1 con:

{
  "hostname": "identification1",
  "role": "identification",
  "api_url": "http://IDENTIFICATION_API_KEY@vision.example.com:9050",
  "cluster_key": "IDENTIFICATION_API_KEY"
}

IDENTIFICATION_API_KEY debe coincidir con su API_KEY. Para conectar a Central se usa otra clave Central.

Tras configurar y arrancar, lea GET /watcher/admin-api/v3/streamers/inference1 y GET /watcher/admin-api/v3/streamers/identification1: nombres, roles y direcciones deben coincidir. Streamers muestra disponibilidad.

Configurar servicios¶

Los ejemplos suponen Central accesible mediante watcher.example.com. Sustituya nombres, direcciones y claves. Las URL deben ser accesibles desde analítica.

Inference¶

Complete /etc/vision/vision-inference.conf:

HTTP_PORT=9030
API_KEY=INFERENCE_API_KEY
HW=cpu
CONFIG_EXTERNAL=http://CENTRAL_API_KEY@watcher.example.com/central/api/v3/streamers/inference1/streams

Parámetros:

• HTTP_PORT — puerto que coincide con API URL en Watcher.
• API_KEY — clave de Inference.

• HW — plataforma. El ejemplo del paquete 26.11 contiene HW=cpu. Opciones:

  • cpu — procesamiento CPU.
  • cuda — NVIDIA CUDA configurada.
  • jetson — NVIDIA Jetson compatible.
  • vulkan — runtime Vulkan compatible.

• CONFIG_EXTERNAL — configuración de cámaras desde Central; inference1 coincide con el nodo registrado.

Obtenga CENTRAL_API_KEY de su configuración. Si Central está instalado por paquetes localmente, use /etc/central/central.conf.

Un proceso Inference usa un dispositivo. Para varias GPU, ejecute instancias con archivos, puertos y DEVICEID distintos. Se proporciona vision-inference@.service.

Identification¶

Complete /etc/vision/vision-identification.conf:

HTTP_PORT=9050
API_KEY=IDENTIFICATION_API_KEY
CENTRAL_URL=http://CENTRAL_API_KEY@watcher.example.com/central/api/v3

Parámetros:

• HTTP_PORT — puerto coincidente con API URL de Identification.
• API_KEY — clave de este servicio.
• CENTRAL_URL — API Central con clave para los datos de identificación.

Arrancar y comprobar¶

Aplique:

systemctl restart vision-inference vision-identification
systemctl status vision-inference vision-identification
journalctl -u vision-inference -u vision-identification -n 100 --no-pager

Compruebe ambos nodos en Streamers. Ante falta de conexión, revise direcciones, puertos, claves y red.

Active un detector en una cámara de prueba: caras o matrículas. Compruebe episodios en Eventos y carga del servidor. Un indicador verde confirma conexión, pero no sustituye revisar resultados sobre vídeo.

Consulte actualización de analítica.