La riproduzione della registrazione non riesce
VaultPAM registra ogni sessione trasmessa e archivia la registrazione nell'archivio di oggetti (MinIO). La riproduzione viene resa nel browser utilizzando un lettore integrato. Quando la riproduzione non riesce, la causa è solitamente una di quattro cose: la registrazione è ancora in elaborazione, il backend di archiviazione è temporaneamente irraggiungibile, il browser non supporta il codec richiesto, oppure il visualizzatore non dispone dell'autorizzazione per guardare la registrazione.
Sintomi
- Fare clic su Play su una sessione in Sessions → History mostra uno spinner che non si risolve mai.
- Viene visualizzato un banner di errore:
Recording unavailable,Playback erroroFailed to load recording. - Il lettore si carica ma mostra un fotogramma vuoto o congelato senza controlli.
- La riproduzione inizia ma si interrompe a metà strada con un errore di codec o decodifica.
- Visualizzi la voce della sessione nell'elenco ma il pulsante Play è disabilitato.
Cause
1. Registrazione ancora in elaborazione
Le sessioni molto recenti (terminate negli ultimi 2–5 minuti) potrebbero non essere ancora completamente acquisite e indicizzate. La pipeline di registrazione finalizza il file di registrazione, verifica l'integrità e lo registra nel catalogo prima che la riproduzione sia disponibile. Durante questa finestra, il pulsante Play è disabilitato o il lettore restituisce "Recording unavailable".
Verifica: Controlla il timestamp Ended at della sessione. Se è passato meno di 5 minuti fa, la registrazione è probabilmente ancora in elaborazione.
Soluzione: Attendi 5 minuti e aggiorna la pagina. Il pulsante Play diventerà attivo al completamento dell'elaborazione. Se la sessione è terminata più di 15 minuti fa e la riproduzione è ancora non disponibile, procedi alla causa successiva.
2. Archivio MinIO irraggiungibile
Le registrazioni sono archiviate in MinIO (o in un backend compatibile con S3). Se il servizio di archiviazione è irraggiungibile — a causa di una partizione di rete, riavvio del servizio o configurazione errata — l'endpoint di riproduzione non può recuperare il file di registrazione e restituisce un errore.
Verifica per gli operatori: Sull'host VaultPAM o nel cluster, conferma che MinIO è in esecuzione e raggiungibile:
curl -sv http://<minio-host>:9000/minio/health/live
Una risposta 200 OK conferma che MinIO è integro. Conferma inoltre che il bucket di registrazione esiste e che l'account di servizio VaultPAM ha accesso in lettura.
Soluzione per gli operatori: Ripristina la connettività di MinIO o riavvia il servizio MinIO. Dopo il ripristino, riprova la riproduzione — le registrazioni vengono recuperate su richiesta e non devono essere ri-acquisite.
3. Codec del browser non supportato
Il lettore VaultPAM utilizza la codifica video WebM/VP8 o VP9. Alcuni browser più vecchi o build di browser induriti a livello aziendale hanno restrizioni dei codec che impediscono la riproduzione.
Verifica: Prova la riproduzione in un browser diverso (Chrome o Firefox sono consigliati). Se la riproduzione riesce in un altro browser, il browser originale ha una restrizione dei codec.
Browser supportati per la riproduzione della registrazione:
- Chrome 90+
- Firefox 90+
- Edge 90+ (basato su Chromium)
Safari ha un supporto limitato di VP9 su versioni macOS precedenti.
Soluzione: Utilizza un browser supportato. Se un browser specifico è richiesto dalla policy, chiedi al tuo amministratore di VaultPAM se il formato di registrazione può essere modificato (questa è una configurazione lato server).
4. Autorizzazioni insufficienti
La riproduzione è controllata dall'appartenenza al Safe e dalle autorizzazioni del ruolo. Un utente deve disporre dell'autorizzazione View recordings per il Safe a cui appartiene la sessione. Gli amministratori e i proprietari del Safe dispongono di questa autorizzazione per impostazione predefinita; i membri normali potrebbero non averla.
Verifica: Conferma di essere un membro del Safe a cui appartiene la sessione e che il tuo ruolo includa View recordings. In Safes → scegli Safe → Members, trova il tuo utente o gruppo e conferma che l'autorizzazione è concessa.
Soluzione: Chiedi a un amministratore del Safe di aggiornare il tuo ruolo per includere l'autorizzazione View recordings.
Passaggi di risoluzione
- Controlla il timestamp Ended at della sessione. Se la sessione è terminata meno di 5 minuti fa, attendi e aggiorna la pagina prima di indagare ulteriormente.
- Prova ad aprire la registrazione in un browser supportato (Chrome o Firefox). Se riprodotta lì, il problema è una restrizione del codec nel tuo browser originale.
- Conferma di essere un membro del Safe rilevante e che il tuo ruolo includa View recordings. Se no, richiedi l'autorizzazione a un amministratore del Safe.
- Se nessuno dei precedenti si applica e la riproduzione continua a non funzionare, chiedi a un operatore di verificare che MinIO sia integro utilizzando
curl -sv http://<minio-host>:9000/minio/health/live. - Dopo qualsiasi correzione, riprova la riproduzione aggiornando la pagina Sessions → History e facendo clic su Play di nuovo.
Percorso di escalation
Se la riproduzione continua a non funzionare dopo aver analizzato tutte e quattro le cause:
- Annota l'ID della sessione (visibile nell'URL quando visualizzi i dettagli della sessione), il messaggio di errore esatto e il browser e la versione che stai utilizzando.
- Se sei un operatore, controlla i log dell'applicazione VaultPAM per gli errori contenenti
recording,playbackominioal momento del tentativo di riproduzione non riuscito. - Apri un ticket di supporto con: ID della sessione, messaggio di errore, versione del browser e il risultato del controllo di integrità di MinIO se sei stato in grado di eseguirlo.