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

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

   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". אם תקבלו בהמשך מסד נתונים חדש עם שם קובץ שונה, תצטרכו רק לעדכן את הקישור הסמלי ולא להגדיר מחדש את שרת Qpid ולהפעיל אותו מחדש.

7. משנים את הבעלות על הקובץ qpid-server.properties למשתמש apigee:

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

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

   /opt/apigee/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/management-ui.properties כדי להפעיל את מפות גיאוגרפיות. אם הקובץ הזה לא קיים, יוצרים אותו:

   conf_uebe_disableGeoMap=false

2. שינוי הבעלות על הקובץ management-ui.properties למשתמש apigee:

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

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

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

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

עדכון מסד הנתונים של 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/apigee-service/bin/apigee-service edge-qpid-server restart

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