Questa guida ti aiuta a risolvere un errore 404 in 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 dispone dell'autorizzazione per accedervi.
Albero di debug
Utilizza la seguente struttura decisionale per iniziare a risolvere un errore 404:
Le sezioni seguenti descrivono in modo più dettagliato gli scenari nell'albero.
Risoluzione dei problemi relativi a un errore 404 nel browser
Se l'errore 404 viene visualizzato in una pagina web in un browser, segui i passaggi descritti in questa sezione. In caso contrario, controlla la sezione Errore API.
Controllare la console JavaScript
Innanzitutto, controlla la console JavaScript del browser per ulteriori informazioni sull'errore. Per aprire la console JavaScript su Google Chrome:
- Fai clic sul menu con tre puntini Altro.
- 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 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 il problema. Il supporto di Looker per i problemi relativi alle risorse esterne è limitato.
Se l'URL è un URL di Looker, continua alla sezione successiva.
Controlla che non siano presenti errori ortografici nell'URL.
Controlla che non siano presenti errori ortografici comuni nell'URL. 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, un Look o una dashboard nel codice 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.
Risoluzione dei problemi relativi a un errore 404 nell'API
Se l'errore viene visualizzato come risposta a una chiamata API Looker, segui i passaggi descritti in questa sezione.
Consulta 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
è Crea URL di incorporamento firmato. Controlla i parametri e assicurati di fornire quelli 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 sulla tua istanza utilizzando Explorer API.
Controllare le condizioni dell'endpoint richieste
Alcuni endpoint sono disponibili solo in determinate condizioni:
- Alcuni endpoint del progetto LookML (come
create_project
,deploy_to_production
ereset_project_to_production
) sono disponibili solo in modalità di sviluppo.- Se necessario, utilizza l'endpoint
update_session
con il corpo della richiesta{"workspace_id": "dev"}
per passare alla modalità di sviluppo della sessione API.
- Se necessario, utilizza l'endpoint
- L'endpoint
reset_project_to_production
non è disponibile sui rami condivisi. - L'endpoint
deploy_ref_to_production
è disponibile solo quando è abilitata la modalità di deployment avanzata.
Controllare le impostazioni dei 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 un riferimento specifico, attiva la modalità di deployment avanzata nel progetto.
Se un segreto di deployment del webhook è abilitato nel progetto, assicurati di includerlo nella richiesta.
Controlla se le risorse richieste esistono
Verifica che tutte le risorse a cui viene fatto riferimento nella richiesta esistano effettivamente nella tua istanza 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 esiste una dashboard, 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à sviluppatore. Se l'utente Looker dispone dell'autorizzazione develop
, verifica se 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 alla modalità di sviluppo.
Se l'utente non dispone dell'autorizzazione develop
, prova a eseguire il deployment del progetto LookML in produzione e poi controlla se può accedervi.
Controllare le autorizzazioni dell'utente e le impostazioni di accesso ai contenuti
Se le risorse esistono, ma l'utente continua a ricevere un errore 404, controlla le autorizzazioni e l'accesso ai contenuti dell'utente.
Impersonare l'utente e verificare la presenza dell'errore
Se sei un amministratore, vai al pannello Amministratore > Utenti e impersona (sudo) l'utente che riscontra l'errore 404.
- Se l'utente è un utente incorporato, verifica che le sue credenziali di incorporamento nella pagina Amministratore > Utenti corrispondano a
external_user_id
nell'URL di accesso incorporato. - Se l'utente sta effettuando una chiamata API, utilizza l'endpoint
login_user
per rappresentare l'utente.
Se l'errore 404 viene visualizzato durante la rappresentazione dell'utente, ma non quando visualizzi la risorsa come amministratore, è probabile che l'utente disponga di autorizzazioni o impostazioni di accesso ai contenuti insufficienti.
Controllare le autorizzazioni richieste
Controlla i ruoli dell'utente nel riquadro Amministrazione > 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 ha bisogno 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, controlla se l'autorizzazione richiesta è un'autorizzazione di incorporamento valida. In caso contrario, l'utente incorporato non potrà effettuare la richiesta. Ad esempio, agli utenti incorporati non può essere assegnata l'autorizzazione see_lookml
.
Controlla le concessioni di accesso
Se i contenuti si basano su un'esplorazione con required_access_grants
definito, controlla la definizione di access_grant
nel progetto LookML. Modifica il valore dell'attributo utente dell'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 della cartella. Look, dashboard e report di Looker 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.