Looker モバイルアプリのトラブルシューティング

Looker モバイルアプリを使用すると、Android デバイスや iOS デバイスで Looker とデータポータル Pro のコンテンツにアクセスしたり、Look やダッシュボードを表示したり、外出先で共同作業を行ったりできます。モバイルアプリの使用中に問題（ログインの問題、レンダリング エラー、アプリのクラッシュ、パフォーマンスの遅延、表示の不一致など）が発生した場合は、このガイドに沿ってトラブルシューティングを行い、問題を解決してください。

前提条件と一般的な構成要件

トラブルシューティングを開始する前に、Looker モバイル アプリケーションを使用するための前提条件を環境とアカウントが満たしていることを確認してください。

  • モバイル アプリケーション アクセスが有効になっている: Looker 管理者がインスタンスのモバイル アプリケーション アクセスを有効にする必要があります。
  • ユーザー権限: ユーザー アカウントには、直接またはユーザー グループを通じて mobile_app_access Looker 権限が割り当てられている必要があります。
  • サポートされているインスタンス: Looker モバイル アプリケーションは、Looker（Google Cloud コア）（パブリック IP、またはプライベート サービス アクセスまたは企業 VPN を介してアクセス可能な Private Service Connect を使用するプライベート IP）と Looker（オリジナル）インスタンス（Looker ホスト型とセルフホスト型）をサポートしています。
  • 企業 VPN と IP 許可リスト: Looker インスタンスで IP 許可リストが適用されている場合、モバイル デバイスは、インスタンスの IP 許可リストに静的 IP アドレスを持つ企業 VPN を介して接続する必要があります。
  • サポートされている認証: Looker モバイルアプリは、Google OAuth、SAML、LDAP、OpenID Connect、メールアドレスとパスワードの認証情報をサポートしています。QR コードを使用したログインは、Looker Mobile（以前のバージョン）アプリケーションでのみサポートされており、埋め込み SSO を有効にする必要があります。

デバッグツリー

次のディシジョン ツリーを使用して、Looker モバイル アプリケーションの問題のトラブルシューティングを開始します。

以降のセクションでは、ツリー内のシナリオについて詳しく説明します。

インストールされているモバイル アプリケーションを特定する

Looker モバイルアプリと Looker Mobile（Legacy）アプリの両方がアプリストアで入手できるため、最初のトラブルシューティングの手順は、モバイル デバイスにインストールされているアプリを特定することです。サポートの最初のトリアージ ステップでは、この区別に基づいて、調査の誤った転送や遅延を防ぎます。

  • Looker: Looker とデータポータル Pro のコンテンツ用の現在の統合モバイル アプリケーション。デバイスのホーム画面とアプリストアでは、このアプリは Looker という名前で表示されます。標準の認証方法（Google OAuth、SAML、OpenID Connect、LDAP、メールアドレスとパスワードの認証情報など）をサポートしており、QR コード ログインはサポートしていません。このトラブルシューティング ガイドでは、主にこのアプリケーションについて説明します。
  • Looker Mobile（Legacy）: 以前のモバイル アプリケーション。デバイスのホーム画面とアプリストアでは、このアプリは Looker Mobile（Legacy）（または Looker Mobile）という名前で表示されます。QR コードとメールアドレスとパスワードによるログインはサポートされていますが、Google OAuth、SAML、Looker（Google Cloud コア）インスタンスはサポートされていません。

デバイスにインストールされているアプリを確認するには:

  1. デバイスのホーム画面またはアプリ ランチャーで、アプリ アイコンの下に表示されているアプリ名を確認します。
  2. モバイル アプリケーションで、下部のナビゲーション メニューの [その他] を選択するか、[設定] を開き、メニューの下部にあるアプリケーション名とバージョン番号を確認します。
  3. Apple App Store（iOS）または Google Play ストア（Android）で、インストールされているアプリのリストを確認します。

Looker Mobile (Legacy) がインストールされている場合、このアプリのサポートは 2027 年 1 月 31 日に終了し、アプリはリストから削除されます。現在の Looker モバイル アプリケーションへの移行を強くおすすめします。以前のアプリケーションのドキュメントとトラブルシューティングについては、Looker Mobile（以前のバージョン）アプリケーション ガイドをご覧ください。

Looker モバイルアプリがインストールされている場合は、次のセクションのトラブルシューティングの手順に進みます。

モバイル アプリケーション以外で問題が再現されるかどうかを確認する

トラブルシューティングの最初のステップは、問題がモバイルアプリに限定されているのか、Looker ウェブアプリにも影響しているのかを判断することです。

パソコンまたはモバイルのウェブブラウザを開き、Looker インスタンスにログインして、同じ操作を試します。

  • ウェブブラウザからログインできますか？ウェブブラウザからログインできない場合は、モバイルアプリ固有の問題ではありません。認証情報、ID プロバイダ（IdP）の構成、ユーザー アカウントのステータスを確認します。
  • クエリまたはダッシュボードがウェブブラウザに読み込まれますか？ダッシュボードや Look の読み込みに失敗した場合、データベース エラーが返された場合、ブラウザでタイムアウトになった場合は、モバイル アプリケーションではなく、基盤となるクエリ、データベース接続、LookML モデルに問題があります。
  • コンテンツにアクセスする権限がありますか？ウェブ インターフェースでコンテンツを表示できない場合は、適切なフォルダ、モデル、データ探索のアクセス権限があることを確認してください。

ウェブブラウザでも問題が再現する場合は、Looker インスタンスで問題のトラブルシューティングを行います。

問題がモバイル アプリでのみ発生する場合は、このガイドの該当するセクションに進みます。

ログインに関する問題のトラブルシューティング

Looker モバイルアプリにログインできない場合は、次の一般的な原因を調べてください。

  • インスタンス URL の形式: モバイルアプリにインスタンス URL を入力する場合は、instance_name.looker.com 形式またはカスタム ドメインを使用します。https://、http://、末尾のスラッシュは含めないでください。
  • インスタンスの有効化: Looker 管理者に、[管理者] > [全般] > [モバイル アプリケーション] でモバイル アプリケーション アクセスが有効になっていることを確認してもらいます。
  • ユーザー権限: ユーザーのロールまたはグループに mobile_app_access 権限が含まれていることを管理者にご確認ください。
  • 企業 VPN と IP 許可リスト: インスタンスで IP 許可リストが適用されている場合は、モバイル デバイスが組織の VPN に接続され、VPN サーバーの静的 IP アドレスがインスタンスの IP 許可リストに含まれていることを確認します。VPN に接続した状態で、同じモバイル デバイスのウェブブラウザでインスタンス URL を開いてテストします。
  • セルフホスト型 API 構成: セルフホスト型 Looker（オリジナル）インスタンスを使用している場合は、[管理 > プラットフォーム > API] の [API ホスト URL] がインスタンスのホスト名と一致していることを確認します。また、ネットワークでポート 443 またはポート 19999 のモバイル トラフィックが許可されていることを確認します。詳細については、セルフホスト型インスタンスに関する考慮事項と Looker API のトラブルシューティングのドキュメント ページをご覧ください。
  • 生体認証によるログイン: 生体認証（指紋または顔認識）が失敗した場合は、標準のユーザー名とパスワードを使用してログインします。生体認証システムは、アプリの [設定] メニューの [セキュリティ] で再構成できます。生体認証は、モバイル デバイスのシステム設定でも有効にする必要があります。

QR コードによるログインに関する問題

統合された Looker モバイル アプリケーションでは、QR コードを使用したログインはサポートされていません。代わりに、標準認証（Google OAuth、SAML、LDAP、OpenID Connect、メールアドレスとパスワード）を使用します。

Looker Mobile（Legacy）アプリケーションを使用しているときに QR コードでログインできない場合は、次の点を確認してください。

  • 埋め込み SSO 認証: Looker ウェブ インターフェースで、[管理者] > [プラットフォーム] > [埋め込み] に移動し、埋め込み SSO 認証が有効になっていることを確認します。この設定により、QR コードによるログイン オプションが有効になります。
  • QR コードを更新する: QR コードには有効期限があります。QR コードが表示されているウェブページを更新し、新しく生成された QR コードをスキャンしてみてください。
  • カメラの権限と可視性: モバイル アプリケーションにデバイスのカメラへのアクセス権限があることを確認し、画面をスキャンする際に十分な照明があることを確認します。
  • 代替ログイン: QR コード認証が引き続き失敗する場合は、メールアドレスとパスワードの認証情報を使用してログインするか、更新された Looker モバイル アプリケーションに移行します。

コンテンツのレンダリングに関する問題のトラブルシューティング

ダッシュボードまたは Look がレンダリングされない、空白のカードが表示される、モバイル アプリケーションにエラー メッセージが表示される場合は、次のことを確認してください。

  • 問題の範囲: レンダリングの失敗がすべてのコンテンツに影響しているのか、特定の Look またはダッシュボードにのみ影響しているのかを判断します。
    • すべてのコンテンツが失敗する: モバイル デバイスのネットワーク接続を確認し、セッションの有効期限が切れていないことを確認してから、アプリからログアウトして再度ログインしてみてください。
    • 特定のコンテンツが失敗する: コンテンツでカスタムの可視化やサポートされていないレイアウト形式が使用されていないか確認します。基盤となるモデルとエクスプローラにアクセスできることも確認します。
  • エラー メッセージを確認する: エラー バナーまたはエラー タイルが表示された場合は、具体的なメッセージをメモします。一般的な問題としては、データベース接続エラー、クエリ タイムアウト、フィールド参照の欠落などがあります。
  • 断続的な失敗と一貫した失敗: コンテンツが断続的に失敗する場合は、データベースの負荷または一時的なネットワークの変動に関連している可能性があります。
  • プルして更新: プルして更新するジェスチャー（画面を下に引っ張る）を使用して、ダッシュボードまたは Look を再読み込みし、新しいクエリを実行します。

アプリケーションのクラッシュのトラブルシューティング

Looker モバイルアプリがクラッシュしたり、予期せず終了したりする場合は、次のトラブルシューティングの手順に沿って対応してください。

  • クラッシュのトリガーを特定する: クラッシュが発生した日時をメモします。アプリは、起動直後、特定のダッシュボードを開いたとき、デバイスを縦向きモードと横表示モードの間で回転させたとき、または特定のユーザー操作の後にすぐにクラッシュしますか？
  • アプリケーションを更新する: Apple アプリストアまたは Google Play ストアで、Looker モバイルアプリの最新バージョンを実行していることを確認します。アップデートには、安定性の向上やバグの修正が含まれていることがよくあります。
  • デバイスのオペレーティング システムを更新する: モバイル デバイスでサポートされているバージョンの iOS または Android が実行されていることを確認します。オペレーティング システムが古いと、互換性の問題が発生する可能性があります。
  • キャッシュを削除して再起動する:
    • アプリケーションを強制終了して、もう一度開きます。
    • モバイル デバイスを再起動します。
    • Android の場合は、[設定] > [アプリ] > [Looker] > [ストレージ] > [キャッシュを削除] でアプリケーション キャッシュを削除します。
  • アプリケーションを再インストールする: アプリをアンインストールし、デバイスを再起動して、公式アプリストアからアプリケーションを再インストールします。

パフォーマンスとレイテンシの問題のトラブルシューティング

Looker モバイルアプリの動作が遅い、応答がない、コンテンツの読み込みに時間がかかる場合は、次のことを確認します。

  • 動作が遅いコンポーネントを特定する: アプリの起動時、フォルダやボードのナビゲーション時、コンテンツのキャッシュ リストの読み込み時、ダッシュボード タイルのクエリの実行時のいずれで遅延が発生するかを特定します。
  • リスト キャッシュ保存: モバイル アプリケーションは、最近表示したコンテンツとお気に入りのコンテンツのリストをキャッシュに保存して、ナビゲーションを高速化します。リストはアプリの起動時に自動的に更新されますが、リストが古くなっている場合は、プルダウンして手動で更新できます。
  • ダッシュボードの複雑さとタイルの数: タイル数が多いダッシュボードや、複雑なビジュアリゼーション タイプを使用するダッシュボードでは、モバイル デバイスで大量のメモリと処理リソースが必要になります。小さいダッシュボードや個々の Look の読み込みが速くなるかどうかをテストします。
  • ネットワークの速度とレイテンシ: モバイル ネットワークでは、レイテンシが高くなったり、パケットロスが発生したりすることがあります。信頼性の高い高速 Wi-Fi ネットワークに接続したときにパフォーマンスが向上するかどうかをテストします。
  • データベース クエリのパフォーマンス: 個々のタイルがレンダリングに時間がかかる場合は、Looker ウェブ インターフェースまたはシステム アクティビティでクエリの所要時間を確認します。遅延は、データベース クエリの実行時間が長いことが原因である可能性があります。

表示とスタイルの問題をトラブルシューティングする

要素のずれ、アイコンの破損、画像の歪み、予期しないパディングなどの視覚的な欠陥が発生した場合は、次のことを確認します。

  • 画面の向き: ダッシュボードまたは Look を縦向きと横向きの両方でテストします。一部の複雑なダッシュボードとテーブルは、横長の表示に最適化されています。
  • ダッシュボードのレイアウト: モバイル対応のダッシュボードでは、小さな画面に合わせてタイルの位置が動的に調整されます。タイルが重なったり、テキストが切り捨てられたりする場合は、ウェブ アプリケーションのダッシュボード編集モードでタイルのサイズと構成を確認します。
  • デバイスのディスプレイ設定: カスタム システム フォントサイズ、ディスプレイのズーム、サードパーティのダークモード反転ツールなどのユーザー補助設定は、コンテンツのレンダリング方法を変更する可能性があります。デフォルトのシステム ディスプレイ設定でテストします。
  • 視覚的なドキュメント: レンダリングの不一致が明確にわかるスクリーンショットまたはスクリーン レコーダーを撮影し、管理者またはサポートと共有します。

診断情報を収集する

トラブルシューティングの手順に沿って操作しても問題が解決しない場合は、サポートにお問い合わせいただく前に、次の情報を収集してください。

  1. Looker インスタンス情報:
    • インスタンスの URL（instance_name.looker.com など）。
    • Looker のリリース バージョン（ウェブ アプリケーションで [Help] > [About] を選択します）。
    • インスタンスのホスティング タイプ（Looker ホスト型またはセルフホスト型、Looker（Google Cloud コア）または Looker（オリジナル））。
  2. モバイルアプリの情報:
    • インストールされているアプリ: Looker モバイルアプリと Looker Mobile（旧版）のどちらをインストールしているかを指定します。
    • アプリのバージョン番号（アプリ内の [その他] メニューまたは [設定] の下部に表示されます）。
    • アプリがインストールされたアプリストア（Apple App Store または Google Play ストア）。
  3. デバイスとオペレーティング システムの詳細:
    • デバイスのメーカーとモデル（Google Pixel 8、iPhone 15 Pro など）。
    • オペレーティング システムのバージョン（Android 14、iOS 17.5 など）。
  4. 範囲と影響:
    • 問題はすべてのユーザーに影響しますか、それとも特定のユーザー アカウントのみに影響しますか？
    • この問題はすべてのモバイル デバイスで発生しますか？それとも、特定のデバイスモデルまたはオペレーティング システムのバージョンでのみ発生しますか？
  5. 視覚的な例とログ:
    • 予期しない動作やエラー メッセージが表示されているスクリーンショットまたは画面録画。
    • 問題を再現するための正確な手順。

サポートに問い合わせる

上記の手順をすべて試しても問題が解決しない場合: