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

צבירת נתונים גיאוגרפיים מאפשרת לאסוף ניתוח נתונים של קריאות ל-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.
   
2. יוצרים את התיקייה הבאה בצומת השרת Qpid:

   /opt/apigee/maxmind

3. צריך להוריד את מסד הנתונים של Maxmind GeoIp2 אל /opt/apigee/maxmind.
4. לשנות את הבעלות על קובץ מסד הנתונים ל-'apigee' user:

   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

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

   שימו לב שקובץ מסד הנתונים הזה מכיל מספר גרסה. אם בהמשך תקבלו עדכון יכול להיות שיש לו מספר גרסה אחר. לחילופין, אפשר ליצור קישור סימבולי כדי את קובץ מסד הנתונים ולהשתמש בקישור הסמלי ב-qpid-server.properties.

   לדוגמה, אפשר ליצור קישור סימבולי עבור 'GeoIP2-City-current.mmdb' אל "GeoIP2-City_20160127.mmdb". אם המיקום מאוחר יותר תקבלו מסד נתונים חדש עם שם קובץ אחר, תצטרכו רק לעדכן symlink במקום להגדיר מחדש את שרת ה-Qpid ולהפעיל אותו מחדש.

7. שינוי הבעלות על הקובץ qpid-server.properties ל-'apigee' user:

   chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties

8. מפעילים מחדש את שרת ה-Qpid:

   /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart

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 כדי להציג את השורות עם מאפיינים גיאוגרפיים:

       select * from analytics.agg_geo;

       העמודות הבאות אמורות להופיע בתוצאות השאילתה, שנשלפות מסד נתונים של Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

       אם הטבלה 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' user:

   chown apigee:apigee /opt/apigee/customer/application/ui.properties

3. מפעילים מחדש את ממשק המשתמש של Edge:

   /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart

4. בממשק המשתמש של Edge, בוחרים באפשרות Analytics > מפה גיאוגרפית להצגת הצבירה הגיאוגרפית .

עדכון מסד הנתונים של 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' user:

   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 restart

7. חוזרים על התהליך בכל צומת Qpid.