בדף Log בתפריט Admin ב-Looker אפשר לראות ולסנן את 500 ההודעות האחרונות ביומן המערכת שנוצרו על ידי המופע. אתם יכולים גם להגדיר רמות חומרה מינימליות לשירותים ספציפיים של Looker כדי לפתור בעיות באירועים באפליקציה ולשלוט בהודעות שמופיעות ביומן.
חלונית היומן
בחלונית Log מוצגות 500 ההודעות האחרונות ביומן המערכת שנוצרו על ידי המכונה של Looker. כדי להציג את הדף Log, בקטע Server בתפריט Admin, בוחרים באפשרות Log.
אפשר להגביל את המידע שמוצג בחלונית היומן. כדי לעשות זאת, מזינים טקסט בשדה Filter כדי שבלוח Log יוצגו רק הודעות שכוללות את הטקסט הזה.
כדי לעדכן את היומן ולהציג את 500 ההודעות האחרונות, לוחצים על רענון היומן.
כדי לשנות את רמת החומרה של הודעות היומן שמוצגות לשירותי Looker, משנים את רמות היומן.
רמות הרישום ביומן
בקטע Log Levels אפשר להגדיר את רמת החומרה המינימלית שנדרשת כדי שהודעה תופיע ביומן, לכמה שירותים שונים של Looker. כך אפשר להסתיר מידע ביומן שלא מעניין אתכם.
רמת החומרה שמוגדרת כברירת מחדל לשירותים db:* ו-db:looker היא info. המשמעות היא שהצהרות SQL שמכילות מידע אישי או מסננות לפיו (לדוגמה, שמות של לקוחות) נרשמות ביומן על ידי Looker. זה נכון לגבי הגדרות החומרה info, verbose או debug. כדי להשבית את הרישום ביומן של הצהרות SQL, מגדירים את רמת החומרה של השירותים db:* ו-db:looker לערך warn, error או fatal.
Looker מתעד הצהרות SQL גם במסד נתונים פנימי (שבו מאוחסנים מטא-נתונים של אובייקטים ב-Looker שנוצרו על ידי משתמשים) וגם במסדי נתונים חיצוניים (שבהם מאוחסנים נתוני לקוחות ומטא-נתונים).
תיאורי חומרה
רמות החומרה של הודעות ביומן מפורטות בהמשך, מהרמה הנמוכה ביותר ועד לרמה הגבוהה ביותר:
debug: רשומות ביומן ניפוי הבאגים הן הודעות מידע מפורטות שמציגות את תהליכי האפליקציה הפנימיים של Looker. רמת החומרה הזו משמשת בדרך כלל רק לניפוי באגים בקוד פנימי.
verbose: אלה הודעות מידע מפורטות שמציגות אירועים שמתרחשים ב-Looker ברמה מפורטת יותר. רמת החומרה הזו משמשת בדרך כלל רק לפתרון בעיות.
info: אלה הודעות מידע רגילות שמציגות אירועים רגילים שמתרחשים ב-Looker.
אזהרה: ההודעות האלה מצביעות על מצבים שעלולים להזיק.
error: ההודעות האלה מציינות אירועי שגיאה שכנראה לא חמורים מספיק כדי לגרום להפסקת הפעולה של Looker.
fatal: ההודעות האלה מציינות אירועי שגיאה חמורים מאוד, שסביר להניח שיגרמו ל-Looker להפסיק לפעול.
תיאורי שירותים
בתפריט הנפתח Default מגדירים את רמת החומרה שמוגדרת כברירת מחדל לכל שירותי Looker. כל השירותים שמוגדרים כברירת מחדל משתמשים ברמת החומרה שבתפריט הנפתח Default. רמת החומרה שמוגדרת כברירת מחדל בתפריט הנפתח Default היא info.
אפשר גם להגדיר רמות חומרה בנפרד לשירותים הבאים:
pdt: הודעות שמשויכות לתהליך של טבלה נגזרת מתמידה.
db:*: הודעות שנוצרות על ידי שאילתות למסד הנתונים של ניתוח הנתונים או על ידי שאילתות לכל מסד נתונים של לקוחות.
db:looker: הודעות שנוצרות על ידי שאילתות למסד הנתונים של העורף האחורי של Looker.
http: הודעות שנוצרות מבקשות HTTP ששרת האינטרנט של ממשק המשתמש מקבל או מעבד.
http_core: הודעות שנוצרות מבקשות HTTP לשרת האינטרנט המרכזי שמשרת את הפנימיות של האפליקציה.
jsch: הודעות שנוצרות על ידי חיבורי SSH לשירות Git. הגדרת ברירת המחדל היא ברמה warn, שלא מציגה מידע. כדי לפתור בעיות בחיבור SSH, צריך לשנות את הרמה ל-info.
logger: הודעות שנוצרות כשמבצעים שינויים ברמת היומן.
org.apache.active: הודעות שנוצרות על ידי ActiveMQ. ActiveMQ הוא שירות העברת הודעות שמשמש את Looker כדי להעביר משימות בין תת-מערכות. הוא משמש את המתזמן, את יצירת ה-PDT מחדש ומשימות אחרות שפועלות לאורך זמן.
raven: הודעות שנוצרות על ידי שירות Error Reporting.
render: הודעות שנוצרות על ידי ה-renderer, שמעבד קובצי PDF ו-PNG.
scheduler: הודעות שנוצרות על ידי תהליך התזמון.
אחרי שמשנים את רמת הרישום ביומן של שירות, לוחצים על הגדרת רמות כדי לשמור את השינויים.
הגדרת פורמט היומן במכונות באירוח בצד הלקוח
כברירת מחדל, הודעות המערכת מוצגות בטקסט בפורמט הבא:
2019-09-25 15:14:12.301 -0700 [INFO|007d0|main] :: Starting Looker : Version 6.21.0-localdev-ea88a4
...
2019-10-01 14:37:53.424 -0700 [INFO|0002a|http] :: Request from 0:0:0:0:0:0:0:1 GET /folders/1, {}
...
2019-10-01 14:37:53.425 -0700 [INFO|0002a|db:looker] :: (0.000180s) SELECT count(*) AS "COUNT" FROM "USER" LIMIT 1
חלק מהודעות המערכת, כמו חריגות ושאילתות SQL, נוצרות כפלט של כמה שורות. הדבר עלול לגרום לבעיות במעבדי יומנים שדורשים רשומות בשורה אחת להתאמת תבניות.
אם המכונה של Looker מתארחת בצד הלקוח ואתם צריכים פלט של שורה אחת, אתם יכולים להשתמש באפשרות ההפעלה --log-format=json כדי לעצב רשומות ביומן למבני JSON של שורה אחת. בדוגמה הבאה מוצגים אותם אירועים כמו בדוגמה הקודמת, אבל בפורמט JSON:
{"t":"2019-09-25 15:14:56.513 -0700","s":"INFO","rid":"007d0","c":"main","msg":"Starting Looker : Version 6.21.0-localdev-ea88a4"}
...
{"t":"2019-10-01T14:35:37.577 -07:00","s":"INFO","rid":"0002c","c":"http","ip":"0:0:0:0:0:0:0:1","verb":"GET","path":"/folders/1","params":{}}
...
{"t":"2019-10-01T14:35:37.581 -07:00","s":"INFO","rid":"0002c","c":"db:looker","duration":"0.000344","sql":"SELECT count(*) AS \"COUNT\" FROM \"USER\" LIMIT 1"}