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

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

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

כדי להשתמש בצבירה גיאוגרפית, צריך לרכוש את מסד הנתונים 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/bin/apigee-service/bin/apigee-service edge-qpid-server restart

9. חוזרים על התהליך הזה בכל צומת Qpid.
10. כדי לוודא שהצבירה הגיאוגרפית פועלת:
    1. מפעילים כמה קריאות ל-API proxy בדוגמה של API proxy.
    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:

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

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

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

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 restart

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