מעקב אחר תנועת ה-API האחרונה

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

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

• שימוש בתצוגת הרשימה
• שימוש במפת החום

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

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

היכרות בתצוגת הרשימה

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

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

כפי שמודגש באיור, תצוגת הרשימה מאפשרת:

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

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

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

• אפשר לחפש את תצוגת הרשימה לפי שם או כתובת URL (למשל: https://acme.com/api). מזינים את כל המחרוזת הרלוונטית או חלק ממנה בתיבת החיפוש. אפשר לחפש תוכן בשדות 'שרת proxy', 'יעדים' או 'אזור'.

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

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

• הצגה והסתרה של פרטי שירות היעד ברשימה.

זיהוי שרתי ה-API ושירותי היעד שיש להם התראות

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

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

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

הצגת נתונים מפורטים לגבי שרת proxy של API או שירות יעד

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

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

• פרטים
• מגמות
• יומנים

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

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

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

פרטים

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

פרטים	‫תיאור
סך כל התנועה	מספר העסקאות הכולל.
סך כל השגיאות	המספר הכולל של שגיאות.
שיעור שגיאות כולל	אחוז התנועה שהביאה לשגיאות (סה"כ שגיאות/תנועה כוללת). הערה: ה-API Monitoring משווה את האחוז הזה לתנאי ההתראה שאתם מגדירים. אם שיעור השגיאות הכולל חורג מערכי הסף, יוצגו בממשק המשתמש אינדיקטורים של התראות.
כיסוי ספק ממוצע	ממוצע עסקאות לשנייה.
זמן אחזור כולל (P99)	הערך הכולל של זמן האחזור למאון ה-99 מחושב על פני חלון זמן של 5 דקות. הערה: מוצגת רק בשרתי proxy של API.
זמן אחזור של יעד (P99)	יעד זמן האחזור של תגובה במאון ה-99 מחושב על פני חלון זמן של 5 דקות. הערה: מוצגת רק בשרתי proxy של API.
מקור השגיאה	פירוט והאחוז הכולל של שגיאות הקשורות לחבילה של שרת proxy ל-API (4xx ו-5xx) שהתרחשו.

Trends

הכרטיסייה מגמות מציגה את התרשימים הבאים עבור הרכיב שנבחר:

• שיעור השגיאות לשגיאות מסוג 4xx ו-5xx
• תנועה (TPS)
• זמן אחזור כולל (אלפיות שנייה)

• זמן האחזור של כל היעדים

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

יומנים

בכרטיסייה Logs, מסננים לפי 4xx, 5xx או כל השגיאות, וצמצמו את מקור השגיאות לפי שרת proxy של ה-API, שירות היעד (השירות שלכם) או Apigee (תשתית Apigee).

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

שימוש במפת החום

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

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

סיור במפת החום

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

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

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

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

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

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

  

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

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

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

זיהוי שרתי ה-API ושירותי היעד שיש להם התראות

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

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

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

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

סביבה >>	שרת proxy >>	Target

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

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

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

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

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

• פרטים
• מגמות
• יומנים

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

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

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

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

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

1. בממשק המשתמש של Edge, לוחצים על ניתוח > API Monitoring > לאחרונה.

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

3. בפינה השמאלית, לוחצים על .

   

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

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

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