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

Edge for Private Cloud v4.18.01

צבירת נתונים גיאוגרפיים מאפשרת לכם לאסוף נתוני ניתוח של קריאות ל-API על סמך מאפיינים גיאוגרפיים כמו אזור, יבשת, מדינה ועיר. מנתוני הניתוח האלה, אפשר להציג GeoMap בממשק המשתמש של 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
   
   אם שמרתם את מסד הנתונים 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 כדי להציג את השורות עם המאפיינים הגיאוגרפיים:
       apigee=# 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.