การเปิดใช้งานการรวมข้อมูลทางภูมิศาสตร์และแผนที่ภูมิศาสตร์

Edge for Private Cloud v4.18.01

การรวมข้อมูลทางภูมิศาสตร์ช่วยให้คุณรวบรวมข้อมูลวิเคราะห์สำหรับการเรียก API ตามแอตทริบิวต์ทางภูมิศาสตร์ เช่น ภูมิภาค ทวีป ประเทศ และเมือง จากข้อมูลวิเคราะห์นี้ คุณสามารถดูแผนที่ภูมิศาสตร์ใน Edge UI ที่แสดงตำแหน่งของคำขอ API ได้โดยทำดังนี้

การรวมข้อมูลทางภูมิศาสตร์ทำงานโดยการดึงข้อมูลทางภูมิศาสตร์จากฐานข้อมูลของบุคคลที่สามและเพิ่มลงในข้อมูลการวิเคราะห์ที่ Edge รวบรวมไว้ ข้อมูลทางภูมิศาสตร์อาจประกอบด้วยเมือง ประเทศ ทวีป เขตเวลา และภูมิภาคของคำขอที่ส่งไปยังพร็อกซี API

หากต้องการใช้การรวมข้อมูลทางภูมิศาสตร์ คุณต้องซื้อฐานข้อมูล Maxmind GeoIp2 ที่มีข้อมูลทางภูมิศาสตร์นี้ ดูข้อมูลเพิ่มเติมได้ที่ https://www.maxmind.com/en/geoip2-databases

การเปิดใช้การรวมข้อมูลทางภูมิศาสตร์

โดยค่าเริ่มต้น ระบบจะไม่เปิดใช้การรวมข้อมูลทางภูมิศาสตร์ หากต้องการเปิดใช้การรวมข้อมูลทางภูมิศาสตร์ คุณต้องทำดังนี้

• ติดตั้งฐานข้อมูล MaxMind ในเซิร์ฟเวอร์ Qpid ทั้งหมด และกำหนดค่าเซิร์ฟเวอร์ Qpid ให้ใช้ฐานข้อมูลดังกล่าว
• เปิดใช้การแสดงแผนที่ภูมิศาสตร์ใน Edge UI

ติดตั้งฐานข้อมูล 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. เรียกใช้การเรียกพร็อกซี API หลายครั้งในพร็อกซี 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 UI

ใช้ขั้นตอนต่อไปนี้เพื่อเปิดใช้แผนที่ภูมิศาสตร์ใน Edge UI

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 UI ให้เลือกการวิเคราะห์ > 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" หากได้รับฐานข้อมูลใหม่ที่มีชื่อไฟล์ต่างออกไปในภายหลัง คุณจะต้องอัปเดตเฉพาะ Symlink แทนที่จะต้องกำหนดค่าเซิร์ฟเวอร์ 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