Saltar al contenido principal

Métricas

SecureVu expone métricas de Prometheus en el endpoint /api/metrics que pueden usarse para monitorizar el rendimiento y la salud de tu instancia SecureVu.

Métricas disponibles​

Métricas del sistema​

  • securevu_cpu_usage_percent{pid="", name="", process="", type="", cmdline=""} — Porcentaje de uso de CPU por proceso
  • securevu_mem_usage_percent{pid="", name="", process="", type="", cmdline=""} — Porcentaje de uso de memoria por proceso
  • securevu_gpu_usage_percent{gpu_name=""} — Porcentaje de utilización de GPU
  • securevu_gpu_mem_usage_percent{gpu_name=""} — Porcentaje de uso de memoria de GPU

Métricas de cámara​

  • securevu_camera_fps{camera_name=""} — Fotogramas por segundo consumidos de tu cámara
  • securevu_detection_fps{camera_name=""} — Número de veces que se ejecuta la detección por segundo
  • securevu_process_fps{camera_name=""} — Fotogramas por segundo procesados
  • securevu_skipped_fps{camera_name=""} — Fotogramas por segundo omitidos para procesamiento
  • securevu_detection_enabled{camera_name=""} — Estado de detección habilitada para la cámara
  • securevu_audio_dBFS{camera_name=""} — Audio dBFS de la cámara
  • securevu_audio_rms{camera_name=""} — Audio RMS de la cámara

Métricas del detector​

  • securevu_detector_inference_speed_seconds{name=""} — Tiempo empleado en detección de objetos en segundos
  • securevu_detection_start{name=""} — Tiempo de inicio del detector (timestamp Unix)

Métricas de almacenamiento​

  • securevu_storage_free_bytes{storage=""} — Bytes libres de almacenamiento
  • securevu_storage_total_bytes{storage=""} — Bytes totales de almacenamiento
  • securevu_storage_used_bytes{storage=""} — Bytes usados de almacenamiento
  • securevu_storage_mount_type{mount_type="", storage=""} — Información del tipo de montaje

Métricas del servicio​

  • securevu_service_uptime_seconds — Tiempo de funcionamiento en segundos
  • securevu_service_last_updated_timestamp — Hora de registro de estadísticas (timestamp Unix)
  • securevu_device_temperature{device=""} — Temperatura del dispositivo

Métricas de eventos​

  • securevu_camera_events{camera="", label=""} — Contador de eventos de cámara desde que inició el exportador

Configurar Prometheus​

Para recopilar métricas de SecureVu, añade lo siguiente a tu configuración de Prometheus:

scrape_configs:
  - job_name: 'securevu'
    metrics_path: '/api/metrics'
    static_configs:
      - targets: ['securevu:5000']
    scrape_interval: 15s

Consultas de ejemplo​

Algunas consultas PromQL de ejemplo que pueden ser útiles:

# Uso promedio de CPU en todos los procesos
avg(securevu_cpu_usage_percent)

# Uso total de memoria de GPU
sum(securevu_gpu_mem_usage_percent)

# FPS de detección por cámara
rate(securevu_detection_fps{camera_name="front_door"}[5m])

# Porcentaje de uso de almacenamiento
(securevu_storage_used_bytes / securevu_storage_total_bytes) * 100

# Conteo de eventos por cámara en la última hora
increase(securevu_camera_events[1h])

Panel de Grafana​

Puedes usar estas métricas para crear paneles de Grafana y monitorizar tu instancia SecureVu. Algunas métricas que podrías querer rastrear:

  • Uso de CPU, memoria y GPU a lo largo del tiempo
  • FPS de cámara y tasas de detección
  • Uso y tendencias de almacenamiento
  • Conteos de eventos por cámara
  • Temperaturas del sistema

Un JSON de panel de Grafana de ejemplo se proporcionará en una actualización futura.

Tipos de métrica​

Las métricas expuestas por SecureVu usan los siguientes tipos de métricas de Prometheus:

  • Counter: Valores acumulativos que solo aumentan (p. ej., securevu_camera_events)
  • Gauge: Valores que pueden subir y bajar (p. ej., securevu_cpu_usage_percent)
  • Info: Pares clave-valor para metadatos (p. ej., securevu_storage_mount_type)

Para más información sobre los tipos de métricas de Prometheus, consulta la documentación de Prometheus.