Questa guida ti aiuta a risolvere un errore 404 su una pagina web di Looker o in una richiesta dell'API Looker. Un errore 404 in genere significa che la risorsa richiesta non esiste o che l'utente non ha l'autorizzazione per accedervi.
Struttura di debug
Utilizza la seguente struttura decisionale per iniziare a risolvere un errore 404:
Le sezioni seguenti descrivono gli scenari nella struttura in modo più dettagliato.
Risolvere un errore 404 nel browser
Se l'errore 404 viene visualizzato su una pagina web in un browser, segui i passaggi descritti in questa sezione. In caso contrario, consulta la sezione relativa agli errori dell'API.
Controllare la console JavaScript
Innanzitutto, controlla la console JavaScript del browser per ulteriori informazioni sull'errore. Per aprire la console JavaScript in Google Chrome:
- Fai clic sul menu Altro (tre puntini).
- Seleziona Altri strumenti.
- Fai clic su Strumenti per sviluppatori.
- Fai clic sulla scheda Console.
Cerca l'errore 404 nell'elenco degli errori e trova l'URL corrispondente.
Se l'URL che restituisce un errore 404 non è un URL di Looker, l'errore ha origine da una risorsa esterna. Se l'URL della richiesta appartiene a un'applicazione personalizzata che si connette a Looker, esamina il codice e i log dell'applicazione per risolvere l'errore. L'assistenza di Looker per i problemi relativi alle risorse esterne è limitata.
Se l'URL è un URL di Looker, vai alla sezione successiva.
Controllare l'URL per verificare la presenza di errori di battitura
Controlla l'URL per verificare la presenza di errori di battitura comuni. Ad esempio:
- Un errore di battitura comune per una pagina Look è
/look/123. La sintassi corretta è/looks/123. - Un errore di battitura comune per una pagina della dashboard è
/dashboard/123. La sintassi corretta è/dashboards/123.
Quando includi un link a un'esplorazione, a un Look o a una dashboard in LookML, testa sempre il link per assicurarti che la sintassi sia corretta.
Se trovi un errore di battitura in un link generato da LookML, correggilo in LookML. Se trovi un errore di battitura in un URL generato da Looker (ad esempio, in un elemento di navigazione dell'interfaccia utente), contatta l'assistenza per richiedere la correzione dell'URL nel prodotto.
Risolvere un errore 404 nell'API
Se l'errore viene visualizzato come risposta a una chiamata dell'API Looker, segui i passaggi descritti in questa sezione.
Esaminare la documentazione dell'endpoint API
Cerca la documentazione dell'endpoint API che restituisce l'errore 404. Ad esempio, la pagina della documentazione per l'endpoint create_sso_embed_url è Creare un URL di incorporamento firmato. Controlla i parametri e assicurati di fornire i parametri corretti alla chiamata API.
Assicurati che il verbo e il percorso della richiesta siano corretti. Ad esempio, l'endpoint /api/4.0/embed/sso_url deve essere utilizzato con il verbo POST.
Puoi anche testare l'endpoint API direttamente nella tua istanza utilizzando Explorer API.
Verificare la presenza delle condizioni dell'endpoint richieste
Alcuni endpoint sono disponibili solo in determinate condizioni:
- Alcuni endpoint del progetto LookML (come
create_project,deploy_to_productionereset_project_to_production) sono disponibili solo in modalità di sviluppo.- Se necessario, utilizza l'endpoint
update_sessioncon il corpo della richiesta{"workspace_id": "dev"}per passare la sessione API alla modalità di sviluppo.
- Se necessario, utilizza l'endpoint
- L'endpoint
reset_project_to_productionnon è disponibile sui rami condivisi. - L'endpoint
deploy_ref_to_productionè disponibile solo quando è abilitata la modalità di deployment avanzata.
Controllare le impostazioni del webhook
Se l'URL della richiesta è un webhook di deployment, controlla le impostazioni del webhook.
Se utilizzi il webhook per eseguire il deployment di un ramo o di un riferimento specifico, abilita la modalità di deployment avanzata nel progetto.
Se nel progetto è abilitato un secret di deployment del webhook, assicurati di includerlo nella richiesta.
Verificare se le risorse richieste esistono
Verifica che tutte le risorse a cui viene fatto riferimento nella richiesta esistano effettivamente nella tua istanza di Looker.
Verifica che tutti i valori nell'URL e nel corpo della richiesta (ad esempio ID cartella o ID dashboard) facciano riferimento a risorse valide ed esistenti. Ad esempio, per verificare se una dashboard esiste, vai a /dashboards/[id] come utente amministratore. Se una risorsa è mancante o non valida, crea la risorsa mancante o specificane una esistente.
Se la risorsa esiste, ma continui a ricevere un errore 404, controlla se la risorsa esiste in modalità di sviluppo. Se l'utente di Looker ha l'autorizzazione develop, verifica se l'utente può accedere alla risorsa quando entra in modalità di sviluppo. Per le chiamate API, utilizza l'endpoint update_session con il corpo della richiesta {"workspace_id": "dev"} per passare la sessione API alla modalità di sviluppo.
Se l'utente non ha l'autorizzazione develop, prova a eseguire il deployment del progetto LookML in produzione e poi verifica se può accedervi.
Controllare le autorizzazioni utente e le impostazioni di accesso ai contenuti
Se le risorse esistono, ma l'utente continua a ricevere un errore 404, controlla le autorizzazioni dell'utente e l'accesso ai contenuti.
Impersonare l'utente e verificare la presenza dell'errore
Se sei un amministratore, vai al riquadro Amministratore > Utenti e impersona (sudo) l'utente che riscontra l'errore 404.
- Se l'utente è un utente di incorporamento, verifica che le sue credenziali di incorporamento nella pagina Amministratore > Utenti corrispondano a
external_user_idnell'URL di accesso incorporato. - Se l'utente sta effettuando una chiamata API, utilizza l'endpoint
login_userper impersonare l'utente.
Se l'errore 404 viene visualizzato mentre impersoni l'utente, ma non quando visualizzi la risorsa come amministratore, è probabile che l'utente non disponga di autorizzazioni o impostazioni di accesso ai contenuti sufficienti.
Verificare la presenza delle autorizzazioni richieste
Controlla i ruoli dell'utente nel riquadro Amministratore > Utenti e l'elenco delle autorizzazioni in Looker per assicurarti che l'utente disponga delle autorizzazioni necessarie in almeno uno dei suoi ruoli. Ad esempio, per visualizzare una dashboard, un utente deve disporre almeno delle autorizzazioni access data, see_looks e see_user_dashboards. Se l'utente non dispone delle autorizzazioni richieste, aggiungile a un set di autorizzazioni in un ruolo assegnato all'utente.
Se le autorizzazioni richieste sono specifiche del modello, verifica che il modello LookML sia incluso nel set di modelli per almeno uno dei ruoli dell'utente con l'autorizzazione richiesta. In caso contrario, aggiungi il modello al set di modelli di uno dei ruoli assegnati all'utente.
Verificare la presenza di autorizzazioni di incorporamento valide
Se l'utente è un utente di incorporamento firmato, verifica se l'autorizzazione richiesta è un'autorizzazione di incorporamento valida. In caso contrario, l'utente di incorporamento non potrà effettuare la richiesta. Ad esempio, agli utenti di incorporamento non può essere assegnata l'autorizzazione see_lookml.
Verificare la presenza di concessioni di accesso
Se i contenuti si basano su un'esplorazione con required_access_grants definito, controlla la access_grant definizione nel progetto LookML. Modifica il valore dell'attributo utente dell'utente per l'attributo utente specificato in uno dei valori richiesti nella concessione di accesso.
Controllare l'accesso ai contenuti
Se la risorsa richiesta è archiviata in una cartella, controlla le impostazioni di accesso ai contenuti in quella cartella. Look, dashboard e report di Data Studio sono tutti archiviati in cartelle.
Revisione finale e assistenza
Se l'errore 404 persiste, esamina i passaggi per la risoluzione dei problemi descritti in questa pagina. Se non riesci ancora a risolvere l'errore 404, contatta l'assistenza.