Memecahkan masalah error 404

Panduan ini membantu Anda memecahkan masalah error 404 di halaman web Looker atau dalam permintaan Looker API. Error 404 biasanya berarti bahwa resource yang diminta tidak ada, atau pengguna tidak memiliki izin untuk mengaksesnya.

Pohon debug

Gunakan pohon keputusan berikut untuk mulai memecahkan masalah error 404:

Bagian berikut menjelaskan skenario dalam hierarki secara lebih mendetail.

Memecahkan masalah error 404 di browser

Jika error 404 muncul di halaman web di browser, ikuti langkah-langkah di bagian ini. Jika tidak, periksa bagian Error API.

Periksa konsol JavaScript

Pertama, periksa konsol JavaScript di browser Anda untuk mengetahui informasi selengkapnya tentang error tersebut. Untuk membuka konsol JavaScript di Google Chrome, ikuti langkah-langkah berikut:

  1. Klik menu tiga titik Lainnya.
  2. Pilih Alat Lainnya.
  3. Klik Alat Developer.
  4. Klik tab Console.

Cari error 404 dalam daftar error dan temukan URL yang sesuai.

Jika URL yang menampilkan 404 bukan URL Looker, error berasal dari resource eksternal. Jika URL permintaan adalah milik aplikasi kustom yang terhubung ke Looker, periksa kode dan log aplikasi Anda untuk memecahkan masalah error. Dukungan Looker untuk masalah resource eksternal terbatas.

Jika URL adalah URL Looker, lanjutkan ke bagian berikutnya.

Periksa apakah ada kesalahan ketik pada URL

Periksa URL untuk menemukan kesalahan ketik umum. Contoh:

  • Kesalahan ketik umum untuk halaman Look adalah /look/123. Sintaksis yang benar adalah /looks/123.
  • Kesalahan ketik umum untuk halaman dasbor adalah /dashboard/123. Sintaksis yang benar adalah /dashboards/123.

Saat menyertakan link ke Eksplorasi, Look, atau dasbor di LookML, selalu uji link terlebih dahulu untuk memastikan sintaksnya benar.

Jika Anda menemukan salah ketik dalam link yang dibuat dari LookML, perbaiki salah ketik tersebut di LookML. Jika Anda menemukan salah ketik dalam URL yang dibuat oleh Looker (misalnya, dalam elemen navigasi UI), hubungi Dukungan untuk meminta agar URL tersebut dikoreksi dalam produk.

Memecahkan masalah error 404 di API

Jika error muncul sebagai respons terhadap panggilan Looker API, ikuti langkah-langkah di bagian ini.

Tinjau dokumentasi endpoint API

Cari dokumentasi untuk endpoint API yang menampilkan error 404. Misalnya, halaman dokumentasi untuk endpoint create_sso_embed_url adalah Create Signed Embed URL. Periksa parameter dan pastikan Anda memberikan parameter yang benar ke panggilan API.

Pastikan kata kerja dan jalur permintaan sudah benar. Misalnya, endpoint /api/4.0/embed/sso_url harus digunakan dengan kata kerja POST.

Anda juga dapat menguji endpoint API secara langsung di instance menggunakan API Explorer.

Memeriksa kondisi endpoint yang diperlukan

Beberapa endpoint hanya tersedia dalam kondisi tertentu:

  • Beberapa endpoint project LookML (seperti create_project, deploy_to_production, dan reset_project_to_production) hanya tersedia dalam mode pengembangan.
    • Jika perlu, gunakan endpoint update_session dengan isi permintaan {"workspace_id": "dev"} untuk mengalihkan sesi API Anda ke mode pengembangan.
  • Endpoint reset_project_to_production tidak tersedia di cabang bersama.
  • Endpoint deploy_ref_to_production hanya tersedia jika Mode Deployment Lanjutan diaktifkan.

Periksa setelan webhook

Jika URL permintaan adalah webhook deployment, periksa setelan webhook Anda.

Jika Anda menggunakan webhook untuk men-deploy cabang atau referensi tertentu, aktifkan Advanced Deploy Mode di project.

Jika secret deployment webhook diaktifkan di project, pastikan Anda menyertakan secret dalam permintaan.

Memeriksa apakah resource yang diminta ada

Pastikan semua resource yang dirujuk dalam permintaan benar-benar ada di instance Looker Anda.

Pastikan semua nilai di URL dan isi permintaan (seperti ID folder atau ID dasbor) merujuk ke resource yang valid dan ada. Misalnya, untuk memeriksa apakah dasbor ada, buka /dashboards/[id] sebagai pengguna Admin. Jika resource tidak ada atau tidak valid, buat resource yang tidak ada atau tentukan resource yang ada.

Jika resource ada, tetapi Anda masih menerima error 404, periksa apakah resource ada dalam mode dev. Jika pengguna Looker memiliki izin develop, lihat apakah pengguna dapat mengakses resource saat mereka memasuki mode pengembangan. Untuk panggilan API, gunakan endpoint update_session dengan isi permintaan {"workspace_id": "dev"} untuk mengalihkan sesi API Anda ke mode pengembangan.

Jika pengguna tidak memiliki izin develop, coba deploy project LookML ke produksi, lalu periksa apakah pengguna dapat mengaksesnya.

Memeriksa izin pengguna dan setelan akses konten

Jika resource ada, tetapi pengguna masih menerima error 404, periksa izin pengguna dan akses konten.

Meniru identitas pengguna dan memeriksa error

Jika Anda adalah admin, buka panel Admin > Pengguna dan tiru (sudo) pengguna yang mengalami error 404.

  • Jika pengguna adalah pengguna sematan, verifikasi bahwa kredensial sematan mereka di halaman Admin > Pengguna cocok dengan external_user_id di URL login sematan.
  • Jika pengguna melakukan panggilan API, gunakan endpoint login_user untuk meniru identitas pengguna.

Jika error 404 muncul saat Anda meniru identitas pengguna, tetapi tidak saat Anda melihat resource sebagai admin, kemungkinan pengguna tidak memiliki izin yang cukup atau setelan akses konten.

Memeriksa izin yang diperlukan

Periksa peran pengguna di panel Admin > Pengguna dan daftar izin di Looker untuk memastikan bahwa pengguna memiliki izin yang diperlukan di setidaknya salah satu perannya. Misalnya, untuk melihat dasbor, pengguna memerlukan setidaknya izin access data, see_looks, dan see_user_dashboards. Jika pengguna tidak memiliki izin yang diperlukan, tambahkan izin tersebut ke set izin dalam peran yang ditetapkan kepada pengguna tersebut.

Jika ada izin yang diperlukan khusus untuk model, pastikan model LookML disertakan dalam set model untuk setidaknya salah satu peran pengguna dengan izin yang diperlukan. Jika tidak, tambahkan model ke set model salah satu peran yang ditetapkan kepada pengguna.

Memeriksa izin sematan yang valid

Jika pengguna adalah pengguna sematan yang ditandatangani, periksa apakah izin yang diperlukan adalah izin sematan yang valid. Jika tidak, pengguna yang menyematkan tidak akan dapat membuat permintaan dengan berhasil. Misalnya, pengguna yang menyematkan tidak dapat diberi izin see_lookml.

Memeriksa pemberian akses

Jika konten didasarkan pada Eksplorasi dengan required_access_grants yang ditentukan, periksa definisi access_grant dalam project LookML. Edit nilai atribut pengguna pengguna untuk atribut pengguna yang ditentukan ke salah satu nilai yang diperlukan dalam pemberian akses.

Memeriksa akses konten

Jika resource yang diminta disimpan dalam folder, periksa setelan akses konten di folder tersebut. Tampilan, dasbor, dan laporan Looker Studio semuanya disimpan dalam folder.

Peninjauan akhir dan dukungan

Jika error 404 masih terjadi, tinjau langkah-langkah pemecahan masalah di halaman ini. Jika Anda masih tidak dapat menyelesaikan error 404, hubungi Dukungan.