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

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

   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 > 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.