צפייה ביומנים וניתוח שלהם

במאמר הזה מוסבר על Logs Explorer במסוףGoogle Cloud . בעזרת הכלי הזה אפשר לאחזר, להציג ולנתח רשומות ביומן שמאוחסנות בקטגוריות של יומנים. צפייה ברשומות יומן בודדות וברצף של רשומות יומן וניתוח שלהן יכולים לעזור לכם לפתור בעיות ולשפר את יכולת הצפייה. אפשר גם לקרוא את נתוני היומנים באמצעות Logging API ו-Google Cloud CLI.

כדי לבצע פעולות צבירה על הרשומות ביומן, כמו ספירת מספר הרשומות ביומן שמכילות דפוס ספציפי, משדרגים את קטגוריית היומנים לשימוש ב-Log Analytics, ואז מריצים שאילתות מהדף Log Analytics במסוף Google Cloud . אתם יכולים להמשיך להשתמש ב-Logs Explorer כדי להציג יומנים במאגרי יומנים ששודרגו לשימוש ב-Log Analytics. מידע נוסף זמין במאמר סקירה כללית על Log Analytics.

בהמשך המסמך מוסבר איך משתמשים בכלי Logs Explorer.

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

כדי לקבל את ההרשאות שדרושות לשימוש ב-Logs Explorer כדי להציג רשומות ביומן, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

כדי להציג את רשומות היומן בדלי _Required ואת אלה בתצוגה _Default בדלי _Default, או כדי לבחור אוסף תצוגות יומן (log scope): מציג היומנים (roles/logging.viewer) בפרויקט, בתיקייה או בארגון.
כדי לראות את כל הרשומות ביומן בדלי _Required ו-_Default: Private Logs Viewer (roles/logging.privateLogViewer) בפרויקט, בתיקייה או בארגון.
כדי לראות שדות מוגבלים LogEntry בקטגוריה ביומן: Log Field Accessor (roles/logging.fieldAccessor) בפרויקט, בתיקייה או בארגון שבהם מאוחסנת קטגוריית היומן. מידע על הגבלת הגישה לשדות LogEntry מופיע במאמר בנושא הגדרת גישה ברמת השדה.
כדי להציג ולהוריד רשומות ביומן שמאוחסנות בתצוגת יומן בקטגוריית יומנים: Logs View Accessor (roles/logging.viewAccessor) בפרויקט, בתיקייה או בארגון שמכילים את קטגוריית היומנים. במאמר שליטה בגישה לתצוגת יומן מוסבר איך לקבל גישה רק לתצוגת יומן ספציפית.

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

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

קדימה, מתחילים

כדי להתחיל להשתמש ב-Logs Explorer:

במסוף Google Cloud , נכנסים לדף Logs Explorer:
כניסה אל Logs Explorer

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

הרשומות ביומן שמוצגות בדף Logs Explorer תלויות בפרמטרים הבאים:
- המשאבים שחיפשתם בהם רשומות ביומן.
- הגדרת טווח הזמן.
- תפקידי ניהול הזהויות והרשאות הגישה (IAM) שלכם במשאבים שחיפשתם.
- השאילתה מסננת את תוצאות החיפוש. לדוגמה, הוספת השאילתה severity>=ERROR תגרום להצגת רשומות היומן רק עם רמת חומרה של ERROR לפחות.
כברירת מחדל, בדף Logs Explorer מתבצע חיפוש של רשומות ביומן במשאבים שמופיעים בהיקף היומן שמוגדר כברירת מחדל. כאשר אוסף תצוגות היומן (log scope) המוגדר כברירת מחדל אינו נגיש, הדף מחפש את רשומות היומן שמקורן בפרויקט, בתיקייה או בארגון שבחרתם. בפרויקטים, תוצאות החיפוש כוללות את הרשומות ביומן שמועברות לפרויקט על ידי sink בפרויקט אחר, ואז מאוחסנות בקטגוריה ביומן.

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

הממשק של Logs Explorer

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

סרגל הכלים הראשי
חלונית Query
חלונית Fields
ציר הזמן
חלונית תוצאות השאילתה

ממשק המשתמש של Logs Explorer.

סרגל הכלים הראשי ב-Logs Explorer

בסרגל הכלים הראשי אפשר לבצע את הפעולות הבאות:

ספריית שאילתות: אפשר לראות שאילתות שמורות, שאילתות מהזמן האחרון והצעות לשאילתות. מידע נוסף זמין במאמר בנושא שמירה ושיתוף של שאילתות.
שיתוף קישור: יצירת כתובת URL מקוצרת של השאילתה והעתקתה ללוח, כדי שיהיה קל יותר לשתף שאילתה. כתובת ה-URL שהועתקה כוללת את טווח הזמן המוחלט המתאים שמיוצג על ידי טווח הזמן של השאילתה. לדוגמה: 7:49:37 PM - 8:49:37 PM.
העדפות: אפשר לשנות את התצוגה של הדף Logs Explorer ולהתאים אישית את הפורמט של תוצאות השאילתות. למידע נוסף, ראו הגדרת העדפות לצפייה בנתוני יומן.
בורר טווח הזמן: מציינים טווח זמן של רשומות היומן שרוצים לראות. מידע נוסף זמין במאמר בנושא שימוש בבורר טווחי הזמן.
יומני נתונים בזמן אמת: אפשר לראות את הרשומות ביומן בזמן שהשירות Logging מאחסן אותן בדלי יומנים. מידע נוסף זמין במאמר בנושא יומני סטרימינג.
מידע: קישורים למסמכי תיעוד ולנושאים רלוונטיים.

הצגת שאילתות אחרונות, שמורות ומוצעות

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

בכרטיסייה Query library אפשר לראות את הפרטים הבאים:

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

הגדרת העדפות לצפייה בנתוני יומן

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

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

הגדרת העמודה Time

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

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

תאריך, שעה ואזור זמן
תאריך ושעה (ברירת מחדל)
רק שעה

זיהוי דפוסים ביומנים באמצעות שדות סיכום

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

בכלי Logs Explorer יש שדות סיכום שמוגדרים כברירת מחדל ושדות סיכום מותאמים אישית. שדות הסיכום שמוגדרים כברירת מחדל תלויים בתוצאות השאילתה הנוכחיות, ובשדות סיכום מותאמים אישית אפשר לבחור כל שדה ב-LogEntry.

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

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

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

שדות הסיכום עודכנו בתוצאות השאילתה.

צפייה ביומנים לפי טווח זמן

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

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

יומני סטרימינג

אפשר להזרים יומנים כש-Logging מאחסן אותם בדלי יומנים, או להוסיף שאילתה כדי להזרים רק את היומנים שתואמים לשאילתה.

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

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

חלונית שאילתה

כדי ליצור שאילתה ב-Logs Explorer, משתמשים בחלונית השאילתות. בחלונית השאילתה, אפשר ליצור ולשפר שאילתות באמצעות התכונות הבאות:

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

הערה: כששאילתה מכילה כמה הצהרות, אפשר לציין איך ההצהרות האלה מצורפות או להסתמך על Cloud Logging שמוסיף באופן מרומז את ההגבלה המצטרפת, AND, בין ההצהרות. לדוגמה, נניח שתיבת דו-שיח של שאילתה או מסנן מכילה שתי הצהרות, resource.type = "gce_instance" ו-severity >= "ERROR". השאילתה בפועל היא resource.type = "gce_instance" AND severity >= "ERROR". ‫Cloud Logging תומך בהגבלות דיסג'נקטיביות, OR, ובהגבלות קוניונקטיביות, AND. כשמשתמשים בהצהרות OR, מומלץ לקבץ את הסעיפים באמצעות סוגריים. מידע נוסף זמין במסמכי התיעוד בנושא שפת השאילתות של Logging.

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

בחירת המשאבים שבהם יתבצע חיפוש של רשומות ביומן

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

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

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

בסרגל הכלים בחלונית Query מוצגים משאבי החיפוש של רשומות היומן:

‫ Project logs ו- _Default: יוחזרו רשומות ביומן שמקורן בפרויקט, בתיקייה או בארגון שנבחרו. בפרויקטים, רשומות היומן האלה כוללות רשומות שמועברות לפרויקט על ידי יעד בפרויקט אחר.
N log view: Log entries included in the N log views are returned. אפשר להרחיב את התפריט כדי לראות את תצוגות היומן.
‫ my-custom-scope, כאשר my-custom-scope הוא השם של אוסף תצוגות יומן מותאם אישית: אם אוסף תצוגות יומן מפרט תצוגות יומן, יוחזרו רשומות ביומן בתצוגות היומן האלה. אם אוסף תצוגות יומן (log scope) מפרט משאבים אחרים, כמו פרויקטים, יוחזרו רשומות ביומן שמקורן במשאבים האלה. למידע נוסף, ראו יצירה וניהול של היקפי יומנים.

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

עוברים לסרגל הכלים של החלונית Query (שאילתה). בסרגל הכלים הזה מוצג תפריט עם אחת מהתוויות הבאות:
- יומני פרויקט
- תצוגת יומן N
- my-custom-scope
בוחרים בתפריט.
בתפריט הנפתח צמצום ההיקף, בוחרים את מיקום האחסון ומשלימים את תיבת הדו-שיח.

המידע הבא עשוי לעזור לכם להשלים את תיבת הדו-שיח:
- כשרוצים להציג רשומות ביומן שמועברות על ידי מאגר נתונים משולב, בוחרים באפשרות Log view כמקום האחסון. לאחר מכן, חשוב לבחור את כל תצוגות היומן שבהן מאוחסנות רשומות היומן שרוצים לראות.
- בתפריט של תצוגת היומן של תיקיות וארגונים מופיעות כל תצוגות היומן שמאחסנות רשומות ביומן שמקורן במשאבים האלה.
- בפרויקטים, בתפריט של תצוגת היומן מופיעות תצוגות היומן בקטגוריות של יומנים שמאוחסנות בפרויקט שנבחר.
- כדי לשנות את התפריט של תצוגות היומן כך שיכלול תצוגות יומן בדלי יומנים שמאוחסנים בפרויקט ספציפי, לוחצים על ייבוא פרויקט ואז בוחרים את הפרויקט.
- כדי להגדיר את היקף היומן, בוחרים באפשרות Log scope ולוחצים על Manage scopes.

החלונית Fields (שדות)

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

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

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

בקטע מטא-נתונים של המערכת, המאפיינים הבאים תמיד זמינים:

סוג המשאב

אם אתם משתמשים ב-BindPlane כדי לכתוב יומנים מקומיים ויומנים של ענן היברידי, בוחרים את סוג המשאב Generic Node.
חוּמרה

אם רוצים שהשאילתה תסנן לפי כמה רמות חומרה, צריך להשתמש בתפריט חומרה.

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

המאפיין שירות מוצג בתרחישים הבאים:
- יש לכם נתוני יומן שסוג המשאב שלהם הוא Kubernetes Container ולא סיננתם את היומנים לפי סוג המשאב. הערכים בתווית labels.k8s-pod/app תורמים לערכים במאפיין Service.
  
  לדוגמה, אם רשומה ביומן שדומה לרשומה הבאה מוצגת כתוצאה של השאילתה, אז תפריט השירות כולל את השירות שנקרא myservice:
```
{
...
labels: {
    compute.googleapis.com/resource_name: "mycluster1"
    k8s-pod/app: "myservice"
    k8s-pod/pod-template-hash: "5ffcd94fdd"
 }
 logName: "projects/my-project/logs/stdout"
 resource: {
    labels: {6}
    type: "k8s_container"
 }
 ...
}
```
- יש לכם נתוני יומן עם תוויות של שירות או עומס עבודה של App Hub. התוויות האלה הן בפורמט apphub.workload.id או apphub.service.id. ברשומה ביומן, הם מוצגים בapphub entry. לדוגמה, רשומה ביומן יכולה להכיל משהו כמו הדברים הבאים:
```
apphub: {
 application: {3}
 workload: {
    criticalityType: "MEDIUM"
    environmentType: "STAGING"
    id: "my-workload-id"
 }
}
```
- מסננים את נתוני היומן לפי סוג המשאב של משאב שנבדק. הערכים בתווית resource.labels.service תורמים לערכים במאפיין Service.
- יש לכם נתוני יומן שמכילים את התווית resource.labels.namespace_name או את התווית labels.service.name.
המאפיין Application מוצג כשנתוני היומן מכילים תווית של מזהה אפליקציה ב-App Hub, שהפורמט שלה הוא apphub.application.id. ברשומת היומן, התווית הזו מוצגת ברשומה apphub:
```
apphub: {
  application: {
     container: "projects/my-project"
     id: "my-app"
     location: "my-app-location"
  }
  workload: {3}
}
```

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

צמצום השאילתה

כדי לדייק את השאילתה, בוחרים ערך בחלונית Fields (שדות). לדוגמה, אם בוחרים באפשרות שגיאה בכותרת רמת חומרה, חלונית השאילתה מתעדכנת וכוללת את severity=ERROR.

כדי להסיר את הבחירה, לוחצים על הלחצן ניקוי.

הוספת שדות לחלונית Fields

אפשר להוסיף צמדי מפתח/ערך מסוימים של LogEntry לחלונית Logs field מתוך רשומות היומן שמאוכלסות בחלונית Query results. לדוגמה, אם אתם מסננים לעיתים קרובות לפי הערך של השדה jsonPayload.message, כדאי להוסיף אותו לחלונית Fields (שדות).

כדי להוסיף שדה לחלונית Fields:

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

השדה המותאם אישית מופיע בחלונית Fields כרשימה של צמדי מפתח-ערך.

אם החלונית הצמדה לשדות לא מופיעה, אי אפשר להוסיף את השדה לחלונית. לדוגמה, אי אפשר להוסיף את השדה insertID לחלונית Fields.

כדי להסיר שדה מותאם אישית מהחלונית שדות, לוחצים על הסרה לצד השדה.

חשוב לזכור שאי אפשר להוסיף את סוגי השדות הבאים לחלונית Fields:

שדות שקשורים לזמן, לדוגמה receiveTimestamp ו-protoPayload.startTime.
שדות עם עוצמה גבוהה (high cardinality), לדוגמה, insertId ו-protoPayload.latency.
שדות עם אינדקסים של מערכים בנתיב שלהם, לדוגמה, protoPayload.authorizationInfo[0].resource.

ציר הזמן

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

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

תכונות של ציר הזמן

עמודות ציר הזמן: כל עמודה בציר הזמן מייצגת טווח זמן. כל עמודה מכילה פירוט של שלוש רמות חומרה של יומן שנרשמו בטווח הזמן של העמודה. הצבעים מייצגים את רמות החומרה הבאות של היומן:
- כחול: רמות חומרה נמוכות כמו Default,‏ Debug,‏ Info ו-Notice.
- צהוב: חומרת הבעיה בינונית, למשל אזהרה.
- אדום: חומרת הבעיה גבוהה, למשל שגיאה, קריטית, התראה ומקרה חירום.
בכל עמודה בציר הזמן יש תפריט עם אפשרויות לניתוח היומנים.
אמצעי בקרה של הזמן: מאפשרים לכם לשנות את טווח הזמן של היומנים שמוצגים בחלונית Query results. פרטים על האפשרויות האלה מופיעים במאמר ניתוח יומנים באמצעות אמצעי בקרה של זמן.
טווח זמן: מוצג טווח הזמן של היומנים, שמיוצג על ידי עמודות היסטוגרמה. ציר הזמן עוזר לכם להתמצא ביומנים שאתם צופים בהם בטווח הזמן הרחב יותר של השאילתה.

ניתוח יומנים באמצעות אמצעי בקרה של זמן

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

שינוי הגדרות הזמן

ציר הזמן כולל אמצעי בקרה שמאפשרים לכם לשנות את הנתונים שמוצגים בכלי Logs Explorer:

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

השינויים בציר הזמן מוגבלים לטווח שבין השעה הנוכחית ('עכשיו') לבין 30 ימים אחורה.

גלילה או שינוי מרחק התצוגה לזמן

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

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

הנתונים ביומנים שמוצגים בחלונית Query results משתנים בהתאם לטווח הזמן שמוצג בסרגל ציר הזמן שנבחר.

השאילתה לא מופעלת, אבל יכול להיות שיתבצע טעינה מחדש חלקית של הנתונים כדי לוודא שיוצגו לכם יומנים בחלונית Query results שתואמים לטווח הזמן של ציר הזמן שנבחר.
כתובת ה-URL של המסוף מתעדכנת וכוללת את timestamp של היומן האחרון שתועד בטווח הזמן של העמודה שנבחרה בציר הזמן.

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

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

אפשרות נוספת היא ללחוץ על פס בציר הזמן, פעולה ששווה לבחירה באפשרות מעבר לזמן.

התכונה Zoom to time דומה ל-Scroll to time, אבל היא מריצה שאילתה על נתוני היומנים על סמך טווח הזמן שמוצג בבר בציר הזמן שנבחר. כשבוחרים בתכונה התקרבות לנקודת זמן, קורה הדבר הבא:

הנתונים ביומנים שמוצגים בחלונית Query results נטענים מחדש ומוצגים רק עבור טווח הזמן שמוגדר בבר של ציר הזמן שנבחר.
כתובת ה-URL של המסוף מתעדכנת וכוללת את timestamp של היומן האחרון שתועד בטווח הזמן של העמודה שנבחרה בציר הזמן.
ציר הזמן משתנה כך שיוצגו בו רק יומנים עם ערך timestamp שנמצא בטווח הזמן של סרגל ציר הזמן שנבחר.
הנתונים בחלונית Fields משתנים בהתאם לטווח הזמן שמוצג בפס ציר הזמן שנבחר.

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

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

הצגת תוצאות השאילתות

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

סימון מונחי חיפוש, מעקב אחרי היומנים והורדה שלהם

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

‫ הדגשה בתוצאות: מזינים טקסט להדגשה בתוצאות השאילתה.

יצירת מדד: הגדרה של מדד מבוסס-יומנים.

יצירת sink ביומן: יצירת sink ביומן שאוכלס אוטומטית במסנן ההכללה של ה-sink עם ביטוי השאילתה הנוכחי.

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

הורדה: הורדת היומנים בפורמט CSV או JSON. מידע נוסף זמין במאמר בנושא הורדת יומנים.

הורדת היומנים

כדי לקבל את ההרשאות שנדרשות להורדת יומנים, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד Logs View Accessor (roles/logging.viewAccessor) בפרויקט. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד הזה מכיל את ההרשאה logging.logEntries.download. אפשר גם לתת תפקיד שכולל את ההרשאה logging.logEntries.list, שמאפשרת לחשבון משתמש לצפות ביומנים ולהוריד אותם.

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

כדי להוריד את היומנים:

בתפריט פעולות בחלונית תוצאות השאילתה, לוחצים על הורדה.
בתיבת הדו-שיח הורדת יומנים, בוחרים בפורמט CSV או JSON ולוחצים על הורדה.
בוחרים מה לעשות עם נתוני היומן. אלה האפשרויות שעומדות לרשותכם:
- מורידים את הנתונים למחשב.
- הורדת הנתונים ל-Google Drive.
- הנתונים יוצגו בכרטיסייה חדשה.
כששומרים קובץ CSV ובוחרים ב-Google Drive, אפשר לפתוח את הקובץ ב-Google Sheets.

מידע על פתרון בעיות זמין במאמר הורדת היומנים נכשלת.

ניתוח התוצאות באמצעות Log Analytics

אפשר לצבור, לנתח ולשרטט את נתוני היומן באמצעות שאילתות SQL בדף Log Analytics, אם הפרויקט מכיל מאגרי יומנים ששודרגו לשימוש ב-Log Analytics. כדי לעבור לדף Log Analytics מתוך Logs Explorer, בסרגל הכלים Query results, לוחצים על Analyze results.

הלחצן ניתוח תוצאות מוצג רק אם קטגוריה ביומן שמכילה את תצוגת היומן שאתם שולחים לה שאילתה שודרגה לשימוש ב-Log Analytics. לדוגמה, אם בסרגל הכלים מוצג N log view, הלחצן Analyze results מוצג אם לפחות אחת מקטגוריות היומנים שנבחרו שודרגה לשימוש ב-Log Analytics. מידע נוסף זמין במאמר שדרוג של קטגוריה ביומן לשימוש ב-Log Analytics.

כשלוחצים על ניתוח התוצאות, מתרחשים הדברים הבאים:

יכול להיות שטווחי הזמן ב-Logs Explorer יותאמו באופן אוטומטי כדי שיהיו נתוני יומן משמעותיים בדף Log Analytics.
הדף Log Analytics נפתח בכרטיסייה חדשה והשאילתה הנוכחית בשפת השאילתות של Logging מתורגמת אוטומטית לשאילתת SQL.
המשאב שנבחר בכלי לבחירת פרויקטים Google Cloud והגדרה בסרגל הכלים קובעים איך נוצרת פסקה FROMבשאילתת ה-SQL. המשאב שנבחר יכול להיות פרויקט, תיקייה או ארגון:
- אם בסרגל הכלים מוצגים Project logs או _Default, מתבצעת שאילתה בקטגוריות _Required ו-_Default של המשאב.
- אם בסרגל הכלים מוצג N log view, מתבצעת שאילתה לגבי תצוגות יומן בקטגוריות של יומנים בפרויקט הנוכחי. תצוגות של יומנים בדלי יומנים שאוחסנו על ידי משאבים שונים מוזנחות.
- אם בסרגל הכלים מוצג myscope, כאשר myscope הוא השם של אוסף תצוגות יומן (log scope) מותאם אישית, הכללים הקודמים חלים על המשאבים שמפורטים באוסף תצוגות היומן (log scope) שנבחר. לדוגמה, אם אוסף תצוגות יומן (log scope) מכיל תצוגות יומן, רק תצוגות היומן האלה בקטגוריות ביומן שאוחסנו על ידי המשאב יישאלו.
הערה: Log Analytics לא תומך בשאילתות שכוללות פרויקטים או אזורים שונים. אם מחפשים רשומות ביומן של משאבים בכמה פרויקטים או אזורים, יכול להיות שLog Analytics יציג רשומות שונות מאלה שמוצגות בדף Logs Explorer.

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

מידע על שימוש ב-SQL כדי לכתוב שאילתות זמין במאמר שליחת שאילתות וצפייה ביומנים ב-Log Analytics.

סיכום של רשומה ביומן באמצעות Gemini

כשבודקים בעיה, אפשר להשתמש ב-Gemini כדי ליצור סיכום של רשומת היומן. כדי ליצור סיכום של רשומה ביומן:

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

‫Cloud Logging שולח את הטקסט של הרשומה ביומן ל-Gemini Cloud Assist עם הנחיה לסכם את התוכן של הרשומה ביומן. ‫Gemini Cloud Assist משיב עם סיכום שנוצר בחלונית Gemini. הסיכום מבוסס רק על הטקסט של רשומת היומן, ללא הקשר נוסף.

למידע נוסף על סיכום רשומות ביומן באמצעות Gemini Cloud Assist, קראו את המאמר סיכום של רשומות ביומן בעזרת Gemini.

פתרון בעיה בעזרת Gemini

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

כדי ליצור חקירה:

בוחרים רשומה ביומן עם רמת חומרה של לפחות WARNING.
עוברים לסרגל הכלים של רשומת היומן ולוחצים על חקירה.

אתם יכולים ליצור חקירה כדי לקבוע את הסיבות האפשריות לבעיות ולהחיל פתרונות מומלצים של Gemini Cloud Assist כדי לפתור את הבעיות האלה. מידע נוסף על חקירות זמין במאמרים הבאים:

הצגת רשומות דומות ביומן

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

כדי להציג רשומות דומות ביומן:

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

השאילתה מתעדכנת עם שאילתה שדומה לשאילתה הבאה, ותוצאות השאילתה נטענות מחדש:
```
--Show similar entries
protoPayload.methodName="io.k8s.core.v1.configmaps.update"
--End of show similar entries
```

כדי לראות תצוגה מקדימה של רשומות דומות ביומן:

בוחרים רשומה ביומן ולוחצים על הרחבה.
מרחיבים את התפריט Similar entries (רשומות דומות) ובוחרים באפשרות Preview similar entries (תצוגה מקדימה של רשומות דומות).

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

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

אפשר להסתיר רשומות דומות ביומן, וכך להסיר יומנים מתוצאות השאילתה.

יש שתי דרכים להסתיר רשומות דומות ביומן:

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

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

הסתרת רשומות דומות: הלחצן הזה מוסיף פסקה לשאילתה וטוען מחדש את תוצאות השאילתה.

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

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

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

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

הצגה או הסתרה של רשומות ביומן שתואמות לשדה

אתם יכולים להציג או להסתיר רשומות ביומן שתואמות לשדה ברשומה ביומן, כדי להתמקד ברשומות שמכילות את אותו תוכן בשדה.

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

בוחרים רשומה ביומן ולוחצים על הרחבה.
לוחצים על ערך של שדה ברשומה ביומן, כמו compute.googleapis.com, שהוא serviceName.
בתפריט, בוחרים באפשרות הצגת רשומות תואמות או הסתרת רשומות תואמות.

השאילתה מתעדכנת עם שאילתה שמציגה או מסתירה רשומות דומות, והחלונית Query results נטענת מחדש עם תוצאות חדשות.

הצמדת רשומות ביומן

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

כדי להצמיד רשומה ביומן:

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

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

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

הצגת יומנים שתואמים למשאב של רשומה מוצמדת ביומן

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

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

לוחצים על החץ למטה לצד היומן המוצמד כדי להרחיב את תפריט ההצמדה.
בוחרים אפשרות מהתפריט של ההצמדה:
- כדי להריץ מחדש את השאילתה עם אותו resource.type כמו ביומן המוצמד, בוחרים באפשרות אותו resource.type.
  
  לדוגמה, נניח שצירפתם רשומה ביומן עם resource.type של k8s_node. אם בוחרים באפשרות Same resource.type, השאילתה מופעלת מחדש כדי להציג את כל רשומות היומן עם resource.type="k8s_node".
- כדי להריץ מחדש את השאילתה עם אותו resource.labels כמו ביומן המוצמד, בוחרים באפשרות Same resource.labels.
- כדי להריץ מחדש את השאילתה עם אותו trace כמו ביומן המוצמד, בוחרים באפשרות אותו מעקב.
- כדי לנקות את השאילתה ולהציג את כל הרשומות ביומן, לוחצים על הצגת הכל.

הצגת רשומה ביומן שהוצמדה בציר הזמן

אפשר להשתמש בציר הזמן כדי להדגיש רשומה ביומן שמוצמדת, לגלול אליה ולבדוק אותה לעומק.

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

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

צפייה בנתוני מעקב

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

תצוגה של רשומה ביומן שמכילה נתוני מעקב.

אם רשומה ביומן מכילה רק את השדה trace, יופיע רק סמל המעקב.

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

הצגת פרטי העקבות: הצגת הטווח הראשי והעקבות של הצאצאים, יחד עם פרטים על העקבות. כדי לראות פרטים נוספים על העקבות, לוחצים על View in Trace (הצגה ב-Trace) ועוברים אל Cloud Trace. מידע נוסף על התוכן בחלונית הפרטים זמין במאמר חיפוש של עקבות ובדיקה שלהן.

Show all logs for this trace: Refines and runs the query by adding the trace field set to the identifier of the trace associated with the log entry.
הצגת בקשות שעברו מעקב בלבד: השאילתה תעודכן ותופעל עם הוספת השדה traceSampled שמוגדר לערך True. מידע נוסף על דגימה זמין במאמר בנושא שיעור הדגימה.

הצגת נתוני המעקב

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

הצגת פרטי המעקב: פותחת חלונית פרטים של משאב GKE. מידע על חלונית הפרטים זמין במאמר הצגת פרטי משאבים.
View in Monitoring (הצגה ב-Monitoring): פותח דף Monitoring של המשאב.
הצגה ב-GKE או הצגה ב-Compute Engine: פותח את הדף פרטים של המשאב בממשק המשתמש של GKE או Compute Engine.

תצוגה של התפריט Logs Explorer למשאבי GKE.

העתקת קישור לרשומה ביומן

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

דוגמאות לשאילתות ב-Logs Explorer

דוגמאות לשאילתות באמצעות Logs Explorer Google Cloud לדוגמה, אפשר להריץ שאילתות שקשורות ל-Kubernetes כדי למצוא יומנים של Google Kubernetes Engine.

צפייה ביומנים של Compute Engine

בסוגים מסוימים של משאבי Compute Engine, כמו gce_instance ו-gce_network, שם המשאב מופיע עם מזהה המשאב כטקסט משני בכמה מקומות ב-Logs Explorer. לדוגמה, עבור סוג המשאב gce_instance, מוצג שם המכונה הווירטואלית לצד מזהה המכונה הווירטואלית. שמות המשאבים עוזרים לכם לזהות את מזהה המשאב הנכון, שעליו תוכלו לבנות שאילתות.

יכול להיות שתראו שמות של משאבים ב-Compute Engine במקומות הבאים:

תפריטי מסננים בחלוניתשאילתה: סוגי משאבים של Compute Engine מציגים את שמות המשאבים, עם מזהי המשאבים התואמים כטקסט משני.
שדות: בסוגי משאבים של Compute Engine מוצג שם המשאב ולא מזהה המשאב במאפייני השדה.
תוצאות השאילתה: ביומני מכונות וירטואליות (VM) של Compute Engine, השדה resource.labels מציג מטא-נתונים עם שם המשאב התואם.
שדות סיכום: ביומני מכונות וירטואליות (VM) של Compute Engine, הצ'יפ מציג את שם המשאב במקום את מזהה המשאב.

פתרון בעיות שקשורות לרישום ביומן

בקטע הזה מפורטות הוראות לפתרון בעיות נפוצות שמתעוררות כשמשתמשים בכלי Logs Explorer.

אם נתקלתם בבעיות כשניסיתם לצפות ביומנים ביעדי sink, תוכלו להיעזר במאמר פתרון בעיות שקשורות לניתוב ול-sinks.

ההורדה של היומנים נכשלת

אתם משתמשים ב-Logs Explorer ולוחצים על הורדה. הפקודה מתחילה אבל לא מסתיימת או מדווחת על שגיאה.

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

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

משנים את השאילתה כך שתשתמש בשדות שנוספו לאינדקס.

לא ניתן למצוא את יומני המסוף של מכונת VM

יכול להיות שהיומנים שנכתבו במסוף של מופע Compute Engine לא יהיו זמינים ב-Logs Explorer. כדי לראות את היומנים האלה:

נכנסים לדף VM instances במסוף Google Cloud :
כניסה לדף VM instances

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים את התוצאה עם כותרת המשנה Compute Engine.
בוחרים את המופע, ואז בוחרים באפשרות Serial port 1 (console) (יציאה טורית 1 (מסוף)) בקטע Logs (יומנים) בדף.

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

איך מוצאים את מזהה הפרויקט או הארגון Google Cloud

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

לא רואים רשומות ביומן

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

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

השאילתה שלי נכונה, אבל עדיין לא רואים רשומות ביומן

אי אפשר לראות רשומות ביומן שנוצרו לפני יותר זמן מתקופת השמירה של היומן. במאמר תקופות שמירה של יומנים מפורטות תקופות השמירה של היומנים שחלות.
בתקופות של עומס כבד, יכול להיות שיהיו עיכובים בשליחת היומנים אל Logging או בקבלה ובהצגה של היומנים.
ב-Logs Explorer לא מוצגים רשומות ביומן עם חותמות זמן עתידיות עד שהשעה הנוכחית תהיה זהה לחותמות הזמן האלה. זהו מצב לא רגיל, שנגרם כנראה בגלל הטיה בזמן באפליקציה ששולחת את היומנים.
היקף השאילתה היה גדול מדי, ולא ניתן היה להשלים אותה בפרק זמן סביר. יכול להיות שהשגיאה תופיע כ-deadline expired before operation could complete (תאריך היעד חלף לפני שהפעולה יכלה להסתיים). כדאי לנסות להפוך את השאילתה לספציפית יותר או לצמצם את טווח הזמן.

השאילתה מחזירה שגיאה

אם מריצים שאילתה על משאב בלי לציין קטגוריה, Cloud Logging משתמש בהיסטוריה של היעדים בפרויקט Google Cloud כדי לקבוע לאן יכול להיות שנכתבו רשומות עבור המשאב הזה. אם Cloud Logging מזהה יותר מ-200 מאגרי מידע שאולי נכתבו בהם רשומות, השאילתה נכשלת ומוצגת ההודעה Error: Invalid query.

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

טווח הזמן של תוצאות השאילתה לא תואם לשאילתה

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

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

פנייה לתמיכה

למידע על קבלת תמיכה, אפשר לעיין בדף התמיכה של Google Cloud Observability.