הפעלת צבירה גיאוגרפית ומפות גיאוגרפיות

Edge for Private Cloud גרסה 4.17.05

צבירת נתונים גיאוגרפיים מאפשרת לאסוף נתוני ניתוח של קריאות ל-API, על סמך מאפיינים גיאוגרפיים כמו אזור, יבשת, מדינה ועיר. מתוך נתוני הניתוח האלה, תוכלו לראות מפה גיאוגרפית בממשק המשתמש של Edge שמראה את המיקום של בקשות API:

צבירת נתונים גיאוגרפיים מתבצעת על ידי חילוץ נתונים גיאוגרפיים ממסד נתונים של צד שלישי והוספתם לנתוני הניתוח שנאספו על ידי Edge. הפרטים הגיאוגרפיים יכולים לכלול את העיר, המדינה, היבשת, אזור הזמן והאזור של בקשה שנשלחה לשרת proxy של API.

כדי להשתמש בצבירה גיאוגרפית, עליכם לרכוש את מסד הנתונים Maxmind GeoIp2 שמכיל את המידע הגיאוגרפי הזה. מידע נוסף זמין בכתובת https://www.maxmind.com/en/geoip2-databases.

הפעלת צבירה לפי מיקום גיאוגרפי

כברירת מחדל, צבירת הנתונים לפי מיקום גיאוגרפי לא מופעלת. כדי להפעיל צבירת נתונים גיאוגרפיים, צריך:

• בכל שרתי Qpid, מתקינים את מסד הנתונים MaxMind ומגדירים את שרת ה-Qpid להשתמש בו.
• הפעלת תצוגת המפה הגיאוגרפית בממשק המשתמש של Edge.

התקנת מסד הנתונים של MaxMind בכל שרתי Edge Qpid

כדי להתקין את מסד הנתונים MaxMind בכל שרתי Edge Qpid, צריך להשתמש בתהליך הבא:

1. משיגים את מסד הנתונים Maxmind GeoIp2.
   הערה: צבירת נתונים גיאוגרפיים מתבצעת על ידי הוספת נתונים גיאוגרפיים ממסד נתונים של צד שלישי לנתוני הניתוח שנאספים על ידי Edge. כדי להשתמש בצבירה לפי מיקום גיאוגרפי, עליכם לרכוש את מסד הנתונים Maxmind GeoIp2 שמכיל את המידע הזה. מידע נוסף זמין בכתובת https://www.maxmind.com/en/geoip2-databases.
2. יוצרים את התיקייה הבאה בצומת שרת ה-Qpid:
   /opt/apigee/maxmind
3. מורידים את מסד הנתונים Maxmind GeoIp2 אל /opt/apigee/maxmind.
4. משנים את הבעלות על קובץ מסד הנתונים למשתמש 'apigee':
   > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
5. מגדירים את ההרשאות במסד הנתונים לערך 744:
   > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
6. צריך להגדיר את האסימונים הבאים ב-/opt/apigee/customer/application/qpid-server.properties. אם הקובץ לא קיים, יוצרים אותו:
   conf_ingestboot-service_vdim.geo.ingest.enabled=true
   conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
   
   
   
   שימו לב שקובץ מסד הנתונים הזה מכיל מספר גרסה. אם בשלב מאוחר יותר יתקבל קובץ מעודכן של מסד הנתונים, יכול להיות שיש לו מספר גרסה אחר. לחלופין, יוצרים קישור סמלי לקובץ מסד הנתונים ומשתמשים ב-symlink ב-qpid-server.properties.
   
   לדוגמה, אפשר ליצור קישור סימבולי עבור "GeoIP2-City-current.mmdb" ל-"GeoIP2-City_20160127.mmdb". אם מאוחר יותר יתקבל מסד נתונים חדש עם שם קובץ אחר, צריך רק לעדכן את הקישור הסמלי ולא להגדיר מחדש את שרת ה-Qpid ולהפעיל אותו מחדש.
7. משנים את הבעלות על הקובץ qpid-server.properties למשתמש 'apigee':
   > chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
8. מפעילים מחדש את שרת ה-Qpid:
   > /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server מחדש
9. חוזרים על התהליך בכל צומת Qpid.
10. כדי לוודא ש צבירת הנתונים הגיאוגרפיים פועלת:
    1. הפעלה של מספר קריאות לשרת proxy ל-API על שרת proxy לדוגמה של API.
    2. ממתינים כ-5-10 דקות להשלמת הצבירה.
    3. פותחים מסוף ומתחברים לשרת Edge Postgres:
       > psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. צריך לבצע שאילתת SELECT בטבלה analytics.agg_geo כדי להציג את השורות עם מאפיינים גיאוגרפיים:
       apigee=# select * מתוך analytics.agg_geo;
       
       יופיעו העמודות הבאות בתוצאות השאילתה, שנשלפו ממסד הנתונים של Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_geo_city
       
       אם הטבלה agg_geo לא מאוכלסת, מומלץ לבדוק את יומני השרת של Qpid בכתובת /opt/apigee/var/log/edge-qpid-server/logs/ כדי לזהות חריגים אפשריים.

הפעלת מפות גיאוגרפיות בממשק המשתמש של Edge

כדי להפעיל מפות גיאוגרפיות בממשק המשתמש של Edge, מבצעים את התהליך הבא:

1. צריך להגדיר את האסימון הבא בנתיב /opt/apigee/customer/application/ui.properties כדי להפעיל את 'מפות גיאוגרפי'. אם הקובץ לא קיים, יוצרים אותו:
   conf_apigee_apigee.feature.disablegeomap=false
2. שינוי הבעלות על הקובץ ui.properties למשתמש 'apigee':
   > chown apigee:apigee /opt/apigee/customer/application/ui.properties
3. מפעילים מחדש את ממשק המשתמש של Edge:
   > /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui הפעלה מחדש
4. בממשק המשתמש של Edge, לוחצים על Analytics > GeoMap כדי להציג את נתוני הצבירה הגיאוגרפית.

עדכון מסד הנתונים של MaxMind GeoIp2

MaxMind מנפיקה עדכונים תקופתיים למסד הנתונים של Maxmind GeoIp2. אם מתקבל מסד נתונים מעודכן, צריך להתקין אותו ב-Edge:

1. השג את מסד הנתונים המעודכן של Maxmind GeoIp2.
2. מורידים את מסד הנתונים Maxmind GeoIp2 אל /opt/apigee/maxmind.
3. יש לבדוק את שם קובץ מסד הנתונים. אם הוא זהה לקובץ הישן, כפי שמוגדר ב-/opt/apigee/customer/application/qpid-server.properties, ממשיכים לשלב הבא. עם זאת, אם לקובץ יש שם אחר, צריך לערוך את הקובץ qpid-server.properties כך שיציין את שם קובץ מסד הנתונים החדש ולאחר מכן להפעיל מחדש את שרת ה-Qpid כפי שמתואר למעלה.
   
   לחלופין, אפשר ליצור קישור סמלי לקובץ. לדוגמה, אפשר ליצור קישור סימבולי עבור "GeoIP2-City-current.mmdb" ל-"GeoIP2-City_20160127.mmdb". אם בשלב מאוחר יותר יתקבל מסד נתונים חדש עם שם קובץ אחר, צריך רק לעדכן את הקישור הסמלי ולא להגדיר מחדש את שרת ה-Qpid.
4. משנים את הבעלות על קובץ מסד הנתונים למשתמש 'apigee':
   > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
5. מגדירים את ההרשאות במסד הנתונים לערך 744:
   > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
6. מפעילים מחדש את שרת ה-Qpid:
   > /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server מחדש
7. חוזרים על התהליך בכל צומת Qpid.