איך בודקים את התוצאות של מעקב סינתטי

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

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

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

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

צפייה בהיסטוריית הביצוע של בדיקה סינתטית

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

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

    כניסה אל Synthetic monitoring

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

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

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

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

הצגת יומנים ועקבות של ביצוע

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

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

  • לראות את הקוד הנוכחי.

  • ניגשים לפונקציית Cloud Run.

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

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

צפייה בנתוני היומן

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

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

רשומת היומן מוצגת בפורמט JSON. אם אתם מעדיפים לראות את היומנים באמצעות Logs Explorer, אתם יכולים ללחוץ על Open in Logs Explorer (פתיחה ב-Logs Explorer). כלי Logs Explorer ייפתח ושאילתה תוגדר מראש.

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

נתוני Trace נאספים כשפונקציית Cloud Run מופעלת. כדי לראות את נתוני העקבות, משתמשים במסוף או ב-Cloud Trace API. Google Cloud

המסוף

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

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

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

  • צפייה בנתוני המעקב ב-Cloud Trace:

    1. נכנסים לדף Trace explorer במסוף Google Cloud :

      כניסה אל Trace explorer

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

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

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

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

API

מומלץ להשתמש במסוף כדי להציג את נתוני המעקב. Google Cloud עם זאת, אם אתם רוצים להשתמש ב-Cloud Trace API, אתם יכולים להשתמש בשיטה traces.list כדי לראות את רשימת העקבות הזמינים, ואז להשתמש בשיטה traces.get כדי לקבל את הפרטים של עקבה.

צפייה ביומנים ובמדדים של פונקציית Cloud Run

היומנים והמדדים מספקים מידע על הפעולות שהפונקציה של Cloud Run מבצעת. לדוגמה, יומנים שמכילים שדה בשם userAgent עם ערך של GoogleStackdriverMonitoring-UptimeChecks, מציינים שהשירות שלכם קיבל בקשה משירות בדיקת הזמינות.

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

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

המסוף

כדי לראות את היומנים של פונקציית Cloud Run:

  1. בחלונית עם השם של הבדיקה הסינתטית, לוחצים על השם של פונקציית Cloud Run.
  2. בדף Function details, בוחרים בכרטיסייה Logs.

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

API

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

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

בבדיקות סינתטיות, המדדים נאספים על ידי Cloud Monitoring וגם על ידי פונקציות Cloud Run:

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

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

המסוף

כדי לראות את המדדים של פונקציית Cloud Run:

  1. בחלונית עם השם של הבדיקה הסינתטית, לוחצים על השם של פונקציית Cloud Run.
  2. בדף Function details, בוחרים בכרטיסייה Metrics.

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

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

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

  • הורדת התרשים כקובץ PNG או CSV
  • שמירת התרשים בלוח בקרה בהתאמה אישית
  • פתיחת Metrics Explorer
  • הרחבה או כיווץ של מקרא התרשים
  • איפוס הזום