אתם צופים במסמכי התיעוד של Apigee Edge.
למעבר אל
מסמכי התיעוד של Apigee X info
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 יהיו הסכימות הבאות:
הסכימה בשם analytics משמשת את Edge לאחסון כל נתוני הניתוח של כל ארגון וסביבה. אם מותקנת מונטיזציה, תהיה סכימה של rkms. סכימות אחרות מיועדות לשימוש פנימי ב-Postgres.
הסכימה analytics תמשיך להשתנות כי Apigee Edge יוסיף לה באופן דינמי טבלאות עובדות חדשות בזמן הריצה. רכיב השרת של Postgres יצבור את נתוני העובדות לטבלאות מסכמות שנטענות ומוצגות בממשק המשתמש החדש של Edge.
אנטי-תבנית
לא מומלץ להוסיף עמודות בהתאמה אישית, טבלאות או תצוגות לאף אחת מהסכימות שבבעלות Apigee במסד הנתונים של Postgres בסביבות ענן פרטי ישירות באמצעות שאילתות SQL, כי יכולות להיות לכך השלכות שליליות.
נשתמש בדוגמה כדי להסביר את זה בפירוט.
נניח שיצרתם טבלה בהתאמה אישית בשם account בסכימת Analytics, כמו שמוצג כאן:
אחרי זמן מה, נניח שצריך לשדרג את Apigee Edge מגרסה נמוכה יותר לגרסה גבוהה יותר. שדרוג של 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.