Memecahkan masalah aplikasi seluler Looker

Aplikasi seluler Looker memungkinkan Anda mengakses konten Looker dan Data Studio Pro di perangkat Android dan perangkat iOS, melihat Look dan dasbor, serta berkolaborasi di mana saja. Jika Anda mengalami masalah saat menggunakan aplikasi seluler—seperti masalah login, error rendering, aplikasi error, keterlambatan performa, atau perbedaan tampilan—panduan ini akan membantu Anda memecahkan masalah dan menyelesaikannya.

Prasyarat dan persyaratan konfigurasi umum

Sebelum Anda mulai memecahkan masalah, pastikan lingkungan dan akun Anda memenuhi prasyarat untuk menggunakan aplikasi seluler Looker:

  • Akses aplikasi seluler diaktifkan: Administrator Looker harus mengaktifkan akses aplikasi seluler untuk instance Anda.
  • Izin pengguna: Akun pengguna Anda harus memiliki izin Looker mobile_app_access yang ditetapkan secara langsung atau melalui grup pengguna.
  • Instance yang didukung: Aplikasi seluler Looker mendukung instance Looker (Google Cloud core) (IP publik, atau IP pribadi menggunakan akses layanan pribadi atau Private Service Connect yang dapat diakses melalui VPN perusahaan) dan instance Looker (original) (dihosting oleh Looker dan dihosting pelanggan).
  • Daftar yang diizinkan IP dan VPN perusahaan: Jika instance Looker Anda menerapkan daftar yang diizinkan IP, perangkat seluler Anda harus terhubung melalui VPN perusahaan dengan alamat IP statis di daftar yang diizinkan IP instance.
  • Autentikasi yang didukung: Aplikasi seluler Looker mendukung kredensial Google OAuth, SAML, LDAP, OpenID Connect, serta email dan sandi. Login dengan kode QR hanya didukung di aplikasi Looker Mobile (Legacy) dan memerlukan SSO Sematan diaktifkan.

Pohon debug

Gunakan pohon keputusan berikut untuk mulai memecahkan masalah aplikasi seluler Looker:

Bagian berikut menjelaskan skenario dalam hierarki secara lebih mendetail.

Mengidentifikasi aplikasi seluler mana yang diinstal

Karena aplikasi seluler Looker dan aplikasi Looker Mobile (Lama) tersedia di app store, langkah pemecahan masalah pertama adalah menentukan aplikasi mana yang diinstal di perangkat seluler Anda. Langkah penyeleksian awal dukungan mengandalkan perbedaan ini untuk mencegah penyelidikan yang salah arah atau tertunda:

  • Looker: Aplikasi seluler terpadu saat ini untuk konten Looker dan Data Studio Pro. Di layar utama perangkat Anda dan di app store, aplikasi ini bernama Looker. Aplikasi ini mendukung metode autentikasi standar (seperti OAuth Google, SAML, OpenID Connect, LDAP, serta kredensial email dan sandi) dan tidak mendukung login kode QR. Panduan pemecahan masalah ini terutama mencakup aplikasi ini.
  • Looker Mobile (Lama): Aplikasi seluler yang lebih lama. Di layar utama perangkat dan di app store, aplikasi ini bernama Looker Mobile (Lama) (atau Looker Mobile). Aplikasi ini mendukung login dengan kode QR dan email serta password, tetapi tidak mendukung instance Google OAuth, SAML, atau Looker (inti Google Cloud).

Untuk menentukan aplikasi mana yang diinstal di perangkat Anda:

  1. Periksa nama aplikasi yang ditampilkan di bawah ikon aplikasi di layar utama perangkat atau di peluncur aplikasi.
  2. Di aplikasi seluler, pilih Lainnya di menu navigasi bawah atau buka Setelan, lalu temukan nama aplikasi dan nomor versi di bagian bawah menu.
  3. Periksa daftar aplikasi terinstal di Apple App Store (iOS) atau Google Play Store (Android).

Jika Anda telah menginstal Looker Mobile (Lama), dukungan untuk aplikasi ini akan berakhir pada 31 Januari 2027, dan aplikasi tersebut akan dihapus dari daftar. Google sangat merekomendasikan migrasi ke aplikasi seluler Looker saat ini. Untuk dokumentasi dan pemecahan masalah aplikasi lama, lihat panduan Aplikasi Seluler Looker (Lama).

Jika Anda telah menginstal aplikasi seluler Looker, lanjutkan dengan langkah-langkah pemecahan masalah di bagian berikut.

Verifikasi apakah masalah terjadi di luar aplikasi seluler

Langkah pertama dalam memecahkan masalah adalah menentukan apakah masalah tersebut hanya terjadi pada aplikasi seluler atau juga memengaruhi aplikasi web Looker.

Buka browser web desktop atau seluler, login ke instance Looker Anda, dan coba lakukan tindakan yang sama:

  • Dapatkah Anda login melalui browser web? Jika Anda tidak dapat login dari browser web, masalahnya tidak khusus untuk aplikasi seluler. Periksa kredensial, konfigurasi penyedia identitas (IdP), atau status akun pengguna Anda.
  • Apakah kueri atau dasbor dimuat di browser web? Jika dasbor atau Look gagal dimuat, menampilkan error database, atau waktu tunggu habis di browser, masalahnya berasal dari kueri pokok, koneksi database, atau model LookML, bukan aplikasi seluler.
  • Apakah Anda memiliki izin untuk mengakses konten tersebut? Jika Anda tidak dapat melihat konten di antarmuka web, pastikan Anda memiliki izin akses folder, model, dan eksplorasi yang sesuai.

Jika masalah juga muncul di browser web, pecahkan masalah di instance Looker Anda.

Jika masalah hanya terjadi di aplikasi seluler, lanjutkan ke bagian yang relevan dalam panduan ini.

Memecahkan masalah login

Jika Anda tidak dapat login ke aplikasi seluler Looker, selidiki penyebab umum berikut:

  • Format URL instance: Saat memasukkan URL instance di aplikasi seluler, gunakan format instance_name.looker.com atau domain kustom Anda. Jangan sertakan https://, http://, atau garis miring di akhir.
  • Pengaktifan instance: Verifikasi dengan administrator Looker Anda bahwa akses aplikasi seluler diaktifkan di bagian Admin > Umum > Aplikasi Seluler.
  • Izin pengguna: Pastikan dengan administrator Anda bahwa peran atau grup pengguna Anda menyertakan izin mobile_app_access.
  • VPN perusahaan dan daftar yang diizinkan IP: Jika instance Anda menerapkan daftar yang diizinkan IP, pastikan perangkat seluler Anda terhubung ke VPN organisasi Anda dan alamat IP statis server VPN ada di daftar yang diizinkan IP instance. Uji ini dengan membuka URL instance di browser web pada perangkat seluler yang sama saat terhubung ke VPN.
  • Konfigurasi API yang dihosting pelanggan: Jika Anda menggunakan instance Looker (asli) yang dihosting pelanggan, pastikan URL Host API instance Anda di bagian Admin > Platform > API cocok dengan nama host instance Anda. Selain itu, verifikasi bahwa jaringan Anda mengizinkan traffic seluler di port 443 atau port 19999. Untuk mengetahui informasi selengkapnya, lihat halaman dokumentasi pertimbangan untuk instance yang dihosting pelanggan dan pemecahan masalah Looker API.
  • Login biometrik: Jika verifikasi biometrik (pengenalan wajah atau sidik jari) gagal, login menggunakan nama pengguna dan sandi standar Anda. Anda dapat mengonfigurasi ulang verifikasi biometrik di menu Setelan aplikasi pada bagian Keamanan. Perhatikan bahwa biometrik juga harus diaktifkan di setelan sistem perangkat seluler Anda.

Masalah login kode QR

Aplikasi seluler Looker terpadu tidak mendukung login dengan kode QR. Gunakan autentikasi standar (Google OAuth, SAML, LDAP, OpenID Connect, atau email dan sandi).

Jika Anda menggunakan aplikasi Looker Mobile (Legacy) dan tidak dapat login dengan kode QR, selidiki hal berikut:

  • Autentikasi SSO Sematan: Di antarmuka web Looker, buka Admin > Platform > Sematan dan pastikan Autentikasi SSO Sematan diaktifkan. Setelan ini mengaktifkan opsi login kode QR.
  • Muat ulang kode QR: Kode QR sensitif terhadap waktu. Muat ulang halaman web yang menampilkan kode QR, lalu coba pindai kode QR yang baru dibuat.
  • Izin kamera dan visibilitas: Pastikan aplikasi seluler memiliki izin untuk mengakses kamera perangkat Anda, dan pastikan pencahayaan memadai saat memindai layar.
  • Login alternatif: Jika autentikasi kode QR terus gagal, gunakan kredensial email dan sandi untuk login, atau bermigrasi ke aplikasi seluler Looker yang telah diupdate.

Memecahkan masalah rendering konten

Jika dasbor atau Look gagal dirender, menampilkan kartu kosong, atau menampilkan pesan error di aplikasi seluler, selidiki hal berikut:

  • Cakupan masalah: Tentukan apakah kegagalan rendering memengaruhi semua konten atau hanya Tampilan atau dasbor tertentu:
    • Semua konten gagal: Periksa koneksi jaringan perangkat seluler Anda, pastikan sesi Anda belum berakhir, dan coba keluar lalu masuk kembali ke aplikasi.
    • Kegagalan konten tertentu: Periksa apakah konten menggunakan visualisasi kustom atau format tata letak yang tidak didukung. Selain itu, pastikan Anda memiliki akses ke model dan eksplorasi pokok.
  • Periksa pesan error: Jika banner error atau error kartu muncul, catat pesan spesifiknya. Masalah umum mencakup error koneksi database, waktu tunggu kueri habis, atau referensi kolom tidak ada.
  • Kegagalan terputus-putus versus konsisten: Jika konten gagal terputus-putus, masalahnya mungkin terkait dengan beban database atau fluktuasi jaringan sementara.
  • Tarik untuk memuat ulang: Gunakan gestur tarik untuk memuat ulang (tarik ke bawah di layar) untuk memuat ulang dasbor atau Look dan menjalankan kueri baru.

Memecahkan masalah error aplikasi

Jika aplikasi seluler Looker mengalami error atau tertutup secara tiba-tiba, ikuti langkah-langkah pemecahan masalah berikut:

  • Identifikasi pemicu error: Catat kapan error terjadi. Apakah aplikasi langsung error saat diluncurkan, saat membuka dasbor tertentu, saat memutar perangkat antara mode potret dan lanskap, atau setelah interaksi pengguna tertentu?
  • Update aplikasi: Periksa Apple App Store atau Google Play Store untuk memastikan Anda menjalankan aplikasi seluler Looker versi terbaru. Update sering kali mencakup peningkatan stabilitas dan perbaikan bug.
  • Update sistem operasi perangkat: Pastikan perangkat seluler Anda menjalankan iOS atau Android versi yang didukung. Sistem operasi yang sudah tidak berlaku dapat menyebabkan masalah kompatibilitas.
  • Hapus cache dan mulai ulang:
    • Tutup paksa aplikasi, lalu buka kembali.
    • Mulai ulang perangkat seluler Anda.
    • Di Android, hapus cache aplikasi di bagian Setelan > Aplikasi > Looker > Penyimpanan > Hapus Cache.
  • Instal ulang aplikasi: Uninstal aplikasi, mulai ulang perangkat, dan instal ulang aplikasi dari app store resmi.

Memecahkan masalah performa dan latensi

Jika aplikasi seluler Looker lambat, tidak responsif, atau membutuhkan waktu yang lama untuk memuat konten, selidiki hal-hal berikut:

  • Identifikasi komponen yang lambat: Tentukan apakah penundaan terjadi saat meluncurkan aplikasi, membuka folder dan papan, memuat daftar konten yang di-cache, atau menjalankan kueri untuk kartu dasbor.
  • Penyimpanan cache daftar: Aplikasi seluler menyimpan cache daftar konten yang baru saja dilihat dan konten favorit untuk mempercepat navigasi. Daftar diperbarui secara otomatis saat aplikasi diluncurkan, tetapi Anda dapat menarik ke bawah untuk memperbarui secara manual jika daftar tampak sudah tidak berlaku.
  • Kompleksitas dasbor dan jumlah kartu: Dasbor dengan banyak kartu atau jenis visualisasi yang kompleks memerlukan sumber daya pemrosesan dan memori yang besar di perangkat seluler. Uji apakah dasbor yang lebih kecil atau tampilan individual dimuat lebih cepat.
  • Kecepatan dan latensi jaringan: Jaringan seluler mungkin mengalami latensi tinggi atau kehilangan paket. Uji apakah performa meningkat saat terhubung ke jaringan Wi-Fi berkecepatan tinggi yang andal.
  • Performa kueri database: Jika setiap kartu memerlukan waktu lama untuk dirender, periksa durasi kueri di antarmuka web Looker atau Aktivitas Sistem. Penundaan mungkin disebabkan oleh kueri database yang berjalan lama.

Memecahkan masalah tampilan dan gaya

Jika Anda menemukan kerusakan visual—seperti elemen yang tidak sejajar, ikon yang rusak, gambar yang terdistorsi, atau padding yang tidak terduga—selidiki hal berikut:

  • Orientasi layar: Uji dasbor atau Look dalam orientasi potret dan lanskap. Beberapa dasbor dan tabel yang kompleks dioptimalkan untuk tampilan lanskap yang lebih lebar.
  • Tata letak dasbor: Dasbor yang mobile-friendly secara dinamis menyesuaikan posisi kartu untuk layar kecil. Jika kartu saling tumpang-tindih atau memotong teks, verifikasi ukuran dan konfigurasi kartu di mode edit dasbor pada aplikasi web.
  • Setelan tampilan perangkat: Setelan aksesibilitas seperti ukuran font sistem kustom, zoom tampilan, atau alat inversi mode gelap pihak ketiga dapat mengubah cara konten dirender. Uji dengan setelan tampilan sistem default.
  • Dokumentasi visual: Ambil screenshot atau rekaman layar yang dengan jelas menunjukkan perbedaan rendering untuk dibagikan kepada administrator atau Dukungan Anda.

Mengumpulkan informasi diagnostik

Jika Anda tidak dapat menyelesaikan masalah setelah mengikuti langkah-langkah pemecahan masalah, kumpulkan informasi berikut sebelum menghubungi Dukungan:

  1. Informasi instance Looker:
    • URL Instance (misalnya, instance_name.looker.com).
    • Versi rilis Looker (di aplikasi web, pilih Bantuan > Tentang).
    • Jenis hosting instance (dihosting oleh Looker atau dihosting pelanggan; Looker (Google Cloud core) atau Looker (asli)).
  2. Informasi aplikasi seluler:
    • Aplikasi mana yang diinstal: Tentukan apakah Anda telah menginstal aplikasi seluler Looker atau Looker Mobile (Lama).
    • Nomor versi aplikasi (dapat ditemukan di bagian bawah menu Lainnya dalam aplikasi atau di Setelan).
    • App Store tempat aplikasi diinstal (Apple App Store atau Google Play Store).
  3. Detail perangkat dan sistem operasi:
    • Produsen dan model perangkat (misalnya, Google Pixel 8, iPhone 15 Pro).
    • Versi sistem operasi (misalnya, Android 14, iOS 17.5).
  4. Cakupan dan dampak:
    • Apakah masalah ini memengaruhi semua pengguna atau hanya akun pengguna tertentu?
    • Apakah masalah terjadi di semua perangkat seluler atau hanya di model perangkat atau versi sistem operasi tertentu?
  5. Contoh visual dan log:
    • Screenshot atau rekaman layar yang menunjukkan perilaku yang tidak terduga atau pesan error.
    • Langkah-langkah persis untuk mereproduksi masalah.

Hubungi Dukungan

Jika Anda telah memverifikasi semua langkah sebelumnya dan masalah masih belum terselesaikan: