Vai al contenuto principale

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 error o Failed 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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:

  1. 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.
  2. Se sei un operatore, controlla i log dell'applicazione VaultPAM per gli errori contenenti recording, playback o minio al momento del tentativo di riproduzione non riuscito.
  3. 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.

Articoli correlati