כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
Edge API Analytics הוא תכונה מובנית וחזקה מאוד של Apigee Edge. הוא אוסף ומנתח מגוון רחב של נתונים שעוברים בין ממשקי ה-API. ניתוח הנתונים שתועד יכול לספק תובנות שימושיות מאוד. לדוגמה, מהם המגמות בנפח התנועה בממשק ה-API במהלך תקופה מסוימת? מהו ה-API הנפוץ ביותר בשימוש? באילו ממשקי API יש שיעורי שגיאות גבוהים?
אנחנו עשויים להשתמש בתובנות ובנתונים האלה באופן קבוע כדי לבצע פעולות מתאימות, כמו תכנון קיבולת עתידי של ממשקי API על סמך השימוש הנוכחי, החלטות עסקיות והחלטות עתידיות לגבי השקעות, ועוד.
נתוני Analytics והאחסון שלהם
API Analytics לוכד סוגים רבים של נתונים, כגון:
- מידע על ממשק API - URI של בקשה, כתובת IP של לקוח, קודי סטטוס תגובה וכו'
- ביצועים של שרת proxy ל-API – שיעור הצלחה/כישלונות, זמן עיבוד של בקשות ותגובה וכו'
- הביצועים של שרת היעד – שיעור הצלחה/כישלון, זמן העיבוד
- פרטי השגיאות – מספר השגיאות, קוד התקלה, מדיניות הכשל, מספר ה-Apigee ושרת היעד שנגרמו כתוצאה משגיאות.
- מידע אחר - מספר הבקשות שנשלחו על ידי מפתחים, אפליקציות למפתחים וכו'
כל הנתונים האלה מאוחסנים בסכימה analytics שנוצרה ומנוהלת במסד הנתונים של Postgres על ידי Apigee Edge.
בדרך כלל, בהתקנת וניל Edge, יש ל-Postgres את הסכימה הבאה:
Edge משתמשת בסכימה בשם analytics כדי לאחסן את כל נתוני הניתוח של
כל ארגון וסביבה. אם התקנת המונטיזציה תותקן, תופיע סכימה של rkms. סכימות אחרות מיועדות לרכיבים פנימיים של Postgres.
הסכימה של analytics תמשיך להשתנות, כי Apigee Edge תוסיף לה באופן דינמי טבלאות של עובדות חדשות בזמן הריצה. רכיב השרת של Postgres יאסוף את נתוני העובדות לתוך טבלאות מסכמות שנטענות ומוצגות בממשק המשתמש של Edge.
דוגמת עיצוב
לא מומלץ להוסיף עמודות בהתאמה אישית, טבלאות ו/או תצוגות לכל הסכימות שבבעלות Apigee ב-Postgres Database בסביבות של Private Cloud באופן ישיר באמצעות שאילתות SQL, כי יכולות להיות לכך השלכות שליליות.
נבחן דוגמה כדי להסביר זאת בפירוט.
נניח שטבלה בהתאמה אישית בשם account נוצרה לפי סכימת Analytics
כפי שמוצג כאן:
לאחר זמן מה, נניח שיהיה צורך לשדרג את Apigee Edge מגרסה ישנה יותר לגרסה מתקדמת יותר. השדרוג ל-Private Cloud Apigee Edge כרוך בשדרוג של Postgres בין רכיבים רבים אחרים. אם נוספו למסד הנתונים של Postgres עמודות, טבלאות או תצוגות בהתאמה אישית, השדרוג של Postgres ייכשל, ויהיו שגיאות שמפנות לאובייקטים המותאמים אישית, כי הם לא נוצרו על ידי Apigee Edge. כך, שדרוג ל-Apigee Edge נכשל ולא ניתן להשלים אותו.
באופן דומה, שגיאות עשויות להתרחש במהלך פעילויות תחזוקה של Apigee Edge, שבהן מבוצעים גיבוי ושחזור של רכיבי Edge, כולל מסד נתונים Postgres.
השפעה
- לא ניתן להשלים את השדרוג ל-Apigee Edge כי שדרוג הרכיב Postgres נכשל ומופיעות שגיאות בהתייחסות לאובייקטים מותאמים אישית שלא נוצרו על ידי Apigee Edge.
- חוסר עקביות (וכשלים) במהלך ביצוע תחזוקת השירות של Apigee Analytics (גיבוי/שחזור).
שיטה מומלצת
- אסור להוסיף מידע מותאם אישית בצורת עמודות, טבלאות, תצוגות, פונקציות
והליכים ישירות לאף סכימה בבעלות Apigee, כמו
analyticsוכו' - אם יש צורך במידע מותאם אישית, ניתן להוסיף אותו לסכימה
analyticsכעמודות (שדות) באמצעות מדיניות 'סטטיסטיקות Collector'.