אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
לוח הבקרה חקירה מאפשר לכם לראות טבלאות ציר של מדדים ומאפיינים עבור כל התנועה ב-API, ולהשוות פעילות יחסית בין מדדים כדי לחקור בעיות ולאבחן אותן מהר יותר. בלוח הבקרה אפשר לגשת לנתונים מ-30 הימים האחרונים.
בממשק המשתמש של Edge, בוחרים באפשרות Analyze > API Monitoring > Investigate (ניתוח > מעקב אחרי API > חקירה) כדי לפתוח את לוח הבקרה Investigate. מרכז הבקרה מחולק לשני אזורים עיקריים:
- קוד סטטוס מאפשר לכם לבדוק מדדים של קודי סטטוס לשרתי proxy של API ולשירותי יעד.
- זמן האחזור מאפשר לכם לבדוק בעיות שקשורות לזמן האחזור של שרתי proxy של API ושירותי יעד.
אפשר גם לבדוק בעיות שנגרמו על ידי התראה ספציפית בלוח הבקרה 'בדיקה'. כשמתקבלת התראה, לוחצים על שם ההתראה בדף היסטוריית ההתראות כדי לפתוח את ההתראה בלוח הבקרה 'חקירה'.
שימוש במרכז הבקרה 'חקירה' כדי לאבחן בעיה
לדוגמה, אתם מקבלים התראה שמציינת ששיעור השגיאות מסוג 5xx חורג מהסף שצוין. כדי לחקור את הבעיה הזו, אפשר לבצע את המשימות הבאות בלוח הבקרה 'חקירה':
- כדי לראות את הפעילות של קוד השגיאה בשעה האחרונה, מעיינים במטריצה fault code versus time.
- עוברים למטריצה קוד שגיאה לעומת סטטוס HTTP כדי לזהות קודי סטטוס ספציפיים של HTTP שמשויכים לקודי השגיאה שהספירה שלהם עלתה בשעה האחרונה, כפי שזוהה בשלב הקודם.
- עוברים למטריצה fault code versus Proxy כדי לזהות את שרתי ה-proxy ל-API שמפעילים את קודי השגיאה שזוהו בשלב הקודם.
- לוחצים על תיבה במטריצה שמשויכת לשרת proxy של API עם נפח גבוה של קודי תקלות כדי לראות פרטים נוספים ויומני גישה.
- כדי לאבחן את הבעיה, אפשר להגדיר התראה וליצור דוח בהתאמה אישית.
כדי לפתור את הבעיה, אפשר לפתור בעיות ב-proxy ל-API באמצעות כלי מעקב וכלים אחרים.
שימוש בלוח הבקרה של קודי הסטטוס
לוח הבקרה של קודי הסטטוס מאפשר לכם לבדוק את מדדי קודי הסטטוס של שרתי ה-proxy של ה-API ושירותי היעד בארגון. אפשר לראות מדדים של קודי סטטוס לחלון של שעה או ארבע שעות בכל שלב ב-30 הימים האחרונים.
הסבר על לוח הבקרה של קודי הסטטוס
כדי להציג את לוח הבקרה של קוד הסטטוס, בוחרים באפשרות Analyze (ניתוח) > API Monitoring (מעקב אחרי API) > Investigate (חקירה) בממשק המשתמש של Edge. כברירת מחדל, בלוח הבקרה Status Code (קוד סטטוס) מוצגות:
כפי שמודגש באיור, לוח הבקרה Investigate (חקירה) מאפשר לכם:
- מגדירים כל מטריצה על ידי הגדרת ציר ה-X וציר ה-Y שלה כדי להשוות את הפעילות היחסית בין המדדים ולקבל תובנות נוספות.
- אפשר לזהות במהירות את המדדים שבהם נפחי החיפוש היחסיים הם הגבוהים ביותר, על סמך הצללת הצבע של הבלוק. ככל שהבלוק כהה יותר, כך נפח החיפוש היחסי גבוה יותר.
- כדי לראות את פרטי המדד, לוחצים על משבצת במטריצה.
- מסננים את הנתונים לפי:
- סביבה
- אזור
- שרת Proxy
- קודי סטטוס (כולל כל התנועה, כל השגיאות, 2xx, 4xx או 5xx)
- תאריך ושעה ב-30 הימים האחרונים
- חלון של שעה אחת או 4 שעות
בעזרת לוח הבקרה אפשר לבצע במהירות את המשימות הבאות:
- יומני גישה בחלונית פרטי המדד.
- כדי לראות את ההקשר הנוכחי בפעולות האחרונות, בציר הזמן או בלוח הבקרה, לוחצים על
> הצגה בפעולות האחרונות או על הצגה בציר הזמן, בהתאם. - יוצרים דוח בהתאמה אישית ומוסיפים עוד מאפיינים בלחיצה על
. - יוצרים התראה ומוסיפים תנאים נוספים להתראה, מגדירים התראות ויוצרים דוח בהתאמה אישית על סמך ההתראה.
הגדרת מטריצת קודי הסטטוס
כשבוחרים בלוח הבקרה קוד סטטוס, המטריצות הבאות מופיעות כברירת מחדל:
- קוד תקלה לעומת זמן
- קוד תקלה לעומת סטטוס HTTP
- מקור התקלה לעומת proxy ל-API
כדי להגדיר כל מטריצה להשוואה בין שניים מהמדדים הבאים, בוחרים ערך בתפריטים הנפתחים ציר X וציר Y:
- קוד תקלה
- מדיניות בנושא תקלות
- מקור התקלה
- סטטוס HTTP
- שרת Proxy
- שעה
- אזור
- יעד (שירות היעד או מדיניות ServiceCallout). אם היעד הוא מדיניות ServiceCallout, הערך שמוצג מתחיל ב-
sc://. לדוגמה,sc://my.endpoint.net.)
הצגת פרטים של מדד קוד הסטטוס
כדי לראות פרטים על מדד מסוים, לוחצים על הבלוק שלו במטריצה.
בחלונית השמאלית מוצגים פרטים שקשורים לגורם המשוער, כולל:
- סביבה
- ארגון
- אזור
- מקור התקלה (שרת proxy, יעד או תשתית Apigee)
הפרטים עשויים לכלול גם:
- מדיניות בנושא תקלות – מידע על המדיניות שהפעילה את שגיאת זמן הריצה, כולל סוג המדיניות (שם פנימי) ושם המדיניות שהוגדר על ידי המשתמש. אתם מגדירים את השם כשמצרפים את המדיניות לתהליך של שרת ה-proxy ל-API.
- שם שרת ה-Proxy
- קוד סטטוס של HTTP
- קוד תקלה
אם הקרדינליות גדולה מאחד למדד ספציפי, יכול להיות שבחלונית הפרטים יופיעו פרטים על התפלגות השגיאות, כמו התפלגות לפי אפליקציה למפתחים, התפלגות לפי מדיניות שגיאות, התפלגות לפי קוד שגיאה, התפלגות לפי סטטוס HTTP וכן הלאה. לדוגמה:
אם מקור התקלה הוא היעד, בחלונית הפרטים יופיע שיעור השגיאות לפי יעד. לדוגמה:
שימוש במרכז השליטה של זמן האחזור
לוח הבקרה 'זמן האחזור' מציג מידע על זמן האחזור של שרתי proxy של API ושירותי יעד בארגון. אפשר לבדוק את מדדי זמן האחזור עבור חלון של שעה בכל זמן ב-30 הימים האחרונים.
הסבר על מרכז הבקרה Latency
כדי להציג את לוח הבקרה Latency (זמן האחזור), בוחרים באפשרות Analyze (ניתוח) > API Monitoring (מעקב אחרי API) > Investigate (חקירה) בממשק המשתמש של Edge. לוח הבקרה Status Code (קוד סטטוס) מוצג כברירת מחדל. בוחרים באפשרות Latency באזור המסנן כדי להציג את לוח הבקרה Latency:
כשבוחרים את לוח הבקרה של זמן האחזור, המטריצות הבאות מופיעות כברירת מחדל:
- Proxy vs Time (זמן האחזור המקסימלי באלפיות השנייה)
- זמן האחזור של ה-Proxy לעומת זמן האחזור הכולל (זמן האחזור המקסימלי באלפיות השנייה)
- זמן האחזור של ה-Proxy לעומת זמן האחזור של כל היעדים (זמן האחזור המקסימלי באלפיות השנייה)
משתמשים בתיבה הנפתחת Proxy כדי לבחור באפשרות Target ולראות את זמני האחזור של היעד.
כברירת מחדל, בלוח הבקרה 'זמן אחזור' מוצג מידע על 10 שרתי ה-proxy עם זמן האחזור הכולל הגבוה ביותר של P99 בשעה הקודמת. אפשר גם להשתמש בתיבה הנפתחת Top 10 כדי לבחור שרת proxy או אוסף ספציפיים.
לוח הבקרה Latency כולל את כל התכונות של לוח הבקרה Status Code, עם ההבדלים הבאים:
- אתם מגדירים רק את אחוזון זמן האחזור הכולל של התגובה (p50, p90, p95, p99).
- אפשר לבחור רק חלון זמן של שעה אחת למדדי השהייה.
- אי אפשר לבחור באפשרות Any (כל) עבור Region (אזור) במסננים. צריך לבחור אזור ספציפי כדי לראות את הנתונים שלו.
הצגת פרטים של מדד זמן האחזור
כדי לראות פרטים על מדד מסוים, לוחצים על הבלוק שלו במטריצה.
בחלונית הימנית מוצגים פרטים שקשורים לזמן האחזור של שרת proxy (הקו הכחול) ויעד (הקו הסגול), כולל:
- זמן האחזור הכולל (זמן האחזור של ה-proxy בתוספת זמן האחזור של היעד)
- זמן אחזור לכל יעד (זמן תגובה ליעד)
- התפלגות לפי סטטוס HTTP
מעבירים את העכבר מעל התרשים כדי לראות מידע מפורט:
בתרשים השהיה לכל יעד מוצגים 16 היעדים המובילים על סמך ההשהיה המקסימלית, עם תרשים אחד לכל יעד. מעבירים את העכבר מעל גרף או בוחרים את הרשימה הנפתחת כדי לראות את הגרף שמתאים לכל יעד.
צפייה ביומנים מפרטי המדדים
כשמציגים את פרטי המדדים של קודי סטטוס או של זמן האחזור, לוחצים על הצגת יומנים כדי לראות את כל היומנים של המדד שנבחר:
תיבת הדו-שיח 'יומני תנועה' נפתחת ומוצגים בה עד 1,000 רשומות ביומן. לוחצים על רשומה ביומן כדי להרחיב את הפרטים שלה ברשימה:
אפשר לסנן את היומנים לפי:
- מקור תנועה
- סוג השגיאה
- זמן תגובה מינימלי
אי אפשר להוריד את נתוני היומנים מתיבת הדו-שיח 'יומני תנועה'. עם זאת, אתם יכולים ליצור דוח בהתאמה אישית או להוריד את נתוני הניתוח למאגר נתונים משלכם, כמו Google Cloud Storage או BigQuery, כדי לבצע ניתוח נתונים משלכם.
יצירת דוח בהתאמה אישית ממרכז הבקרה 'חקירה'
יוצרים דוח בהתאמה אישית על סמך קבוצת התנאים שנבחרה. אחרי שיוצרים את הדוח בהתאמה אישית, אפשר לערוך אותו כדי להוסיף או למחוק מדדים ומאפיינים לפי הצורך. לדוגמה, יכול להיות שתרצו לצמצם את הבדיקה לטוקן גישה מסוים, לאפליקציית מפתח או ל-proxy ל-API. מידע נוסף זמין במאמר הפניה למדדים, למאפיינים ולמסננים ב-Analytics.
מידע נוסף זמין במאמר בנושא יצירת דוחות בהתאמה אישית.
כדי ליצור דוח מותאם אישית:
כדי לראות פרטים נוספים, לוחצים על משבצת במטריצה.
בחלונית השמאלית, לוחצים על
.
דף הדוח המותאם אישית יוצג בכרטיסייה חדשה עם שדות רלוונטיים שאוכלסו מראש.
הערה: מידע נוסף על הגדרות ברירת המחדל של דוחות בהתאמה אישית זמין במאמר יצירת דוחות בהתאמה אישית.
עורכים את הדוח בהתאמה אישית לפי הצורך. איך עובדים עם דוחות בהתאמה אישית
לוחצים על שמירה כדי לשמור את הדוח בהתאמה אישית.
כברירת מחדל, הדוח מופעל באמצעות הנתונים שנאספו במהלך השעה האחרונה, והנתונים מוצגים בלוח הבקרה של הדוח בהתאמה אישית. מידע נוסף על מרכז הבקרה של דוחות בהתאמה אישית
בדף Reports, דוחות בהתאמה אישית שנוצרים באמצעות API Monitoring מקבלים שם בפורמט הבא: API Monitoring Investigate Generated.
בדיקת התראה ספציפית
כדי לבדוק התראה ספציפית, בוחרים את שם ההתראה בדף היסטוריית ההתראות. יוצג מרכז השליטה 'חקירה'. שימו לב: בחלק העליון של לוח הבקרה יש תרשים, והוא כולל רק מידע שספציפי להתראה:
- צפייה בפרטי התנועה ב-API בזמן שההתראה הופעלה.
- הצגת מידע הקשרי על ההתראה, כולל השעה שבה ההתראה הופעלה במרכז התרשים.
- לוחצים על פרטי התנאי כדי להציג את הפרטים של תנאי ההתראה בחלון קופץ.
לוחצים על מדריך (אם האפשרות זמינה) כדי להציג את המדריך להתראה:
לוחצים על ניהול ההתראה כדי לערוך את ההתראה.
לוחצים על הצגת הדוח (אם האפשרות זמינה) כדי לראות דוח בהתאמה אישית.
מפעילים או משביתים את הרענון האוטומטי של הדף לפי הצורך.