Risoluzione dei problemi del renderer Chromium

Questa pagina descrive come risolvere l'errore RendererNoRenderFinishedEventReceivedError in Looker. Questo messaggio di errore indica in genere un problema con il renderer Chromium che genera visualizzazioni PNG e PDF per download e pianificazioni.

Risoluzione dei problemi di compatibilità del renderer Chromium

Utilizza la seguente struttura decisionale per risolvere i problemi di compatibilità del renderer. Apri l'albero decisionale in una nuova scheda per ingrandirlo.

Passaggi per la risoluzione dei problemi

Le sezioni seguenti descrivono in modo più dettagliato gli scenari nell'albero.

Passaggio 1: verifica la versione di Chromium

La causa principale di RendererNoRenderFinishedEventReceivedError potrebbe essere una mancata corrispondenza tra l'istanza di Looker e la versione di Chromium o Google Chrome installata sul server host del cliente.

Per individuare la versione esatta di Chromium e il relativo percorso di installazione, utilizza i seguenti comandi:

chromium --version
which chromium

Confronta la versione dell'output con l'elenco delle versioni compatibili con Looker. Consulta la pagina Installazione del software di rendering ospitato dal cliente per visualizzare l'elenco delle versioni supportate.

Se la versione non è compatibile, vai al passaggio 2B: esegui il rollback strategico. In caso contrario, vai al Passaggio 2A: rivedi l'installazione e la configurazione.

Passaggio 2A: rivedi l'installazione e la configurazione

Se utilizzi un'istanza di Looker ospitata dal cliente, consulta la documentazione sull'installazione del software di rendering per assicurarti che la configurazione sia corretta.

Se è tutto corretto, vai al Passaggio 3A: analizza i log.

Passaggio 3A: analizza i log

Esamina i log di Looker per verificare la presenza di errori relativi allo stato di Chromium, alla sua connessione a DevTools o a tentativi di comunicazione non riusciti. Cerca pattern ricorrenti o messaggi di errore specifici che possano fornire indizi sul problema sottostante.

Se non riesci a trovare problemi nei log, vai a Revisione finale e assistenza.

Passaggio 2B: esegui il rollback strategico

Se la versione di Chromium non è compatibile, un rollback strategico a una versione compatibile nota (ad esempio Chromium 97, 109 o 114) è spesso la soluzione più efficace. Contatta l'assistenza Looker se hai bisogno di aiuto per eseguire il rollback della versione di Chromium.

Durante il processo di rollback, potresti riscontrare i seguenti problemi.

Passaggio 3B: errori 404 e pacchetti mancanti

La presenza di errori 404 o di pacchetti mancanti può interrompere la procedura di rollback. Assicurati che i repository dei pacchetti necessari siano configurati correttamente e siano accessibili. Se necessario, scarica e installa manualmente i pacchetti mancanti.

Passaggio 3C: problemi di autorizzazione

Autorizzazioni insufficienti possono ostacolare la creazione o la modifica delle directory necessarie per il rollback. Concedi le autorizzazioni utente appropriate per eseguire il processo di rollback. Utilizza sudo o comandi equivalenti per elevare temporaneamente i privilegi, se necessario.

Passaggio 3D: errori di blocco del frontend dpkg

Nei sistemi basati su Debian, il blocco del frontend dpkg può impedire operazioni simultanee sui pacchetti. Attendi il completamento di tutte le operazioni sui pacchetti in corso. Se sembra esserci un blocco del frontend che non scompare con il tempo, esegui il backup dell'istanza e utilizza il comando per forzare lo sblocco del frontend:

sudo rm /var/lib/dpkg/lock

Passaggio 3E: disattiva gli aggiornamenti automatici di Chromium

Negli ambienti ospitati dai clienti, gli aggiornamenti automatici di Chromium possono introdurre inavvertitamente problemi di compatibilità. Implementa misure per impedire l'aggiornamento automatico di Chromium. Stabilisci una routine per monitorare in modo proattivo la versione di Chromium ed esegui gli aggiornamenti manuali solo quando è garantita la compatibilità con Looker.

Revisione finale e assistenza

Se questi passaggi di risoluzione dei problemi non risolvono l'errore, contatta l'assistenza per ulteriore assistenza.

Risorse aggiuntive