איך בודקים את הסיבות לבעיות

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

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

בממשק המשתמש של Edge, בוחרים באפשרות Analysis > API Monitoring > חקירה כדי לפתוח את מרכז הבקרה לחקירה. למרכז השליטה יש שני אזורים עיקריים:

  • קוד סטטוס מאפשר לך לעיין במדדים של קוד סטטוס עבור שרתי proxy של API ושירותי יעד.
  • זמן אחזור מאפשר לבדוק בעיות זמן אחזור בשרתי proxy ובשירותי יעד של API.

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

שימוש במרכז הבקרה לחקירה של בעיה

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

  1. הצגה של מטריצת קוד התקלה לעומת הזמן כדי להציג את הפעילות של קודי התקלה בשעה האחרונה.
  2. כדי לזהות קודי סטטוס ספציפיים של HTTP המשויכים לקודי התקלה שהמספרים שלהם גדלו בשעה האחרונה, אפשר לעבור למטריצה של קוד התקלה לעומת סטטוס HTTP.
  3. עוברים למטריצת קוד התקלה לעומת המטריצה של שרת ה-proxy כדי לזהות את שרתי ה-proxy של ה-API שמפעילים את קודי התקלה שזוהו בשלב הקודם.
  4. כדי להציג פרטים נוספים ולגשת ליומנים, צריך ללחוץ על תיבה במטריצה שמשויכת לשרת proxy של API עם נפח גבוה של קודי שגיאות.
  5. מגדירים התראה ויוצרים דוח בהתאמה אישית כדי לעזור באבחון הבעיה.
  6. המשיכו troubleshoot בשרת ה-proxy של ה-API באמצעות מעקב וכלים אחרים כדי לזהות פתרון לבעיה.

שימוש במרכז השליטה של קוד הסטטוס

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

סקור את מרכז השליטה של קוד הסטטוס

כדי להציג את מרכז השליטה של קוד הסטטוס, בוחרים באפשרות ניתוח > API Monitoring > חקירה בממשק המשתמש של Edge. מרכז השליטה 'קוד סטטוס' מוצג כברירת מחדל:

דף קוד סטטוס

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

  • הגדירו כל מטריצה על ידי הגדרת ציר ה-X וציר ה-Y כדי להשוות את הפעילות היחסית בין המדדים ולקבל יותר תובנות.
  • זיהוי מהיר של המדדים בעלי הנפח היחסי הגבוה ביותר על סמך הצללת הצבעים של הבלוק. ככל שהבלוק כהה יותר, כך הנפח היחסי גבוה יותר.
  • לוחצים על בלוק במטריצה כדי להציג את פרטי המדד.
  • מסננים את הנתונים לפי:
    • סביבה
    • אזור
    • שרת Proxy
    • קודי סטטוס (כולל כל התנועה, כל השגיאות, 2xx, 4xx או 5xx)
    • תאריך ושעה ב-30 הימים האחרונים
    • חלון של שעה או 4 שעות

אפשר להשתמש במרכז הבקרה כדי לבצע במהירות את המשימות הבאות:

הגדרת המטריצה של קוד הסטטוס

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

  • קוד תקלה לעומת זמן
  • קוד תקלה לעומת מצב HTTP
  • מקור התקלה לעומת שרת proxy של API

הגדר כל מטריצה כדי להשוות בין שני המדדים הבאים על ידי בחירת ערך עבור הרשימות הנפתחות x- ו-y-pi:

הגדרת מטריצה

הצגת פרטי המדד 'קוד סטטוס'

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

בחירת בלוק

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

  • סביבה
  • ארגון
  • אזור
  • מקור התקלה (תשתית proxy, יעד או Apigee)

הפרטים עשויים לכלול גם:

  • מדיניות תקלות – מידע על המדיניות שהפעילה את שגיאת זמן הריצה, כולל סוג המדיניות (שם פנימי) ושם מדיניות בהגדרת המשתמש. צריך להגדיר את השם כשמצרפים את המדיניות לתהליך ה-API של שרת ה-proxy.
  • שם שרת Proxy
  • קוד מצב HTTP
  • קוד שגיאה

אם העוצמה (cardinality) גדולה ממדד אחד ספציפי, חלונית הפרטים עשויה לכלול פרטי התפלגות שגיאות, למשל: 'הפצה לפי אפליקציה למפתחים', 'הפצה לפי מדיניות תקלה', 'הפצה לפי קוד תקלה', 'התפלגות לפי סטטוס HTTP' וכו'. לדוגמה:

התפלגות לפי

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

שיעור שגיאות לפי יעד

שימוש במרכז השליטה 'זמן אחזור'

בלוח הבקרה של זמן האחזור מוצג מידע על זמן האחזור של שרתי ה-proxy של ה-API ושירותי היעד בארגון שלכם. ניתן לבחון את מדדי זמן האחזור בחלון של שעה בכל שלב במהלך 30 הימים האחרונים.

הכרת מרכז השליטה של זמן האחזור

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

דף זמן אחזור

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

  • שרת Proxy לעומת זמן (זמן אחזור מקסימלי באלפיות שנייה)
  • שרת Proxy לעומת זמן אחזור כולל (זמן אחזור מקסימלי באלפיות שנייה)
  • זמן אחזור של שרת Proxy לעומת כל היעדים (זמן אחזור מקסימלי באלפיות שנייה)

בתיבה הנפתחת שרת proxy בוחרים באפשרות Target (יעד) כדי להציג את זמני האחזור של היעדים.

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

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

  • אתם יכולים להגדיר רק את האחוזון הכולל של זמן האחזור לתגובה (p50, p90, p95, p99).
  • ניתן לבחור חלון של שעה אחת בלבד למדדי זמן אחזור.
  • לא ניתן לבחור באפשרות הכול בשדה אזור במסננים. חובה לבחור אזור מסוים להצגה.

הצגת פרטים של המדד 'זמן אחזור'

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

בחירת בלוק

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

  • זמן אחזור כולל (זמן אחזור של שרת proxy וזמן אחזור יעד)
  • זמן אחזור לכל יעד (יעד זמן תגובה)
  • התפלגות לפי סטטוס HTTP

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

תצוגת המדד 'זמן אחזור'

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

צפייה ביומנים מפרטי המדדים

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

בחירת יומנים

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

יומנים

אפשר להמשיך לסנן את היומנים לפי:

  • מקור תנועה
  • סוג השגיאה
  • זמן תגובה מינימלי

לא ניתן להוריד את נתוני היומנים מתיבת הדו-שיח 'יומני תנועה'. עם זאת, אתם יכולים ליצור דוח בהתאמה אישית או להוריד את נתוני הניתוח למאגר נתונים משלכם, כמו Google Cloud Storage או BigQuery, כדי לבצע ניתוח נתונים משלכם.

יצירת דוח בהתאמה אישית ממרכז הבקרה לחקירה

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

מידע נוסף זמין במאמר יצירת דוחות בהתאמה אישית.

כדי ליצור דוח מותאם אישית:

  1. לוחצים על בלוק במטריצה כדי להציג פרטים נוספים.

    בחירת בלוק

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

    יצירת דוח

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

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

    ערוך את הדוח

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

  4. לוחצים על Save (שמירה) כדי לשמור את הדוח בהתאמה אישית.

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

בדף Reports (דוחות), דוחות מותאמים אישית שנוצרים באמצעות API Monitoring מקבלים את השמות בפורמט הבא: API Monitoring Investigate Generated.

חקירה של התראה ספציפית

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

בדיקת דף ההתראה

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

    קישור ל-playbook

  • כדי לערוך את ההתראה, לוחצים על ניהול ההתראה.

  • לוחצים על הצגת דוח (אם האפשרות זמינה) כדי להציג דוח בהתאמה אישית.

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