Fehlerbehebung bei der mobilen Looker-Anwendung

Mit der Looker App können Sie auf Android- und iOS-Geräten auf Ihre Looker- und Data Studio Pro-Inhalte zugreifen, Looks und Dashboards ansehen und unterwegs zusammenarbeiten. Wenn bei der Verwendung der App Probleme auftreten, z. B. Anmeldeprobleme, Rendering-Fehler, App-Abstürze, Leistungsverzögerungen oder Anzeigefehler, hilft Ihnen dieser Leitfaden bei der Fehlerbehebung.

Voraussetzungen und allgemeine Konfigurationsanforderungen

Bevor Sie mit der Fehlerbehebung beginnen, prüfen Sie, ob Ihre Umgebung und Ihr Konto die Voraussetzungen für die Verwendung der mobilen Looker-App erfüllen:

  • Zugriff auf mobile Anwendungen aktiviert:Ein Looker-Administrator muss den Zugriff auf mobile Anwendungen für Ihre Instanz aktivieren.
  • Nutzerberechtigungen:Ihrem Nutzerkonto muss die Looker-Berechtigung mobile_app_access direkt oder über eine Nutzergruppe zugewiesen sein.
  • Unterstützte Instanzen:Die mobile Looker-App unterstützt Looker (Google Cloud Core)-Instanzen (öffentliche IP-Adresse oder private IP-Adresse über den Zugriff auf private Dienste oder Private Service Connect, das über ein Unternehmens-VPN zugänglich ist) und Looker-Instanzen (Original) (von Looker gehostet und vom Kunden gehostet).
  • Unternehmens-VPN und IP-Zulassungslisten:Wenn für Ihre Looker-Instanz IP-Zulassungslisten erzwungen werden, muss Ihr Mobilgerät über ein Unternehmens-VPN mit einer statischen IP-Adresse in der IP-Zulassungsliste der Instanz verbunden sein.
  • Unterstützte Authentifizierung:Die mobile Looker-App unterstützt Google OAuth, SAML, LDAP, OpenID Connect sowie Anmeldedaten für E-Mail-Adresse und Passwort. Die Anmeldung mit QR-Codes wird nur in der Looker Mobile (Legacy)-App unterstützt und erfordert, dass Embed SSO aktiviert ist.

Debugging-Baum

Verwenden Sie den folgenden Entscheidungsbaum, um mit der Fehlerbehebung bei Problemen mit der mobilen Looker-App zu beginnen:

In den folgenden Abschnitten werden die Szenarien im Baum genauer beschrieben.

Ermitteln, welche mobile Anwendung installiert ist

Da sowohl die Looker App als auch die Looker Mobile (Legacy) App in App-Stores verfügbar sind, müssen Sie als Erstes herausfinden, welche App auf Ihrem Mobilgerät installiert ist. Der erste Triage-Schritt des Supports basiert auf dieser Unterscheidung, um fehlgeleitete oder verzögerte Untersuchungen zu verhindern:

  • Looker:Die aktuelle einheitliche mobile Anwendung für Looker- und Data Studio Pro-Inhalte. Auf dem Startbildschirm Ihres Geräts und in App-Shops wird diese App als Looker bezeichnet. Es werden Standardauthentifizierungsmethoden wie Google OAuth, SAML, OpenID Connect, LDAP sowie Anmeldedaten für E-Mail-Adresse und Passwort unterstützt. Die Anmeldung per QR-Code wird nicht unterstützt. Dieser Leitfaden zur Fehlerbehebung bezieht sich hauptsächlich auf diese Anwendung.
  • Looker Mobile (Legacy): Die ältere mobile Anwendung. Auf dem Startbildschirm Ihres Geräts und in App-Stores wird diese App als Looker Mobile (Legacy) oder Looker Mobile angezeigt. Es unterstützt die Anmeldung per QR-Code sowie per E‑Mail-Adresse und Passwort, aber nicht Google OAuth, SAML oder Looker-Instanzen (Google Cloud Core).

So finden Sie heraus, welche Anwendung auf Ihrem Gerät installiert ist:

  1. Sehen Sie sich den Anwendungsnamen an, der unter dem App-Symbol auf dem Startbildschirm Ihres Geräts oder im App Launcher angezeigt wird.
  2. Wählen Sie in der mobilen App in der unteren Navigationsleiste Mehr aus oder öffnen Sie die Einstellungen. Der Name der App und die Versionsnummer werden unten im Menü angezeigt.
  3. Sehen Sie sich die Liste der installierten Apps im Apple App Store (iOS) oder Google Play Store (Android) an.

Wenn Sie Looker Mobile (Legacy) installiert haben, endet der Support für diese Anwendung am 31. Januar 2027 und die Anwendung wird aus dem App-Store entfernt. Google empfiehlt dringend, zur aktuellen mobilen Looker-App zu migrieren. Dokumentation und Informationen zur Fehlerbehebung für die Legacy-Anwendung finden Sie im Leitfaden zur Looker Mobile (Legacy)-App.

Wenn Sie die mobile Looker-App installiert haben, fahren Sie mit den Schritten zur Fehlerbehebung in den folgenden Abschnitten fort.

Prüfen, ob das Problem auch außerhalb der mobilen App auftritt

Der erste Schritt bei der Fehlerbehebung besteht darin, festzustellen, ob das Problem nur die mobile App betrifft oder auch die Looker-Webanwendung.

Öffnen Sie einen Webbrowser auf einem Computer oder Mobilgerät, melden Sie sich in Ihrer Looker-Instanz an und versuchen Sie, dieselbe Aktion auszuführen:

  • Können Sie sich über einen Webbrowser anmelden? Wenn Sie sich nicht über einen Webbrowser anmelden können, liegt das Problem nicht an der mobilen App. Prüfen Sie Ihre Anmeldedaten, die Konfiguration des Identitätsanbieters (IdP) oder den Status des Nutzerkontos.
  • Werden Abfragen oder Dashboards in einem Webbrowser geladen? Wenn das Dashboard oder der Look nicht geladen wird, ein Datenbankfehler zurückgegeben wird oder eine Zeitüberschreitung im Browser auftritt, liegt das Problem an der zugrunde liegenden Abfrage, Datenbankverbindung oder dem LookML-Modell und nicht an der mobilen App.
  • Haben Sie die Berechtigung, auf die Inhalte zuzugreifen? Wenn Sie die Inhalte in der Weboberfläche nicht sehen können, prüfen Sie, ob Sie die entsprechenden Berechtigungen für Ordner, Modelle und Explorations haben.

Wenn das Problem auch in einem Webbrowser auftritt, beheben Sie es in Ihrer Looker-Instanz.

Wenn das Problem nur in der mobilen App auftritt, fahren Sie mit dem entsprechenden Abschnitt in diesem Leitfaden fort.

Probleme bei der Anmeldung beheben

Wenn Sie sich nicht in der mobilen Looker-App anmelden können, kann das folgende häufige Ursachen haben:

  • Instanz-URL-Format:Wenn Sie die Instanz-URL in der mobilen App eingeben, verwenden Sie das Format instance_name.looker.com oder Ihre benutzerdefinierte Domain. Geben Sie nicht https://, http:// oder nachgestellte Schrägstriche an.
  • Instanzaktivierung:Fragen Sie Ihren Looker-Administrator, ob der Zugriff auf die mobile App unter Admin > General > Mobile Application aktiviert ist.
  • Nutzerberechtigungen:Fragen Sie Ihren Administrator, ob Ihre Nutzerrolle oder Gruppe die Berechtigung mobile_app_access enthält.
  • Unternehmens-VPN und IP-Zulassungslisten:Wenn für Ihre Instanz IP-Zulassungslisten erzwungen werden, muss Ihr Mobilgerät mit dem VPN Ihrer Organisation verbunden sein und die statische IP-Adresse des VPN-Servers muss sich auf der IP-Zulassungsliste der Instanz befinden. Testen Sie dies, indem Sie die Instanz-URL in einem Webbrowser auf demselben Mobilgerät öffnen, während Sie mit dem VPN verbunden sind.
  • Vom Kunden gehostete API-Konfiguration:Wenn Sie eine vom Kunden gehostete Looker-Instanz (Original) verwenden, prüfen Sie, ob die Host-URL der API Ihrer Instanz unter Admin > Plattform > API mit dem Hostnamen Ihrer Instanz übereinstimmt. Prüfen Sie außerdem, ob Ihr Netzwerk Traffic über Mobilgeräte auf Port 443 oder Port 19999 zulässt. Weitere Informationen finden Sie in der Dokumentation unter Überlegungen zu vom Kunden gehosteten Instanzen und Fehlerbehebung bei der Looker API.
  • Biometrische Anmeldung:Wenn die biometrische Bestätigung (Fingerabdruck oder Gesichtserkennung) fehlschlägt, melden Sie sich mit Ihrem Standardnutzernamen und ‑passwort an. Sie können die biometrische Bestätigung in den Einstellungen der App unter Sicherheit neu konfigurieren. Hinweis: Biometrische Verfahren müssen auch in den Systemeinstellungen Ihres Mobilgeräts aktiviert sein.

Probleme bei der Anmeldung mit QR‑Code

Die einheitliche mobile Looker-App unterstützt die Anmeldung mit einem QR-Code nicht. Verwenden Sie stattdessen die Standardauthentifizierung (Google OAuth, SAML, LDAP, OpenID Connect oder E‑Mail-Adresse und Passwort).

Wenn Sie die Looker Mobile-App (Legacy) verwenden und sich nicht mit einem QR-Code anmelden können, prüfen Sie Folgendes:

  • Einbettungs-SSO-Authentifizierung:Rufen Sie in der Looker-Weboberfläche Admin > Plattform > Einbetten auf und prüfen Sie, ob Einbettungs-SSO-Authentifizierung aktiviert ist. Mit dieser Einstellung wird die Option für die Anmeldung per QR‑Code aktiviert.
  • QR‑Code aktualisieren:QR‑Codes sind zeitgebunden. Aktualisieren Sie die Webseite mit dem QR‑Code und versuchen Sie dann, den neu generierten QR‑Code zu scannen.
  • Berechtigung zum Zugriff auf die Kamera und Sichtbarkeit:Achten Sie darauf, dass die mobile App die Berechtigung zum Zugriff auf die Kamera Ihres Geräts hat, und dass beim Scannen des Bildschirms ausreichend Licht vorhanden ist.
  • Alternative Anmeldung:Wenn die QR-Code-Authentifizierung weiterhin fehlschlägt, melden Sie sich mit E-Mail-Adresse und Passwort an oder migrieren Sie zur aktualisierten mobilen Looker-App.

Probleme mit dem Rendern von Inhalten beheben

Wenn Dashboards oder Looks nicht gerendert werden, leere Karten angezeigt werden oder Fehlermeldungen in der mobilen App eingeblendet werden, sollten Sie Folgendes prüfen:

  • Umfang des Problems:Stellen Sie fest, ob der Renderingfehler alle Inhalte oder nur bestimmte Looks oder Dashboards betrifft:
    • Alle Inhalte schlagen fehl:Prüfen Sie die Netzwerkverbindung Ihres Mobilgeräts, ob Ihre Sitzung abgelaufen ist, und versuchen Sie, sich von der App ab- und wieder anzumelden.
    • Fehler bei bestimmten Inhalten:Prüfen Sie, ob für die Inhalte benutzerdefinierte Visualisierungen oder nicht unterstützte Layoutformate verwendet werden. Prüfen Sie außerdem, ob Sie Zugriff auf das zugrunde liegende Modell und die Explores haben.
  • Fehlermeldungen prüfen:Wenn ein Fehlerbanner oder ein Kachelfehler angezeigt wird, notieren Sie sich die spezifische Meldung. Häufige Probleme sind unter anderem Fehler bei der Datenbankverbindung, Zeitüberschreitungen bei Abfragen oder fehlende Feldreferenzen.
  • Unregelmäßige im Vergleich zu regelmäßigen Fehlern:Wenn Inhalte unregelmäßig fehlschlagen, liegt das Problem möglicherweise an der Datenbanklast oder an vorübergehenden Netzwerkschwankungen.
  • Zum Aktualisieren nach unten ziehen:Mit dieser Geste (auf dem Bildschirm nach unten ziehen) können Sie das Dashboard oder den Look neu laden und neue Abfragen ausführen.

Fehlerbehebung bei App-Abstürzen

Wenn die mobile Looker-App abstürzt oder unerwartet geschlossen wird, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

  • Unfallauslöser identifizieren:Notieren Sie sich, wann der Unfall passiert ist. Stürzt die App sofort nach dem Start, beim Öffnen eines bestimmten Dashboards, beim Drehen des Geräts zwischen Hoch- und Querformat oder nach einer bestimmten Nutzerinteraktion ab?
  • App aktualisieren:Prüfen Sie im App Store von Apple oder im Google Play Store, ob Sie die aktuelle Version der mobilen Looker-App verwenden. Updates enthalten häufig Stabilitätsverbesserungen und Fehlerkorrekturen.
  • Betriebssystem des Geräts aktualisieren:Auf Ihrem Mobilgerät muss eine unterstützte Version von iOS oder Android ausgeführt werden. Veraltete Betriebssysteme können zu Kompatibilitätsproblemen führen.
  • Cache leeren und neu starten:
    • Erzwinge das Schließen der App und öffne sie wieder.
    • Starte dein Mobilgerät neu.
    • Leeren Sie unter Android den Anwendungs-Cache unter Einstellungen > Apps > Looker > Speicher > Cache leeren.
  • App neu installieren:Deinstallieren Sie die App, starten Sie das Gerät neu und installieren Sie die App aus dem offiziellen App-Shop neu.

Leistungs- und Latenzprobleme beheben

Wenn die mobile Looker-Anwendung langsam ist, nicht reagiert oder das Laden von Inhalten lange dauert, sollten Sie Folgendes prüfen:

  • Langsame Komponente identifizieren:Stellen Sie fest, ob die Verzögerung beim Starten der App, beim Navigieren in Ordnern und Boards, beim Laden von zwischengespeicherten Inhaltslisten oder beim Ausführen von Abfragen für Dashboardkacheln auftritt.
  • Listencaching:Die mobile Anwendung speichert Listen mit zuletzt angesehenen und bevorzugten Inhalten im Cache, um die Navigation zu beschleunigen. Die Liste wird beim Starten der App automatisch aktualisiert. Sie können sie aber auch manuell aktualisieren, indem Sie sie nach unten ziehen, wenn sie nicht aktuell erscheint.
  • Komplexität des Dashboards und Anzahl der Kacheln:Dashboards mit vielen Kacheln oder komplexen Visualisierungstypen erfordern auf Mobilgeräten erhebliche Speicher- und Rechenressourcen. Testen Sie, ob kleinere Dashboards oder einzelne Looks schneller geladen werden.
  • Netzwerkgeschwindigkeit und ‑latenz:In Mobilfunknetzen kann es zu einer hohen Latenz oder zu Paketverlusten kommen. Prüfen Sie, ob sich die Leistung verbessert, wenn Sie mit einem zuverlässigen WLAN mit hoher Geschwindigkeit verbunden sind.
  • Leistung von Datenbankabfragen:Wenn das Rendern einzelner Kacheln lange dauert, prüfen Sie die Abfragedauer in der Looker-Weboberfläche oder in der Systemaktivität. Die Verzögerung kann auf Datenbankabfragen mit langer Ausführungszeit zurückzuführen sein.

Probleme mit der Darstellung und dem Styling beheben

Wenn Sie visuelle Fehler wie falsch ausgerichtete Elemente, beschädigte Symbole, verzerrte Bilder oder unerwartetes Padding feststellen, sollten Sie Folgendes prüfen:

  • Bildschirmausrichtung:Testen Sie das Dashboard oder den Look sowohl im Hoch- als auch im Querformat. Einige komplexe Dashboards und Tabellen sind für die Anzeige im Querformat optimiert.
  • Dashboard-Layout:Bei für Mobilgeräte optimierten Dashboards werden die Kachelpositionen dynamisch an kleine Bildschirme angepasst. Wenn sich Kacheln überlappen oder Text abgeschnitten wird, überprüfen Sie die Größe und Konfiguration der Kacheln im Bearbeitungsmodus des Dashboards in der Webanwendung.
  • Anzeigeeinstellungen des Geräts:Einstellungen für Bedienungshilfen wie benutzerdefinierte Schriftgrößen, Displayzoom oder Tools von Drittanbietern zur Umkehrung des dunklen Modus können die Darstellung von Inhalten verändern. Testen Sie mit den Standardeinstellungen für die Systemanzeige.
  • Visuelle Dokumentation:Machen Sie Screenshots oder Bildschirmaufzeichnungen, die die Rendering-Abweichung deutlich zeigen, und geben Sie sie an Ihren Administrator oder den Support weiter.

Diagnoseinformationen erfassen

Wenn Sie das Problem nach Ausführung der Schritte zur Fehlerbehebung nicht beheben können, halten Sie die folgenden Informationen bereit, bevor Sie sich an den Support wenden:

  1. Informationen zur Looker-Instanz:
    • Instanz-URL (z. B. instance_name.looker.com).
    • Looker-Releaseversion (wählen Sie in der Webanwendung Hilfe > Über aus).
    • Art des Instanzhostings (von Looker oder vom Kunden gehostet; Looker (Google Cloud Core) oder Looker (Original))
  2. Informationen zur mobilen App:
    • Welche App ist installiert? Geben Sie an, ob Sie die mobile Looker App oder Looker Mobile (Legacy) installiert haben.
    • Versionsnummer der App (unten im In-App-Menü Mehr oder in den Einstellungen).
    • App-Shop, aus dem die Anwendung installiert wurde (Apple App Store oder Google Play Store).
  3. Details zu Gerät und Betriebssystem:
    • Gerätehersteller und ‑modell (z. B. Google Pixel 8, iPhone 15 Pro)
    • Betriebssystemversion (z. B. Android 14, iOS 17.5).
  4. Umfang und Auswirkungen:
    • Betrifft das Problem alle Nutzer oder nur bestimmte Nutzerkonten?
    • Tritt das Problem auf allen Mobilgeräten oder nur auf bestimmten Gerätemodellen oder Betriebssystemversionen auf?
  5. Visuelle Beispiele und Logs:
    • Screenshots oder Bildschirmaufzeichnungen, die das unerwartete Verhalten oder die Fehlermeldung zeigen.
    • Genaue Schritte zum Reproduzieren des Problems

Support kontaktieren

Wenn Sie alle vorherigen Schritte überprüft haben und das Problem weiterhin besteht: