La reproducción de grabaciones falla
VaultPAM registra cada sesión proxificada y almacena la grabación en almacenamiento de objetos (MinIO). La reproducción se renderiza en el navegador utilizando un reproductor integrado. Cuando la reproducción falla, la causa suele ser una de cuatro: la grabación aún se está procesando, el backend de almacenamiento es temporalmente inaccesible, el navegador no admite el códec requerido, o el usuario no tiene permiso para ver la grabación.
Síntomas
- Al hacer clic en Play (Reproducir) en una sesión en Sessions → History (Sesiones → Historial), se muestra un indicador de carga que nunca se resuelve.
- Aparece un banner de error:
Recording unavailable(Grabación no disponible),Playback error(Error de reproducción) oFailed to load recording(Error al cargar grabación). - El reproductor se carga pero muestra un fotograma en blanco o congelado sin controles.
- La reproducción comienza pero se detiene a mitad de camino con un error de códec o descodificación.
- Ve la entrada de sesión en la lista pero el botón Play (Reproducir) está deshabilitado.
Causas
1. Grabación aún en procesamiento
Las sesiones muy recientes (terminadas en los últimos 2–5 minutos) aún pueden no estar completamente ingeridas e indexadas. El pipeline de grabación finaliza el archivo de grabación, verifica su integridad y lo registra en el catálogo antes de que la reproducción esté disponible. Durante esta ventana, el botón Play (Reproducir) está deshabilitado o el reproductor devuelve "Recording unavailable" (Grabación no disponible).
Verificar: Mire la marca de tiempo Ended at (Finalizado en) de la sesión. Si fue hace menos de 5 minutos, la grabación probablemente aún se está procesando.
Solución: Espere 5 minutos y actualice la página. El botón Play (Reproducir) se activará una vez que se complete el procesamiento. Si la sesión finalizó hace más de 15 minutos y la reproducción aún no está disponible, continúe con la siguiente causa.
2. MinIO almacenamiento inaccesible
Las grabaciones se almacenan en MinIO (o un backend compatible con S3). Si el servicio de almacenamiento es inaccesible — debido a una partición de red, reinicio del servicio o configuración incorrecta — el endpoint de reproducción no puede recuperar el archivo de grabación y devuelve un error.
Verificar para operadores: En el host VaultPAM o en el clúster, confirme que MinIO está ejecutándose y es accesible:
curl -sv http://<minio-host>:9000/minio/health/live
Una respuesta 200 OK confirma que MinIO es saludable. Confirme también que el bucket de grabación existe y que la cuenta de servicio de VaultPAM tiene acceso de lectura.
Solución para operadores: Restaure la conectividad de MinIO o reinicie el servicio MinIO. Después de la recuperación, reintente la reproducción — las grabaciones se recuperan bajo demanda y no necesitan ser reingeridas.
3. Códec del navegador no admitido
El reproductor VaultPAM utiliza codificación de video WebM/VP8 o VP9. Algunos navegadores más antiguos o compilaciones de navegador endurecidas para empresas tienen restricciones de códec que impiden la reproducción.
Verificar: Intente reproducir en un navegador diferente (se recomiendan Chrome o Firefox). Si la reproducción tiene éxito en otro navegador, el navegador original tiene una restricción de códec.
Navegadores admitidos para reproducción de grabaciones:
- Chrome 90+
- Firefox 90+
- Edge 90+ (basado en Chromium)
Safari tiene soporte limitado para VP9 en versiones anteriores de macOS.
Solución: Use un navegador admitido. Si un navegador específico es requerido por política, pregunte a su administrador de VaultPAM si el formato de grabación puede ser cambiado (esto es una configuración del lado del servidor).
4. Permisos insuficientes
La reproducción está controlada por la membresía de Safe y los permisos de rol. Un usuario debe tener el permiso View recordings (Ver grabaciones) para el Safe al que pertenece la sesión. Los administradores y propietarios de Safe tienen este permiso por defecto; los miembros regulares pueden no tenerlo.
Verificar: Confirme que es miembro del Safe al que pertenece la sesión y que su rol incluye View recordings (Ver grabaciones). En Safes → pick Safe → Members (Seleccionar Safe → Miembros), encuentre su usuario o grupo y confirme que el permiso está otorgado.
Solución: Pida a un administrador de Safe que actualice su rol para incluir el permiso View recordings (Ver grabaciones).
Pasos de resolución
- Verifique la marca de tiempo Ended at (Finalizado en) de la sesión. Si la sesión finalizó hace menos de 5 minutos, espere y actualice la página antes de investigar más.
- Intente abrir la grabación en un navegador admitido (Chrome o Firefox). Si se reproduce allí, el problema es una restricción de códec en su navegador original.
- Confirme que es miembro del Safe relevante y que su rol incluye View recordings (Ver grabaciones). Si no es así, solicite el permiso a un administrador de Safe.
- Si ninguno de lo anterior se aplica y la reproducción sigue fallando, pida a un operador que verifique que MinIO sea saludable usando
curl -sv http://<minio-host>:9000/minio/health/live. - Después de cualquier corrección, reintente la reproducción actualizando la página Sessions → History (Sesiones → Historial) y haciendo clic en Play (Reproducir) nuevamente.
Ruta de escalada
Si la reproducción sigue fallando después de trabajar con las cuatro causas:
- Anote el ID de sesión (visible en la URL al ver los detalles de la sesión), el mensaje de error exacto y el navegador y versión que está utilizando.
- Si es operador, verifique los logs de la aplicación VaultPAM para errores que contengan
recording,playbackominioen el momento del intento fallido de reproducción. - Abra un ticket de soporte con: ID de sesión, mensaje de error, versión del navegador y el resultado de la verificación de salud de MinIO si pudo ejecutarla.