פתרון בעיות באפליקציית Looker לנייד

אפליקציית Looker לנייד מאפשרת לכם לגשת לתוכן של Looker ושל Data Studio Pro במכשירי Android ו-iOS, להציג תצוגות ולוחות בקרה ולשתף פעולה תוך כדי תנועה. אם נתקלתם בבעיות במהלך השימוש באפליקציה לנייד – כמו בעיות בכניסה, שגיאות עיבוד, קריסות של האפליקציה, עיכובים בביצועים או אי התאמות בתצוגה – המדריך הזה יעזור לכם לפתור אותן.

כאן אפשר לראות השוואה בין התכונות.

דרישות מוקדמות ודרישות הגדרה נפוצות

לפני שמתחילים לפתור בעיות, צריך לוודא שהסביבה והחשבון עומדים בדרישות המוקדמות לשימוש באפליקציית Looker לנייד:

  • הגישה לאפליקציה לנייד מופעלת: אדמין ב-Looker צריך להפעיל את הגישה לאפליקציה לנייד עבור המכונה שלכם.
  • הרשאות משתמשים: לחשבון המשתמש שלכם צריכה להיות הרשאת Looker‏ mobile_app_access שהוקצתה ישירות או דרך קבוצת משתמשים.
  • מכונות נתמכות: אפליקציית Looker לנייד תומכת במכונות Looker (Google Cloud core) (כתובת IP ציבורית או כתובת IP פרטית באמצעות גישה לשירותים פרטיים או Private Service Connect שניתן לגשת אליהם דרך VPN ארגוני) ובמכונות Looker (מקורי) (באירוח Looker ובאירוח בצד הלקוח).
  • רשימות היתרים של כתובות IP ו-VPN ארגוני: אם מופעלת במופע Looker שלכם רשימת היתרים של כתובות IP, המכשיר הנייד שלכם צריך להתחבר דרך VPN ארגוני עם כתובת IP סטטית ברשימת ההיתרים של כתובות ה-IP של המופע.
  • אימות נתמך: אפליקציית Looker לנייד תומכת ב-Google OAuth,‏ SAML,‏ LDAP,‏ OpenID Connect ובאישורים של כתובת אימייל וסיסמה. התחברות באמצעות קודי QR נתמכת רק באפליקציית Looker לנייד (דור קודם) ונדרש להפעיל את האפשרות Embed SSO.

עץ ניפוי הבאגים

כדי להתחיל לפתור בעיות באפליקציית Looker לנייד, אפשר להיעזר בעץ ההחלטות הבא:

בקטעים הבאים מפורטים התרחישים בעץ.

איך מזהים איזו אפליקציה לנייד מותקנת

אפליקציית Looker לנייד ואפליקציית Looker לנייד (דור קודם) זמינות בחנויות האפליקציות, ולכן השלב הראשון בפתרון בעיות הוא לברר איזו אפליקציה מותקנת במכשיר הנייד. השלב הראשוני במיון של צוות התמיכה מסתמך על ההבחנה הזו כדי למנוע הפניות שגויות או עיכובים בחקירות:

  • ‫Looker: האפליקציה המאוחדת לנייד שכוללת את התוכן של Looker ו-Data Studio Pro. במסך הבית של המכשיר ובחנויות האפליקציות, שם האפליקציה הוא Looker. הוא תומך בשיטות אימות סטנדרטיות (כמו Google OAuth,‏ SAML,‏ OpenID Connect,‏ LDAP ופרטי כניסה של אימייל וסיסמה) ולא תומך בכניסה באמצעות קוד QR. המדריך הזה לפתרון בעיות מתייחס בעיקר לאפליקציה הזו.
  • Looker לנייד (דור קודם): האפליקציה הישנה יותר לנייד. במסך הבית של המכשיר ובחנויות האפליקציות, שם האפליקציה הוא Looker Mobile (Legacy) (או Looker Mobile). היא תומכת בכניסה באמצעות קוד QR, אימייל וסיסמה, אבל לא תומכת ב-Google OAuth, ב-SAML או במופעים של Looker (ליבת Google Cloud).

כדי לדעת איזו אפליקציה מותקנת במכשיר:

  1. בודקים את שם האפליקציה שמופיע מתחת לסמל האפליקציה במסך הבית של המכשיר או במרכז האפליקציות.
  2. באפליקציה לנייד, לוחצים על עוד בתפריט הניווט התחתון או פותחים את ההגדרות ומאתרים את שם האפליקציה ומספר הגרסה בתחתית התפריט.
  3. בודקים את רשימת האפליקציות המותקנות ב-App Store של אפל (iOS) או בחנות Google Play (Android).

אם התקנתם את Looker לנייד (דור קודם), התמיכה באפליקציה הזו תסתיים ב-31 בינואר 2027, והאפליקציה תוסר מהרשימה. ‫Google ממליצה מאוד לעבור אל אפליקציית Looker לנייד בגרסה הנוכחית. במדריך בנושא אפליקציית Looker לנייד (גרסה קודמת) מפורטים מסמכי תיעוד ופתרון בעיות שקשורות לאפליקציה מהדור הקודם.

אם אפליקציית Looker לנייד מותקנת, אפשר להמשיך לשלבים לפתרון בעיות שמפורטים בקטעים הבאים.

בודקים אם הבעיה חוזרת על עצמה מחוץ לאפליקציה לנייד

השלב הראשון בפתרון בעיות הוא לקבוע אם הבעיה מוגבלת לאפליקציה לנייד או שהיא משפיעה גם על אפליקציית האינטרנט של Looker.

פותחים דפדפן אינטרנט במחשב או בנייד, נכנסים למופע Looker ומנסים לבצע את אותה פעולה:

  • האם אפשר להיכנס לחשבון דרך דפדפן אינטרנט? אם אתם לא מצליחים להיכנס לחשבון מדפדפן אינטרנט, הבעיה לא ספציפית לאפליקציה לנייד. צריך לבדוק את פרטי הכניסה, את ההגדרות של ספק הזהויות (IdP) או את הסטטוס של חשבון המשתמש.
  • האם שאילתות או לוחות בקרה נטענים בדפדפן אינטרנט? אם מרכז הבקרה או ה-Look לא נטענים, מחזירים שגיאה במסד הנתונים או שפג הזמן הקצוב לתפוגה בדפדפן, הבעיה נובעת מהשאילתה הבסיסית, מהחיבור למסד הנתונים או ממודל LookML ולא מאפליקציית המובייל.
  • יש לך הרשאה לגשת לתוכן? אם אתם לא מצליחים לראות את התוכן בממשק האינטרנט, צריך לוודא שיש לכם הרשאות גישה מתאימות לתיקייה, למודל ול-Explore.

אם הבעיה חוזרת גם בדפדפן אינטרנט, צריך לפתור את הבעיה במופע Looker.

אם הבעיה מתרחשת רק באפליקציה לנייד, אפשר להמשיך לקטע הרלוונטי במדריך הזה.

פתרון בעיות שקשורות לכניסה לחשבון

אם אתם לא מצליחים להיכנס לאפליקציית Looker לנייד, כדאי לבדוק את הסיבות הנפוצות הבאות:

  • פורמט כתובת ה-URL של המופע: כשמזינים את כתובת ה-URL של המופע באפליקציה לנייד, צריך להשתמש בפורמט instance_name.looker.com או בדומיין המותאם אישית. לא כולל https://,‏ http:// או לוכסנים בסוף.
  • הפעלת המופע: צריך לוודא עם האדמין של Looker שהגישה לאפליקציה לנייד מופעלת בקטע Admin > General > Mobile Application (אדמין > כללי > אפליקציה לנייד).
  • הרשאות משתמש: צריך לוודא מול האדמין שתפקיד המשתמש או הקבוצה שלכם כוללים את ההרשאה mobile_app_access.
  • רשימות של כתובות IP שמוגדרות ככתובות מותרות ו-VPN ארגוני: אם במופע שלכם מופעלות רשימות של כתובות IP שמוגדרות ככתובות מותרות, צריך לוודא שהמכשיר הנייד מחובר ל-VPN של הארגון ושהכתובת IP הסטטית של שרת ה-VPN מופיעה ברשימת כתובות ה-IP שמוגדרות ככתובות מותרות במופע. כדי לבדוק את זה, פותחים את כתובת ה-URL של המופע בדפדפן אינטרנט באותו מכשיר נייד בזמן שאתם מחוברים ל-VPN.
  • הגדרת API באירוח בצד הלקוח: אם אתם משתמשים במופע Looker (מקורי) באירוח בצד הלקוח, אתם צריכים לוודא שכתובת ה-URL של מארח ה-API במופע שלכם, בקטע אדמין > פלטפורמה > API, זהה לשם המארח של המופע. בנוסף, צריך לוודא שהרשת מאפשרת תנועה שמגיעה ממובייל ביציאה 443 או ביציאה 19999. מידע נוסף זמין במאמרי העזרה בנושא שיקולים לגבי מופעים באירוח בצד הלקוח ופתרון בעיות ב-Looker API.
  • כניסה באמצעות נתונים ביומטריים: אם האימות הביומטרי (טביעת אצבע או זיהוי פנים) נכשל, צריך להיכנס באמצעות שם המשתמש והסיסמה הרגילים. אפשר להגדיר מחדש את האימות הביומטרי בתפריט הגדרות של האפליקציה בקטע אבטחה. שימו לב: צריך להפעיל גם נתונים ביומטריים בהגדרות המערכת של המכשיר הנייד.

בעיות בכניסה באמצעות קוד QR

באפליקציית Looker המאוחדת לנייד אין תמיכה בכניסה באמצעות קוד QR. במקום זאת, צריך להשתמש באימות רגיל (Google OAuth, ‏ SAML, ‏ LDAP, ‏ OpenID Connect או אימייל וסיסמה).

אם אתם משתמשים באפליקציה Looker לנייד (דור קודם) ולא מצליחים להיכנס באמצעות קוד QR, כדאי לבדוק את הדברים הבאים:

  • הטמעת אימות SSO: בממשק האינטרנט של Looker, עוברים אל Admin > Platform > Embed ומוודאים שהאפשרות Embed SSO Authentication מופעלת. ההגדרה הזו מפעילה את האפשרות להתחבר באמצעות קוד QR.
  • מרעננים את קוד ה-QR: קודי QR תקפים לזמן מוגבל. מרעננים את דף האינטרנט שבו מוצג קוד ה-QR, ואז מנסים לסרוק את קוד ה-QR שנוצר.
  • הרשאות גישה למצלמה והגדרות חשיפה: מוודאים שלאפליקציה לנייד יש הרשאת גישה למצלמה במכשיר, ומוודאים שיש תאורה מספקת כשסורקים את המסך.
  • שיטת התחברות חלופית: אם האימות באמצעות קוד QR ממשיך להיכשל, אפשר להתחבר באמצעות אישורים של כתובת אימייל וסיסמה, או לעבור לאפליקציית Looker לנייד המעודכנת.

פתרון בעיות ברינדור של תוכן

אם לוחות בקרה או תצוגות לא מוצגים, מוצגים ככרטיסים ריקים או מוצגות הודעות שגיאה באפליקציה לנייד, כדאי לבדוק את הדברים הבאים:

  • היקף הבעיה: בודקים אם כשל העיבוד משפיע על כל התוכן או רק על לוחות בקרה או על תצוגות מסוימות:
    • אם כל התוכן נכשל: צריך לבדוק את החיבור לרשת במכשיר הנייד, לוודא שהסשן לא פג ולנסות לצאת מהאפליקציה ואז להיכנס אליה שוב.
    • תוכן ספציפי נכשל: בודקים אם התוכן משתמש בהדמיות מותאמות אישית או בפורמטים של פריסות שלא נתמכים. חשוב גם לוודא שיש לכם גישה למודל ולניתוחים הבסיסיים.
  • בדיקת הודעות שגיאה: אם מופיעה הודעת שגיאה או שגיאה במשבצת, כדאי לרשום את ההודעה הספציפית. בעיות נפוצות כוללות שגיאות בחיבור למסד הנתונים, חריגה מזמן קצוב לתפוגה של שאילתות או הפניות חסרות לשדות.
  • כשלים לסירוגין לעומת כשלים עקביים: אם התוכן נכשל לסירוגין, יכול להיות שהבעיה קשורה לעומס על מסד הנתונים או לתנודות זמניות ברשת.
  • משיכה לרענון: משתמשים בתנועת המשיכה לרענון (משיכה למטה במסך) כדי לטעון מחדש את לוח הבקרה או את Look ולהריץ שאילתות חדשות.

פתרון בעיות שקשורות לקריסות של אפליקציות

אם אפליקציית Looker לנייד קורסת או נסגרת באופן בלתי צפוי, כדאי לפעול לפי השלבים הבאים לפתרון בעיות:

  • זיהוי הטריגרים לקריסה: שימו לב מתי הקריסה מתרחשת. האם האפליקציה קורסת מיד אחרי ההפעלה, כשפותחים לוח בקרה מסוים, כשמסובבים את המכשיר בין מצב לאורך למצב לרוחב או אחרי אינטראקציה מסוימת של המשתמש?
  • עדכון האפליקציה: כדאי לבדוק ב-Apple App Store או בחנות 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 Core)‎ או Looker (מקורי)).
  2. פרטי האפליקציה לנייד:
    • איזו אפליקציה מותקנת: מציינים אם התקנתם את אפליקציית Looker לנייד או את Looker Mobile (דור קודם).
    • מספר הגרסה של האפליקציה (מופיע בתחתית התפריט עוד באפליקציה או בהגדרות).
    • חנות האפליקציות שממנה האפליקציה הותקנה (App Store של אפל או חנות Google Play).
  3. פרטים על המכשיר ומערכת ההפעלה:
    • היצרן והדגם של המכשיר (לדוגמה, Google Pixel 8, ‏ iPhone 15 Pro).
    • גרסת מערכת ההפעלה (לדוגמה, Android 14, ‏ iOS 17.5).
  4. היקף והשפעה:
    • האם הבעיה משפיעה על כל המשתמשים או רק על חשבונות משתמשים ספציפיים?
    • האם הבעיה מתרחשת בכל המכשירים הניידים או רק בדגמים ספציפיים של מכשירים או בגרסאות ספציפיות של מערכת ההפעלה?
  5. דוגמאות חזותיות ויומנים:
    • צילומי מסך או הקלטות מסך שבהם מוצגת ההתנהגות הלא צפויה או הודעת השגיאה.
    • מה בדיוק אתם עושים עד שאתם נתקלים בבעיה.

פנייה לתמיכה

אם ביצעתם את כל השלבים הקודמים והבעיה עדיין לא נפתרה: