אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
Edge API Analytics היא תכונה מובנית חזקה מאוד ש-Apigee Edge מספקת. הוא אוסף ומנתח מגוון רחב של נתונים שמגיעים מממשקי API. נתוני הניתוח שנאספים יכולים לספק תובנות מועילות מאוד. לדוגמה, מה המגמה של נפח התנועה ב-API לאורך תקופה מסוימת? איזה ממשק API הכי נפוץ? באילו ממשקי API יש שיעורי שגיאה גבוהים?
ניתוח קבוע של הנתונים והתובנות האלה יכול לשמש לביצוע פעולות מתאימות, כמו תכנון עתידי של קיבולת ממשקי ה-API על סמך השימוש הנוכחי, החלטות עסקיות והשקעות עתידיות, ועוד הרבה יותר.
נתוני Analytics והאחסון שלהם
ניתוח הנתונים של ממשקי ה-API מתעד סוגים רבים של נתונים, כמו:
- מידע על API – URI של בקשה, כתובת IP של לקוח, קודי סטטוס של תגובה וכו'
- ביצועי שרת proxy ל-API – שיעור הצלחה/כישלון, זמן עיבוד הבקשה והתגובה וכו'
- ביצועי שרת היעד – שיעור הצלחה/כישלון, זמן עיבוד
- פרטי השגיאה – מספר השגיאות, קוד השגיאה, המדיניות שנכשלה, מספר השגיאות שנגרמו על ידי Apigee ועל ידי שרת היעד.
- מידע נוסף – מספר הבקשות שנשלחו על ידי מפתחים, אפליקציות של מפתחים וכו'
כל הנתונים האלה מאוחסנים בסכימה של analytics שנוצרה ומנוהלת בתוך מסד נתונים של Postgres על ידי Apigee Edge.
בדרך כלל, בהתקנה רגילה של Edge, ל-Postgres יהיו הסכימות הבאות:
הסכימה בשם analytics משמשת את Edge לאחסון כל נתוני הניתוח של כל ארגון וסביבה. אם מונטיזציה מותקנת, תהיה סכימה של rkms. סכימות אחרות מיועדות לרכיבים הפנימיים של Postgres.
הסכימה של analytics תמשיך להשתנות, כי Apigee Edge יוסיף לה באופן דינמי טבלאות עובדות חדשות במהלך זמן הריצה. רכיב השרת של Postgres יאגרג את נתוני העובדות לטבלאות מסכמות, שייטמעו ויוצגו בממשק המשתמש של Edge.
דפוס שלילי
לא מומלץ להוסיף עמודות, טבלאות או תצוגות בהתאמה אישית לכל אחד מהסכמות שבבעלות Apigee במסד הנתונים של Postgres בסביבות של ענן פרטי ישירות באמצעות שאילתות 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וכו' - אם יש צורך לתמוך במידע מותאם אישית, אפשר להוסיף אותו כעמודות (שדות) באמצעות מדיניות של Statistics Collector לסכימה
analytics.