Saltar al contenido principal

Runbook — incidentes vstation (resumen operativo)

MediaMTX API inaccesible​

  1. curl -u user:pass http://<mtx>:9997/v3/config/global/get
  2. Revisar firewall :9997 solo desde vstation.
  3. Logs vstation: docker logs vstation-app 2>&1 | grep -i mediamtx

MinIO lento o sin espacio​

  1. Console o mc admin info
  2. Alerta >85% disco; revisar ILM y legal hold masivo.
  3. iostat -x 5 en nodo MinIO.

LiveKit saturado / sin video vivo​

  1. LiveKit API: rooms activas vs ingestas esperadas.
  2. vstation: procesos GStreamer huérfanos (docker exec vstation-app ps aux | grep gst).
  3. Preferir H.264 nativo; evitar transcode H.265 a escala.

Grabación sin segmentos nuevos​

  1. GET /v3/paths/list — paths ingest/camera-* con record: true.
  2. Verificar hook minio.sh en servidor MediaMTX (ver infra/minio-upload.example.sh).
  3. npm run recording:smoke desde entorno con credenciales.

Despliegue​

Desde tu máquina (.env con DO_host, DO_user, DO_password):

./scripts/deploy-droplet.sh

En el droplet (manual):

cd /root/vstation && git pull && docker compose up -d --build app nginx
curl -s https://vstation.optrax.io/api/health