הגדרות אדמין – יומן

חלונית היומן

בחלונית Log מוצגות 500 ההודעות האחרונות ביומן המערכת שנוצרו על ידי מופע Looker שלכם. כדי להציג את הדף Log (יומן), בקטע Server (שרת) בתפריט Admin (אדמין), בוחרים באפשרות Log (יומן).

אפשר להגביל את המידע שמוצג בחלונית היומן. כדי לעשות זאת, מזינים טקסט בשדה Filter כדי שבחלונית Log יוצגו רק הודעות שכוללות את הטקסט הזה.

כדי לעדכן את היומן ולהציג את 500 ההודעות האחרונות, בוחרים באפשרות רענון היומן.

כדי לשנות את רמת החומרה של הודעות היומן שמוצגות בשירותי Looker, משנים את רמות היומן.

רמות יומן

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

רמת החומרה שמוגדרת כברירת מחדל לשירותים db:* ו-db:looker היא info, כלומר, מערכת Looker מתעדת הצהרות SQL שמכילות מידע אישי או מסננות מידע אישי (לדוגמה, שמות של לקוחות). זה נכון להגדרות חומרה של info,‏ verbose או debug. כדי להשבית את הרישום ביומן של הצהרות SQL, צריך להגדיר את רמת החומרה של השירותים db:* ו-db:looker לערך warn,‏ error או fatal.

הפקודות SQL נרשמות ביומנים של Looker גם במסד נתונים פנימי (שבו מאוחסנים המטא-נתונים של אובייקטים ב-Looker שנוצרו על ידי משתמשים) וגם במסדי נתונים חיצוניים (שבהם מאוחסנים נתוני הלקוחות והמטא-נתונים).

תיאורים של רמת החומרה

בהמשך מפורטות רמות החומרה של הודעות היומן, מהרמה הכי פחות חמורה ועד הרמה הכי חמורה:

  • ‫debug: רשומות ביומן ניפוי הבאגים הן הודעות מידע מפורטות שמציגות את התהליכים הפנימיים של אפליקציית Looker. רמת החומרה הזו משמשת בדרך כלל רק לניפוי באגים בקוד פנימי.

  • ‫verbose: הודעות מידע מפורטות שמציגות אירועים שמתרחשים ב-Looker ברמת פירוט גבוהה יותר. רמת החומרה הזו משמשת בדרך כלל רק לצורך פתרון בעיות.

  • מידע: אלה הודעות מידע רגילות שמציגות אירועים רגילים שמתרחשים ב-Looker.

  • אזהרה: ההודעות האלה מצביעות על מצבים שעלולים להזיק.

  • error: ההודעות האלה מציינות אירועי שגיאה שכנראה לא חמורים מספיק כדי לגרום להפסקת הפעולה של Looker.

  • ‫fatal: ההודעות האלה מציינות אירועי שגיאה חמורים מאוד, שסביר שיגרמו להפסקת הפעולה של Looker.

תיאורי שירות

בתפריט הנפתח Default (ברירת מחדל) מגדירים את רמת החומרה שמוגדרת כברירת מחדל לכל שירותי Looker. כל השירותים שמוגדרים כברירת מחדל משתמשים ברמת החומרה שמופיעה בתפריט הנפתח ברירת מחדל. רמת החומרה שמוגדרת כברירת מחדל בתפריט הנפתח Default היא info.

אפשר גם להגדיר רמות חומרה בנפרד לשירותים הבאים:

  • ‫pdt: הודעות שמשויכות לתהליך של טבלה נגזרת מתמידה.

  • ‫db:*: הודעות שנוצרות על ידי שאילתות למסד הנתונים של Analytics או על ידי שאילתות למסד נתונים של לקוח כלשהו.

  • ‫db:looker: הודעות שנוצרות על ידי שאילתות למסד הנתונים של Looker backend.

  • http: הודעות שנוצרות מבקשות HTTP ששרת האינטרנט של קצה קדמי מקבל או מעבד.

  • ‫http_core: הודעות שנוצרות מבקשות HTTP לשרת האינטרנט המרכזי שמשרת את החלקים הפנימיים של האפליקציה.

  • ‫jsch: הודעות שנוצרות על ידי חיבורי SSH לשירות Git. הגדרת ברירת המחדל היא רמה warn, שלא מציגה מידע. כדי לפתור בעיות בחיבור SSH, צריך לעבור לרמה info.

  • ‫logger: הודעות שנוצרות כשמבצעים שינויים ברמת היומן.

  • ‫org.apache.active: הודעות שנוצרות על ידי ActiveMQ. ‫ActiveMQ הוא שירות העברת הודעות ש-Looker משתמש בו כדי להעביר משימות בין מערכות משנה. היא משמשת את הכלי לתזמון, את יצירת ה-PDT מחדש ומשימות ארוכות אחרות.

  • ‫raven: הודעות שנוצרות על ידי שירות הדיווח על שגיאות.

  • render: הודעות שנוצרות על ידי כלי העיבוד, שמבצע עיבוד של קובצי 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"}