הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge
במאמר הזה מוצג Apigee API Analytics, שמאפשר ניטור תפעולי מעמיק של מקרים ספציפיים של שער Apigee. הוא מספק נתונים מפורטים לצורך חקירת בעיות ברמת ה-proxy בסביבה אחת. בעזרת Apigee API Analytics, אפשר לגשת לדוחות מפורטים, כולל מדדי יעד וניתוח של מפתחים.
שיפור ה-API באמצעות ניתוח נתונים
Apigee API Analytics אוסף ומחשב כמות גדולה של מידע שזורם דרך proxy ל-API. אפשר להציג את הנתונים האלה בתרשימים ובגרפים בממשק המשתמש של Apigee, או להוריד את הנתונים הגולמיים לניתוח אופליין באמצעות ממשקי ה-API של Apigee.
בעזרת ניתוח הנתונים תוכלו לקבל תשובות לשאלות נפוצות, כמו:
- מהי המגמה של התנועה ב-API לאורך זמן?
- אילו שיטות API הכי פופולריות?
- מי הם המפתחים המובילים שלי?
- מתי זמני התגובה של ה-API הכי מהירים? הכי איטי?
- מבחינה גיאוגרפית, מאיפה מגיעה הכי הרבה תנועה ל-API?
- כמה הכנסות נוצרו מהעסקאות?
אתם יכולים לנתח נתונים של שם מארח ספציפי או של סביבה שלמה.
התשובות לשאלות כאלה עוזרות לכם לשפר את ממשקי ה-API, לפתור בעיות ולקבל החלטות עסקיות טובות יותר שקשורות לתוכנית ה-API שלכם.
ניתוח נתוני API עוזר לכולם להשתפר
בעזרת תהליך מתמשך של איסוף, ניתוח והצגה חזותית של נתונים, Apigee API Analytics עוזר לצוות ה-API לשפר את ממשקי ה-API שלו ולמפתחי האפליקציות לשפר את האפליקציות שלהם:
- צוות ה-API – צוות ה-API משתמש במערכות פנימיות כדי ליצור ממשקי API מעניינים. צוות ה-API רוצה לדעת מה מצב תוכנית ה-API באופן כללי, מה מצב ממשקי ה-API השונים ואיך אפשר לשפר אותם.
- מפתחי אפליקציות – שיתוף מידע ניתוח עם מפתחי אפליקציות מאפשר לכם לקבל אפליקציות טובות יותר. המפתחים האלה מחדשים באמצעות ה-API שלכם ויוצרים אפליקציות קריאטיביות שעוזרות להגדיל את ההכנסות של הארגון. ניתוח הנתונים עוזר למפתחי אפליקציות להבין את הביצועים של האפליקציות שלהם ואת התרומה שלהן לשורה התחתונה של הארגון. מפתחי אפליקציות רוצים לדעת איך הם יכולים לשפר את האפליקציות שלהם.
- צוות התפעול – צוות התפעול רוצה להבין את דפוסי התנועה ולצפות מתי צריך להוסיף משאבי קצה עורפי או לבצע שינויים קריטיים אחרים.
- בעל העסק – בעל העסק רוצה לדעת אם ההשקעה שלו ב-API משתלמת ואיפה כדאי להשקיע ב-API בעתיד.
איך מתחילים להשתמש ב-Apigee API Analytics?
סוג הארגון של Apigee שבו אתם משתמשים יקבע את השלבים שנדרשים כדי להתחיל להשתמש ב-Apigee API Analytics. אם אתם לא בטוחים אם אתם משתמשים בארגון Apigee עם מינוי או עם תשלום לפי שימוש, פנו לאדמין של ארגון Apigee שלכם.
מידע על שימוש ב-Apigee API Analytics עם Apigee Hybrid זמין במאמר דרישות Apigee Hybrid.
שימוש ב-Apigee API Analytics בארגון עם מינוי
אם יש לכם מינוי ל-Apigee, הגישה ל-Apigee API Analytics כלולה בהרשאות המינוי ומופעלת אוטומטית בכל אחד מהסביבות של Apigee.
אתם יכולים לגשת לנתוני הניתוח של הארגון עם המינוי באמצעות ממשק המשתמש של Apigee במסוף Cloud או Apigee API. מידע נוסף זמין במאמר איך ניגשים לנתוני הניתוח.
שימוש ב-Apigee API Analytics בארגון עם תשלום לפי שימוש
אם אתם לקוחות בתוכנית Pay-as-you-go, אתם צריכים להפעיל את Apigee API Analytics כתוסף בתשלום כדי להתחיל להשתמש בנתוני הניתוח. מידע נוסף על הפעלת התוסף Apigee API Analytics בסביבות ביניים או בסביבות מקיפות של Apigee זמין במאמר ניהול התוסף Apigee API Analytics.
אחרי שמפעילים את התוסף Apigee API Analytics בסביבות שלכם, אפשר לגשת לנתוני הניתוח ולנהל את התוסף Apigee API Analytics באמצעות ממשק המשתמש של Apigee במסוף Cloud או באמצעות Apigee API. מידע נוסף זמין במאמר איך ניגשים לנתוני הניתוח. נתוני Analytics וניהול תוספים לא זמינים בממשק המשתמש הקלאסי של Apigee בארגונים עם תשלום לפי שימוש.
אילו סוגי נתונים נאספים ומנותחים?
Apigee API Analytics אוסף ומנתח מגוון רחב של נתונים שזורמים דרך שרתי proxy של API, כמו:
- מועד התשובה
- זמן האחזור של הבקשה
- גודל הבקשה
- שגיאות שקשורות ליעד
- שם מוצר ה-API
- כתובת האימייל של המפתח או מזהה קבוצת האפליקציות
- שם האפליקציה
- הכנסות מעסקאות
רשימה מלאה של הנתונים שנאספים על ידי API Analytics זמינה במאמר הפניה למדדים, למאפיינים ולמסננים של Analytics.
איך אוספים נתוני ניתוח בהתאמה אישית?
מערכת Apigee אוספת באופן מובנה כמות גדולה של נתונים. אולי תרצו גם לאסוף נתוני ניתוח בהתאמה אישית שספציפיים לשרתי ה-proxy של ה-API, לאפליקציות, למוצרים או למפתחים שלכם. לדוגמה, יכול להיות שתרצו לאסוף נתונים אנליטיים מפרמטרים של שאילתות, מכותרות של בקשות, מגופי בקשות ותגובות או ממשתנים שאתם מגדירים בממשקי ה-API.
אתם יכולים לאסוף נתוני ניתוח בהתאמה אישית באמצעות המדיניות DataCapture, ואז להשתמש בממשק המשתמש או ב-API של Analytics כדי לבדוק את הנתונים שנאספו.
מתי הנתונים של ניתוח האתרים שלי זמינים ולמשך כמה זמן הם נשמרים?
יש שני מרווחי זמן שקובעים מתי וכמה זמן אפשר לצפות בנתוני Analytics:
- מרווח הזמן של עיכוב הנתונים – אחרי שמתבצעת קריאה ל-proxy ל-API, יכול לעבור עד 10 דקות עד שהנתונים יהיו זמינים להצגה או דרך קריאות ל-API.
- זמינות ב-Analytics – תקופת השמירה של נתוני Analytics היא 14 חודשים.
שמירת נתונים ב-Analytics כשמשתמשים בתוסף Apigee API Analytics
אם יש לכם ארגון עם תשלום לפי שימוש, אתם יכולים להפעיל את התוסף Apigee API Analytics ברמת הסביבה. אחרי שמפעילים את התוסף בסביבה מסוימת, נתוני הניתוח של הסביבה נשמרים למשך 14 חודשים. אפשר לגשת לנתוני ניתוח היסטוריים של הסביבה מהדף מדדי API במסוף, כל עוד התוסף מופעל.
אם משביתים את התוסף Apigee API Analytics בסביבה בארגון עם תשלום לפי שימוש, נתוני הניתוח של הסביבה נמחקים אחרי 30 יום. אם תפעילו מחדש את התוסף באותו סביבה תוך 30 יום מההשבתה, תוכלו לקבל שוב גישה לנתוני הניתוח של הסביבה למשך תקופת השמירה של 14 חודשים. אם מפעילים מחדש את התוסף בסביבה אחרי 30 יום, לא מתבצע שחזור של נתונים.
אם אתם רוצים לשמור נתונים אנליטיים של סביבה כלשהי בארגון עם תשלום לפי שימוש מעבר לתקופת השמירה של 14 חודשים, מומלץ לייצא את הנתונים ולשמור אותם במיקום אחר. מומלץ גם לייצא את נתוני Analytics לפני השבתת התוסף Apigee API Analytics, או במהלך 30 הימים שלאחר ההשבתה. מידע נוסף זמין במאמר ייצוא נתונים מ-Analytics.
איפה הנתונים של Analytics מאוחסנים ומעובדים?
המיקום שבו נתוני הניתוח מאוחסנים ומעובדים נקבע לפי האזור של Analytics, שציינתם כשביצעתם את ההתקנה של Apigee:
- אם אתם לקוחות של מינוי והתקנתם את Apigee באמצעות אשף ההקצאה של Apigee, ציינתם את אזור הניתוח שלכם ב שלב 3: הגדרת אירוח והצפנה באשף ההקצאה, כשבחרתם את אזור הניתוח.
- אם אתם לקוחות עם תשלום לפי שימוש והתקנתם את Apigee באמצעות מסוףGoogle Cloud , ציינתם את האזור של Analytics ב שלב 3: הגדרת אירוח והצפנה באשף הקצאת ההרשאות, כשבחרתם את האזור של Analytics.
-
אם התקנתם את Apigee משורת הפקודה כלקוחות במינוי או בשיטת התשלום 'משלמים לפי השימוש', ציינתם את אזור הניתוח כשהגדרתם את משתנה הסביבה
ANALYTICS_REGION, כפי שמתואר במאמרים הבאים:- עם VPC peering: שלב 1: הגדרת משתני סביבה
- ללא VPC peering: שלב 1: הגדרת משתני סביבה
-
אם התקנתם את Apigee באמצעות
אפשרות ההתקנה בלחיצה אחת, נתוני הניתוח מאוחסנים באזור
us-west1. אי אפשר לשנות את מיקום ברירת המחדל.
הנתונים ב-Analytics נשמרים ומעובדים באופן הבא:
- באזורים גיאוגרפיים של ניתוח נתונים שלא בארה"ב או באיחוד האירופי, נתוני הניתוח מאוחסנים ומעובדים באזור הגיאוגרפי של ניתוח הנתונים.
- באזורי ניתוח נתונים בארה"ב או באיחוד האירופי, הנתונים מאוחסנים באזור רב-אזורי בארה"ב או באיחוד האירופי, בהתאמה, כדי להבטיח זמינות גבוהה יותר.
איך ניגשים לנתוני הניתוח?
Apigee API Analytics מספק כלי ויזואליזציה של נתונים שמוטמעים בממשק המשתמש של Apigee. הכלים האלה כוללים לוחות בקרה מוגדרים מראש לניתוח נתונים ודוחות בהתאמה אישית שמציגים נתונים בתרשימים ובגרפים, ומאפשרים לכם להציג פירוט כדי לראות נתונים שמקובצים לפי מאפיינים שונים (למשל לפי proxy ל-API, כתובת IP או קוד סטטוס של HTTP).
אפשר גם להוריד נתוני ניתוח באמצעות Apigee API. אחרי ההורדה, תוכלו לייבא את הנתונים האלה לכלי משלכם להצגת נתונים בתצוגה חזותית או למערכת ניתוח.
מרכזי בקרה של Analytics
ממשק המשתמש של Apigee כולל קבוצה של מרכזי בקרה מוגדרים מראש שבהם אפשר לראות נתונים של ניתוח.
Apigee במסוף Cloud
כדי לפתוח את לוחות הבקרה של Analytics (בארגונים עם תשלום לפי שימוש או מינוי):
במסוף Google Cloud , נכנסים לדף Apigee > Analytics > API metrics.
בתמונה הבאה מוצג לוח הבקרה API Proxy Performance:
בוחרים אחת מהכרטיסיות הבאות כדי לראות את מרכזי הבקרה:
מידע נוסף זמין במאמר שימוש בלוחות הבקרה של ניתוח הנתונים.
דוחות מותאמים אישית
דוחות בהתאמה אישית מאפשרים לכם להתעמק במדדים ספציפיים של ה-API ולראות את הנתונים המדויקים שאתם רוצים לראות. אתם יכולים ליצור דוח בהתאמה אישית באמצעות כל נתוני הניתוח שמוטמעים ב-Apigee.
כשיוצרים דוח בהתאמה אישית, בוחרים את הנתונים שרוצים לראות (מדדים), מקבצים את הנתונים בדרכים משמעותיות (מאפיינים) ואם רוצים, מגבילים את הנתונים שמוחזרים על סמך מאפיינים ספציפיים של הנתונים (סינון).
אפשר גם להגדיר את סוג התרשים שיוצג בדוח בהתאמה אישית כתרשים עמודות או כתרשים קו. בתמונות הבאות מוצגות דוגמאות לתרשימים של עסקאות לשנייה שמקובצות לפי proxy ל-API:
עמודה – כל proxy ל-API מיוצג על ידי עמודה אחרת:
קו – כל proxy ל-API מיוצג על ידי קו אחר:
מידע נוסף מופיע במאמר בנושא יצירה וניהול של דוחות בהתאמה אישית.
Analytics API
משתמשים ב-Apigee API כדי להוריד נתוני ניתוח. לדוגמה, אפשר להשתמש ב-API כדי ליצור כלי ויזואליזציה משלכם שאפשר להטמיע בפורטלים או באפליקציות בהתאמה אישית.
הנה דוגמה לקריאה ל-API כדי לאחזר נתוני ניתוח של שרתי proxy של API:
curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/stats/apiproxy?select=sum(message_count)&timeRange=6/24/2022%2000:00~6/25/2022%2023:59&timeUnit=hour" \ -H "Authorization: Bearer $TOKEN"
הקריאה הזו מחזירה:
- סכום הבקשות (מספר ההודעות) לכל proxy ל-API
- לתקופה של 24 שעות
- הנתונים מקובצים לפי שעה
פרמטר השאילתה timeRange מציין את פרק הזמן בפורמט הבא:
?timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM
שימו לב ל-%20 לפני HH:MM. הפרמטר timeRange דורש תו רווח שעבר קידוד לכתובת URL לפני HH:MM, או את התו +, כמו בדוגמה הבאה:
MM/DD/YYYY+HH:MM~MM/DD/YYYY+HH:MM.
מידע נוסף זמין במאמר שימוש ב-Metrics API.
ייצוא נתוני ניתוח ל-Google Cloud Platform
אתם יכולים להשתמש ב-Apigee API כדי לייצא את כל נתוני הניתוח של יום שלם מ-Apigee למאגר נתונים משלכם, כמו Google Cloud Storage או BigQuery. לאחר מכן תוכלו להשתמש ביכולות החזקות של שאילתות ולמידת מכונה שמוצעות על ידי Google Cloud BigQuery ו-TensorFlow כדי לבצע ניתוח נתונים משלכם.
מידע נוסף זמין במאמר ייצוא נתונים מ-Analytics.
איך משתפים נתונים עם מפתחי אפליקציות?
אם אתם רואים במפתחי אפליקציות את הלקוחות שלכם, אתם רוצים לוודא שיש להם את הכלים והמידע שזמינים להם כדי להפיק את המרב מה-API שלכם.
מפתחי אפליקציות לא מתעניינים רק באיכות האפליקציות שלהם, אלא גם בממשקי ה-API שלכם. פורטל המפתחים שמבוסס על Drupal כולל דף אופציונלי בשם App Performance (ביצועי האפליקציה), שנועד לתת למפתחי אפליקציות גישה למדדים חשובים לגבי האפליקציות שלהם. בדף הזה מפתחים יכולים למצוא מידע על:
- שגיאות: אילו שגיאות API מוצגות באפליקציה שלי?
- ביצועים: האם ה-API איטי? אילו methods של API בדרך כלל איטיים או איטיים כרגע?
- זמינות: האם ממשק ה-API פועל או לא?
- מכסה: האם יש מכסה ל-API? ואם אני מפתח אפליקציות, איך אני יכול לדעת מה מצב השימוש שלי ביחס למכסה?
מידע נוסף זמין במאמר Monitor apps בתיעוד של Drupal 8.
בנוסף, אתם יכולים לשתף את ניתוח הנתונים עם המפתחים שלכם באופן הבא:
- יצירת דוחות בהתאמה אישית ושיתוף שלהם עם מפתחי האפליקציות. מידע נוסף מופיע במאמר בנושא יצירה וניהול של דוחות בהתאמה אישית.
- שימוש בממשקי ה-API של המדדים כדי לתעד נתונים לאורך תקופה ארוכה יותר ולשתף אותם עם מפתחי האפליקציות אופליין. מידע נוסף זמין במאמר שימוש ב-Metrics API.
איך אפשר ליצור נתוני ניתוח מלאים?
מה הכוונה בניתוח נתונים מלא? לדוגמה, אתם יכולים ליצור proxy ל-API ומערכת Apigee תאסוף נתוחי נתונים לגבי ה-proxy הזה. אבל מה לגבי מדדים למפתחים או לאפליקציה שקראו ל-proxy ל-API? אם מערכת Apigee לא יודעת מי ביצע קריאה ל-API, היא לא יכולה לאסוף את הנתונים האלה.
כדי ש-Apigee יוכל לזהות אילו מפתחים ואילו אפליקציות למפתחים קוראים לשרתי ה-proxy של ה-API, צריך לבצע כמה שלבים. הנה רשימה של השלבים האלה עם קישורים למידע מפורט יותר:
- יוצרים מוצר API אחד או יותר, שהוא קבוצה של שרתי proxy ל-API יחד עם תוכנית שירות. מידע נוסף זמין במאמר בנושא ניהול מוצרי API.
- רישום מפתחי אפליקציות ב-Apigee. הרשמה של מפתחי אפליקציות
- רישום אפליקציות וניהול מפתחות API עבור המפתחים. הרשמה של אפליקציות וניהול של מפתחות API
- מוסיפים מדיניות אבטחה לפרוקסי של ה-API כדי לאמת מפתחות API או טוקנים של אבטחה. אפשר לעיין בנושאים הבאים: מדיניות VerifyAPIKey, מדיניות OAuthV2 ומדיניות VerifyJWT.
במדריכים הבאים מפורטים השלבים הנדרשים כדי לראות ניתוח נתונים למפתחים ולאפליקציות: אבטחת API באמצעות דרישה של מפתחות API ואבטחת API באמצעות OAuth.
DRZ ועמידה בדרישות FedRAMP
התאימות של Apigee API Analytics למיקום נתונים (DRZ) היא לנתונים במנוחה. מידע נוסף זמין במאמר בנושא מיקום אחסון הנתונים ב-Apigee.
הדרישות של Apigee Hybrid
בקטע הזה מפורט מידע חשוב למשתמשי Apigee hybrid.
דרישות כלליות
כדי להשתמש ב-Apigee API Analytics עם Apigee Hybrid:
- צריך להגדיר את חשבון השירות
apigee-udca. מידע נוסף מופיע במאמר בנושא יצירת שינויים בהגדרות ברירת המחדל. - מוודאים שהשעונים בכל הצמתים של הכלי לסנכרון מסונכרנים ומוגדרים לפי שעון UTC.
תמיכה במיקום אחסון הנתונים
אם יצרתם ארגון חדש ב-Apigee Hybrid v1.13.1 עם הפעלה של מיקום אחסון הנתונים, אתם צריכים לפעול לפי השלבים במאמר שימוש במיקום אחסון הנתונים ב-Apigee Hybrid.
בגרסה 1.14 או בגרסאות חדשות יותר של נתונים משולבים, צינור הנתונים החדש הוא ברירת המחדל לכל הארגונים שמשתמשים בנתונים משולבים, בלי קשר להפעלה או להשבתה של שמירת נתונים.