הצגת יומנים ושגיאות בלוח בקרה בהתאמה אישית

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

התכונה הזו נתמכת רק בפרויקטים של Google Cloud . בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.

Logs Explorer והווידג'ט של חלונית היומנים

Logs Explorer הוא הדרך הרגילה לבדיקת יומנים. הוספת ווידג'ט של לוח יומנים למרכז בקרה לא תשנה את אופן השימוש ב-Logs Explorer. אפשר להוסיף את הווידג'טים של חלונית היומנים ללוחות בקרה בהתאמה אישית, וכך לראות את רשומות היומן באותו הקשר של המדדים.

הווידג'ט של חלונית היומנים ו-Logs Explorer תומכים באותה שפת שאילתות, ובשניהם מוצגים רק רשומות היומן שיש לכם הרשאה לצפות בהן. התפקידים שלכם ב-IAM (הפלטפורמה לניהול זהויות והרשאות גישה) במשאבים שבהם מאוחסנות רשומות היומן קובעים אם אתם יכולים לצפות ברשומות היומן המאוחסנות.

הכלי Logs Explorer והווידג'ט של חלונית היומנים מוגדרים מראש לחיפוש רשומות ביומן במשאבים שמופיעים בהיקף היומן שמוגדר כברירת מחדל. אם אין גישה להיקף הזה, המערכת מחפשת את רשומות היומן שמקורן בפרויקט שבחרתם. כשבוחרים פרויקט, תוצאות החיפוש כוללות את רשומות היומן שמועברות לפרויקט על ידי sink בפרויקט אחר, ואז מאוחסנות בקטגוריה ביומן. אתם יכולים להגדיר באילו משאבים יתבצע חיפוש של רשומות ביומן. לדוגמה, אתם יכולים לחפש רשומות ביומן לפי תצוגת יומן.

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

תמונה של שני רשומות ביומן בווידג'ט של חלונית היומנים.

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

למידע כללי על Cloud Logging, אפשר לעיין במקורות המידע הבאים:

לפני שמתחילים

מבצעים את הפעולות הבאות Google Cloud בפרויקט שבו רוצים לראות יומנים בלוחות הבקרה המותאמים אישית:

הצגת רשומות ביומן בלוח בקרה

בקטע הזה מוסבר איך להוסיף ולהגדיר ווידג'ט של חלונית יומנים באמצעות מסוף Google Cloud . מידע על שימוש ב-Cloud Monitoring API זמין במאמר לוח בקרה עם ווידג'ט של LogsPanel.

אפשר להוסיף עד 100 ווידג'טים ללוח בקרה.

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

  1. במסוף Google Cloud , עוברים לדף  Dashboards:

    מעבר אל מרכזי בקרה

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. בסרגל הכלים של מסוף Google Cloud , בוחרים את הפרויקט הרלוונטי ב- Google Cloud . בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
  3. בוחרים מרכז בקרה או לוחצים על יצירת מרכז בקרה.
  4. בסרגל הכלים, לוחצים על  הוספת ווידג'ט.
  5. בתיבת הדו-שיח הוספת ווידג'ט, בוחרים באפשרות  יומנים.
  6. אופציונלי: כדי לעדכן את השם, מזינים את השם החדש בשדה שם הווידג'ט.

  7. הגדרת המשאבים שבהם יתבצע חיפוש של רשומות ביומן:

    • כדי לחפש לפי פרויקט, מגדירים את הערך Scope by ל-Project, מרחיבים את הערך Projects ומשלימים את תיבת הדו-שיח.

      בתפריט Projects מוצגים כל הפרויקטים בהיקף המדדים הנוכחי. Google Cloud אם באחת מהאפשרויות בתפריט מופיע הטקסט 'אין לך הרשאה ברמת הפרויקט להצגת היומנים בפרויקט הזה', סימן שאין לכם את ההרשאות שנדרשות כדי להציג את רשומות היומן שזמינות בפרויקט הזה. Google Cloud

      רשומות היומן שמוצגות כוללות רשומות שמקורן בפרויקטGoogle Cloud ורשומות שמועברות לפרויקטGoogle Cloud על ידי יעד בפרויקט אחר.

    • כדי לחפש רשומות ביומן לפי תצוגות יומן בקטגוריות ביומן, מגדירים את הערך היקף לפי לאחסון, מרחיבים את הערך תצוגות אחסון ומשלימים את תיבת הדו-שיח.

      בתפריט Storage views מופיעות תצוגות של יומנים בקטגוריות של יומנים בפרויקט Google Cloud שנבחר.

      כדי לבחור תצוגות של יומנים במאגרי יומנים בפרויקטים אחרים של Google Cloud , בתפריט לוחצים על ייבוא פרויקט, בוחרים פרויקט ואז בוחרים תצוגה אחת או יותר של יומנים. אפשר לייבא רק פרויקטים שנכללים בהיקף המדדים הנוכחי.

    • כדי לחפש את המשאבים שנכללים בהיקף היומנים, שיכול לכלול פרויקטים ותצוגות יומנים, מגדירים את הערך Scope by ל-Logs Scope, ואז מרחיבים את הערך Log Scopes ובוחרים היקף יומנים.

  8. אופציונלי: כדי להגביל את היומנים שיוצגו בווידג'ט של לוח היומנים, מזינים שאילתה בשדה Query Editor. אם השבתתם את ההרצה האוטומטית של שאילתות, לוחצים על Run query. מבוא קצר לשאילתות זמין במאמר דוגמאות לשאילתות.

  9. אופציונלי: מחילים משתנים על הווידג'ט של חלונית היומנים.

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

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

  11. כדי לשמור את מרכז הבקרה ששיניתם, בסרגל הכלים לוחצים על שמירה.

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

דוגמאות לשאילתות

כדי לאכלס את השדה Query Editor, אפשר להזין טקסט בשדה או לבחור אפשרויות מהתפריטים. בשדה Query Editor נעשה שימוש באותה שפת שאילתות כמו ב-Logs Explorer. מידע לפתרון בעיות זמין במאמר בעיות בתחביר.

בתפריטים חומרה ושם היומן אפשר לבחור כמה אפשרויות. הדוגמה הבאה מציגה משפט שאילתה שתואם לכמה רמות חומרה:

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

בתפריט Resource אפשר לסנן לפי משאב. אפשר לבחור סוג משאב, כמו Audited Resource, או לנווט בין החלונות כדי לבחור שיטה ספציפית.

לדוגמה, כדי להוסיף שאילתה למשאב שנבדק:

  1. מרחיבים את התפריט משאב.
  2. מחפשים את האפשרות Audited Resource (משאב שנבדק) ולוחצים עליה.

  3. לוחצים על אישור.

    הפעולות האלה מוסיפות את הסעיף הבא לשדה עורך השאילתות:

    resource.type="audited_resource"

באופן דומה, כדי להוסיף שאילתה ליומני ביקורת של פונקציות Cloud Run:

  1. מרחיבים את התפריט משאב.
  2. מחפשים את האפשרות Audited Resource (משאב שנבדק) ולוחצים עליה.
  3. בתפריט השירותים, בוחרים באפשרות Cloud Functions.

  4. לוחצים על אישור.

    הפעולות האלה מוסיפות את הסעיף הבא לשדה עורך השאילתות:

    resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"

סינון הרשומות ביומן

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

  • בורר הזמן בלוח הבקרה: הווידג'ט של חלונית היומנים מאחזר רק רשומות ביומן שנכתבו במרווח הזמן שצוין בשדה הזה.

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

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

  • שאילתה בווידג'ט של חלונית היומנים: בווידג'ט של חלונית היומנים מוצגות רק רשומות היומן שתואמות לשאילתה. אם לא מציינים שאילתה, מוצגים כל היומנים במרווח הזמן שנבחר. אם מציינים שאילתה, בווידג'ט של חלונית היומנים מוצג סמל הצגת השאילתה, שבו מוצגת השאילתה הנוכחית כהסבר קצר.

    כדי לשנות את השאילתה, עורכים את הווידג'ט של חלונית היומנים.

  • Google Cloud הצגה בווידג'ט של חלונית היומנים: כדי לשנות את ההגדרה הזו, צריך לערוך את הווידג'ט של חלונית היומנים.

  • מסנני מרכז בקרה: אם יש מסנני מרכז בקרה, הגדרת המסנן חלה על השאילתה של הווידג'ט בחלונית היומנים. לדוגמה, אם מוסיפים את מסנן לוח הבקרה cluster_name: mycluster, השאילתה מתעדכנת וכוללת את resource.labels."cluster_name"="mycluster". למידע נוסף על המסננים של לוח הבקרה, ראו הוספת מסננים זמניים והוספת מסננים קבועים.

בהמשך הקטע הזה מופיע מידע נוסף על סינון הרשומות ביומן.

דוגמה: סינון רשומות ביומן לפי תאריך

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

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

  • בוחרים טווח תאריכים באמצעות בורר טווח התאריכים.
  • מזינים משפט timestamp בשדה Query Editor בחלונית ההגדרות, ואז בוחרים באפשרות Apply filter.

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

דוגמה: סינון רשומות ביומן לפי חומרה

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

  • כדי להחיל מסנן זמני, בוחרים ערך בתפריט חומרה בווידג'ט של חלונית היומנים. בתפריט הזה מצוין רף חומרה מינימלי. לדוגמה, אם הערך הוא Warning, יאוחזרו רשומות ביומן עם רמת חומרה Error, אבל לא יאוחזרו רשומות ביומן עם רמת חומרה Notice. כברירת מחדל, הערך של השדה הזה מוגדר ל-Default, שכולל את כל רשומות היומן.

    ההגדרה של התפריט רמת החומרה נמחקת כשעוברים מלוח הבקרה.

  • כדי להחיל מסנן קבוע, מזינים פסקה של severity בשדה Query Editor בחלונית ההגדרות, ואז בוחרים באפשרות Apply filter.

דוגמה: סינון רשומות ביומן לפי מחרוזת או ביטוי

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

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

    אם מוסיפים כמה מסננים, מוצגים רק יומנים שתואמים לכל המסננים, כי המערכת מוסיפה AND באופן מרומז בין מסננים סמוכים. אבל אפשר להוסיף באופן מפורש את האופרטור OR:

    • לדוגמה, כשמוסיפים את המסננים Get ו-Compute, מוצגים רשומות ביומן שמכילות את שתי המילים.

    • לדוגמה, אם מוסיפים את המסננים Get, OR ו-Compute, מוצגים רשומות ביומן שמכילות את Get או Compute.

    הערך של השדה Filter לא נשמר.

  • כדי להחיל מסנן קבוע, משנים את השאילתה שמאוחסנת בשדה Query Editor ואז בוחרים באפשרות Apply filter. מידע על תחביר השאילתות זמין במאמר בנושא שפת השאילתות של רישום ביומן.

    לדוגמה, כדי להציג רק את רשומות היומן עם השדה MESSAGE שהערך שלו מכיל את המחרוזת lamp, מוסיפים את הסעיף jsonPayload.MESSAGE:"lamp" לשדה Query Editor.

צפייה ברשומות יומן ב-Logs Explorer

בווידג'טים של חלונית היומנים מוצגים שדות מרכזיים של רשומות ביומן, ולא הרשומה המלאה. כדי לבדוק את כל השדות של רשומה ביומן:

  1. בווידג'ט של חלונית היומנים, בוחרים באפשרות View in Logs Explorer (הצגה בכלי Logs Explorer).

  2. בתיבת הדו-שיח, בוחרים את הפרויקט שבו רוצים לפתוח את Logs Explorer. Google Cloud

    Logs Explorer נפתח בכרטיסייה חדשה בדפדפן, והמסננים שבחרתם בווידג'ט של חלונית היומנים מוחלים באופן אוטומטי.

  3. בוחרים את רשומת היומן שרוצים לראות.

הצגת תרשימים שנוצרו משאילתה ב-Log Analytics

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

בנוסף לשימוש בדף Log Analytics כדי להגדיר ולשמור תרשימים בלוח בקרה, אפשר לשמור תרשים של Log Analytics ישירות ב-Monitoring באופן הבא:

  1. במסוף Google Cloud , עוברים לדף  Dashboards:

    מעבר אל מרכזי בקרה

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. בסרגל הכלים של מסוף Google Cloud , בוחרים את הפרויקט הרלוונטי ב- Google Cloud . בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
  3. בוחרים מרכז בקרה או לוחצים על יצירת מרכז בקרה.
  4. בסרגל הכלים, לוחצים על  הוספת ווידג'ט.
  5. בתיבת הדו-שיח הוספת ווידג'ט, עוברים לקטע נתונים ובוחרים באפשרות Observability Analytics.

  6. בתיבת הדו-שיח הגדרת הווידג'ט, מגדירים את הנתונים שיוצגו ולוחצים על הפעלת השאילתה.

    כדי לבחור את הנתונים שיוצגו, אפשר ליצור שאילתת SQL או לבחור שאילתה שמורה או שאילתה מהזמן האחרון. תצוגות היומן ותצוגות הניתוח שאפשר להריץ עליהן שאילתות מפורטות בקטע Views & Schema. לחיצה על מקור נתונים מציגה רשימה של שדות עבור מקור הנתונים הזה מתחת לכותרת סכמה.

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

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

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

    • מדד: אפשר לבחור כמה מדדים בחלונית תצוגת תרשים. כשבוחרים מדד, צריך לבחור גם את פונקציית הצבירה שתתבצע על הערכים המקובצים שלו, כמו count,‏ sum,‏ average ו-percentile-99. לדוגמה, הפונקציה count-distinct מחזירה את מספר הערכים הייחודיים בעמודה נתונה.

    • פירוט: כדי לפצל סדרת נתונים אחת לכמה סדרות נתונים על סמך עמודה אחרת, מוסיפים פירוט.

    מידע נוסף על התאמה אישית של הגדרות התרשים זמין במאמר התאמה אישית של הגדרות התרשים.

  8. כדי לשמור את מרכז הבקרה ששיניתם, בסרגל הכלים לוחצים על שמירה.

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

הצגת שגיאות בלוח בקרה

בקטע הזה מוסבר איך להוסיף ולהגדיר חלונית לדיווח על שגיאות באמצעות מסוף Google Cloud . במאמר לוח בקרה עם ווידג'ט ErrorReportingPanel מוסבר איך מוסיפים ללוח בקרה חלונית של דיווח שגיאות באמצעות Cloud Monitoring API.

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

  1. במסוף Google Cloud , עוברים לדף  Dashboards:

    מעבר אל מרכזי בקרה

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Monitoring.

  2. בסרגל הכלים של מסוף Google Cloud , בוחרים את הפרויקט הרלוונטי ב- Google Cloud . בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
  3. בוחרים מרכז בקרה או לוחצים על יצירת מרכז בקרה.
  4. בסרגל הכלים, לוחצים על  הוספת ווידג'ט.
  5. בתיבת הדו-שיח הוספת ווידג'ט, עוברים לקטע Visualization ובוחרים באפשרות Error Reporting panel.
  6. בוחרים את הפרויקט שקבוצות השגיאות שלו מוצגות, מרחיבים את Projects ואז בוחרים באפשרות הרצויה.
  7. אופציונלי: מעדכנים את השם.

  8. אופציונלי: כדי להגביל את המשאבים שמוצגות לגביהם שגיאות:

    1. מרחיבים את כל המשאבים ובוחרים משאב.

    2. אחרי שבוחרים משאב, אפשר ללחוץ על Apply או להשתמש בתפריטים הנוספים כדי לצמצם את קריטריוני הסינון:

      • כדי להציג שגיאות במשאבי App Engine, בוחרים באפשרות GAE Services ולוחצים על Apply.

      • כדי להציג שגיאות בשירות ספציפי של App Engine, בוחרים באפשרות GAE Services, בוחרים את השירות ואז לוחצים על Apply.

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

    בדוגמה הבאה מוצגת חלונית דיווח שגיאות:

    דוגמה לחלונית ההגדרות של לוח דיווח השגיאות.

  10. כדי לשמור את מרכז הבקרה ששיניתם, בסרגל הכלים לוחצים על שמירה.

פתרון בעיות

המאמרים הבאים