אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
לוח הבקרה Recent מאפשר לכם לעקוב אחרי תנועת ה-API האחרונה של כל פרוקסי ה-API והשירותים הממוקדים בארגון שלכם בשעה האחרונה. אפשר להציג את נתוני המעקב אחר ה-API כרשימה מפורטת או כמפת חום. בקטעים הבאים מוסבר על כל תצוגה:
שימוש בתצוגת הרשימה
בתצוגת הרשימה מוצג סיכום של נתוני פרוקסי של API ושירותי יעד בארגון שהייתה בהם תנועה בזמן האחרון.
עיון בתצוגת הרשימה
כדי להציג את תצוגת הרשימה, בוחרים באפשרות Analyze > API Monitoring > Recent בממשק המשתמש של Edge.
תצוגת הרשימה מוצגת כברירת מחדל. כדי לחזור לתצוגת הרשימה בכל שלב, לוחצים על 
בלוח הבקרה 'הפעילות האחרונה'.
כפי שמודגש באיור, בתצוגת הרשימה אפשר:
- צפייה בסיכום מידע על כל ה-API proxies ושירותי היעד בארגון שבוצעו בהם עסקאות בשעה האחרונה. שרתי proxy ל-API ושירותי יעד מפורטים לפי אזור וסביבה. (כדי לראות נתונים היסטוריים רחבים יותר, אפשר לעיין במאמר זיהוי מגמות בנתוני המעקב של ה-API).
- זיהוי מהיר של שרתי proxy ל-API ושירותי יעד שיש לגביהם התראות. (מידע על הגדרת התראות מופיע במאמר הגדרת הודעות והתראות).
- לוחצים על השם של שרת proxy של API או על שירות יעד ברשימה כדי לראות נתונים מפורטים בחלונית הימנית.
בעזרת ההקשר הנוכחי, אפשר לבצע במהירות את המשימות הבאות (האפשרויות מוצגות באפור אם הן לא רלוונטיות להקשר שנבחר כרגע):
- יוצרים דוח בהתאמה אישית ומוסיפים מאפיינים נוספים. לוחצים על
. - יוצרים התראה ומוסיפים תנאים נוספים להתראה, מגדירים התראות ויוצרים דוח בהתאמה אישית על סמך ההתראה.
- אפשר לראות את ההקשר הנוכחי בציר הזמן או בלוח הבקרה חקירה. לוחצים על
> הצגה בציר הזמן או על הצגה בכלי החקירה, בהתאם.
- יוצרים דוח בהתאמה אישית ומוסיפים מאפיינים נוספים. לוחצים על
מחפשים בתצוגת הרשימה לפי שם או כתובת URL (לדוגמה, https://acme.com/api). מזינים בתיבת החיפוש מחרוזת רלוונטית, מלאה או חלקית. אפשר לחפש תוכן בשדות Proxy, Targets או Region.
הערה: אם בוחרים במסנן התראות בלבד, בתוצאות החיפוש יופיעו רק שרתי proxy של API או שירותי יעד שיש לגביהם התראות.
מפעילים או משביתים את הרענון האוטומטי של הדף לפי הצורך.
הצגה והסתרה של פרטי שירות היעד ברשימה.
איך מזהים את שרתי ה-proxy ל-API ואת שירותי היעד שיש להם התראות
כשמציגים את תצוגת הרשימה, סמל אזהרה אדום 
וקו אדום בגבול הימני מציינים אילו שירותי יעד ו-API Proxy כוללים התראות.
לוחצים על התרעות בלבד כדי להציג רק את שרתי ה-proxy של ה-API או את יעדי השירות שיש להם התרעות.
כדי לראות סיכום מהיר של מספר השגיאות מסוג 4xx ו-5xx, ושל שיעור השגיאות הכולל, מעבירים את סמן העכבר מעל אחד מהערכים המספריים בטבלה.
הצגת נתונים מפורטים לגבי שרת proxy של API או שירות יעד
כדי לראות נתונים מפורטים לגבי שירות יעד או שרת proxy של API, לוחצים על השם שלו בתצוגת הרשימה. הנתונים המפורטים מוצגים בחלונית השמאלית.
כדי לראות מידע נוסף, לוחצים על הכרטיסיות הבאות:
בנוסף, באמצעות ההקשר הנוכחי, אתם יכולים לבצע במהירות את המשימות הבאות:
הערה: אפשרויות שאינן רלוונטיות להקשר שנבחר כרגע מופיעות באפור.
- יוצרים דוח בהתאמה אישית ומוסיפים מאפיינים נוספים. לוחצים על .
- יוצרים התראה ומוסיפים תנאים נוספים להתראה, מגדירים התראות ויוצרים דוח בהתאמה אישית על סמך ההתראה. לוחצים על > יצירת התראה.
- אפשר לראות את ההקשר הנוכחי בציר הזמן או בלוח הבקרה חקירה. לוחצים על > הצגה בציר הזמן או על הצגה בכלי החקירה, בהתאם.
פרטים
בכרטיסייה פרטים מוצגת תצוגה מהירה של נתוני התנועה בציר הזמן שצוין (כפי שמוצג באיור הקודם), כולל:
| פרטים | תיאור |
| סך כל התנועה | המספר הכולל של העסקאות. |
| סה"כ שגיאות | המספר הכולל של השגיאות. |
| שיעור שגיאות כולל | אחוז התנועה שהובילה לשגיאות (סך השגיאות חלקי סך התנועה).
הערה: הכלי 'מעקב אחר API' משווה את האחוז הזה לתנאי ההתראה שהגדרתם. אם שיעור השגיאות הכולל חורג מערכי הסף, מוצגים בממשק המשתמש אינדיקטורים של התראות. |
| מספר העסקאות הממוצע לשנייה | מספר העסקאות הממוצע לשנייה. |
| זמן אחזור כולל (P99) | ערך כולל של זמן האחזור של התגובה באחוזון ה-99, שמחושב על פני חלון זמן מתגלגל של 5 דקות. הערה: מוצג רק עבור proxy ל-API. |
| זמן טעינה יעד (אחוזון 99) | ערך זמן האחזור של התגובה הממוקד באחוזון ה-99, שמחושב על פני חלון נע של 5 דקות. הערה: מוצג רק עבור proxy ל-API. |
| מקור השגיאה | פירוט ואחוז כולל של שגיאות (4xx ו-5xx) בחבילת proxy ל-API שהתרחשו. |
Trends
בכרטיסייה מגמות מוצגים הגרפים הבאים לגבי הרכיב שנבחר:
- שיעור השגיאות של שגיאות 4xx ו-5xx
- תנועה (TPS)
- זמן האחזור הכולל (באלפיות השנייה)
זמן האחזור של כל היעדים
מעבירים את העכבר מעל נקודות שונות בגרף כדי להציג במבט מהיר את אחוזי השגיאות, את ספירת התנועה הכוללת ואת זמני האחזור, בהתאמה, בכל נקודה.
יומנים
בכרטיסייה Logs (יומנים), מסננים לפי 4xx, 5xx או All errors (כל השגיאות), ומצמצמים את מקור השגיאות לפי API proxy, שירות יעד (השירות שלכם) או Apigee (התשתית של Apigee).
לוחצים על שגיאה כדי לפתוח את תיבת הדו-שיח של היומנים ולהרחיב את הפרטים שלה ברשימה.
שימוש במפת החום
מפת החום מציגה תצוגה של בלוקים צבעוניים שמאפשרת לכם לזהות אילו סביבות כוללות התראות.
- ירוק מציין שלא חלה חריגה מספי הערך של תנאי ההתראה.
- אדום מציין שהייתה חריגה מספי התנאים להפעלת התראה וההתראות הופעלו.
עיון במפת החום
לוחצים על 
בדף 'מהזמן האחרון' כדי להציג את מפת החום, שמוצגת באיור הבא.
כפי שמוצג באיור הקודם, מפת החום מאפשרת לכם:
- זיהוי מהיר של שרתי proxy ל-API ושירותי יעד שיש לגביהם התראות. (מידע על הגדרת התראות מופיע במאמר הגדרת הודעות והתראות).
- כדי לסנן את התצוגה, בוחרים רכיבים מהרשימות הנפתחות או לוחצים לחיצה כפולה על תיבה כדי להציג פירוט נוסף. בתפריטים הנפתחים Proxies (שרתי proxy) ו-Targets (יעדים), אפשר לסנן באמצעות אוסף. לדוגמה:
- לוחצים על בלוק במפת החום כדי לראות נתונים מפורטים בחלונית הימנית.
בעזרת ההקשר הנוכחי, אפשר לבצע במהירות את המשימות הבאות (האפשרויות מוצגות באפור אם הן לא רלוונטיות להקשר שנבחר כרגע):
- יוצרים דוח בהתאמה אישית ומוסיפים מאפיינים נוספים. לוחצים על .
- יוצרים התראה ומוסיפים תנאים נוספים להתראה, מגדירים התראות ויוצרים דוח בהתאמה אישית על סמך ההתראה. לוחצים על > יצירת התראה.
- אפשר לראות את ההקשר הנוכחי בציר הזמן או בלוח הבקרה חקירה. לוחצים על > הצגה בציר הזמן או על הצגה בכלי החקירה, בהתאם.
- יוצרים דוח בהתאמה אישית ומוסיפים מאפיינים נוספים. לוחצים על
כדי להגדיר את סולם התצוגה של מפת החום, מגדירים את scaled by ללוגריתמי או לינארי. השיטה הלינארית קובעת את גודל התיבות לפי יחסי תנועת הגולשים הכוללת. לדוגמה, פרוקסי עם 200 שיחות גדול פי שניים מפרוקסי עם 100 שיחות.
כדי לחפש במפת החום, מזינים בתיבת החיפוש מחרוזת רלוונטית, מלאה או חלקית. אתם יכולים לחפש תוכן במפה של האזור, הסביבה, ה-proxy או היעד, בהתאם למה שמוצג כרגע.
הערה: אם בוחרים במסנן התראות בלבד, בתוצאות החיפוש יופיעו רק שרתי proxy של API או שירותי יעד שיש לגביהם התראות.
מפעילים או משביתים את הרענון האוטומטי של הדף לפי הצורך.
איך מזהים את שרתי ה-proxy ל-API ואת שירותי היעד שיש להם התראות
כשמסתכלים על מפת הצפיפות, בלוק אדום מציין אילו סביבות, פרוקסי של API ושירותי יעד כוללים התראות. מידע נוסף על הגדרת התראות זמין במאמר הגדרת התראות והודעות.
לדוגמה, באיור הבא מוצגות שתי סביבות:
- סביבת test מסומנת באדום כי אחוז השגיאות בתנועה שלה חרג מערך הסף של תנאי ההתראה שהגדרתם לציר הזמן שצוין.
- סביבת prod מסומנת בירוק כי אחוז שגיאות התנועה שלה לא חרג מסף תנאי ההתראה בציר הזמן שצוין.
כדי לסנן את התצוגה, בוחרים רכיבים מהרשימות הנפתחות. אפשר גם ללחוץ לחיצה כפולה על תיבה כדי להציג את המפה של ה-API Proxy מתוך מפת הסביבה, ואת מפת יעדי השירות מתוך מפת ה-API Proxy, וכך לזהות את ה-API Proxies ואת שירותי היעד שיש לגביהם התראות.
| סביבה >> | Proxy >> | Target |
|
 |
 |
לוחצים על התראות בלבד כדי להציג רק את הסביבות, את שרתי ה-API או את יעדי השירות שיש לגביהם התראות, בהתאם למה שמוצג כרגע.
כדי לחזור לרמה הקודמת, לוחצים על 
.
הצגת נתונים מפורטים לגבי סביבה, שרת proxy של API או שירות יעד
כדי להציג נתונים מפורטים לגבי סביבה, שרת proxy של API או שירות יעד, לוחצים על התיבה המתאימה במפת החום. הנתונים המפורטים מוצגים בחלונית השמאלית.
בכרטיסיות מופיע אותו מידע שמופיע בתצוגת הרשימה. מידע נוסף זמין בדפים הבאים:
כשלוחצים על תיבה במפה, מוצג גם מספר השיחות ושיעור השגיאות בשעה האחרונה.
יצירת דוח בהתאמה אישית ממרכז הבקרה 'דוחות אחרונים'
יוצרים דוח בהתאמה אישית על סמך קבוצת התנאים שנבחרה. אחרי שיוצרים את הדוח בהתאמה אישית, אפשר לערוך אותו כדי להוסיף או למחוק מדדים ומאפיינים לפי הצורך. לדוגמה, יכול להיות שתרצו לצמצם את הבדיקה לטוקן גישה מסוים, לאפליקציית מפתח או ל-proxy ל-API. מידע נוסף זמין במאמר הפניה למדדים, למאפיינים ולמסננים ב-Analytics.
מידע נוסף זמין במאמר בנושא יצירת דוחות בהתאמה אישית.
כדי ליצור דוח בהתאמה אישית ממרכז הבקרה 'דוחות אחרונים':
- בממשק המשתמש של Edge, לוחצים על Analyze > API Monitoring > Recent.
כדי לראות פרטים נוספים, בוחרים שירות יעד או שרת proxy של API בתפריטים הנפתחים של המסנן 'תצוגת רשימה' או 'מפת חום'. הערה: דוחות בהתאמה אישית לא זמינים אם המסננים 'שרתי Proxy' ו'יעדים' מוגדרים לערך
All.בפינה השמאלית, לוחצים על
.
דף הדוח המותאם אישית מוצג בכרטיסייה חדשה עם שדות רלוונטיים שאוכלסו מראש ומאפיינים ומדדים שמוגדרים כברירת מחדל. כברירת מחדל, השם של הדוח המותאם אישית הוא:
API Monitoring Recent Generatedהערה: אם כבר קיים דוח מותאם אישית בהקשר הנוכחי, הוא ייפתח.עורכים את הדוח בהתאמה אישית לפי הצורך ולוחצים על שמירה.
לוחצים על שם הדוח ברשימה ומריצים את הדוח המותאם אישית.