การรวมทางภูมิศาสตร์ช่วยให้คุณรวบรวมข้อมูลการวิเคราะห์สำหรับการเรียก API ตามแอตทริบิวต์ทางภูมิศาสตร์ เช่น ภูมิภาค ทวีป ประเทศ และเมือง จากข้อมูลวิเคราะห์นี้ คุณจะดูแผนที่ภูมิศาสตร์ใน UI ของ Edge ที่แสดงตำแหน่งของคำขอ API ได้โดยทำดังนี้
การรวมภูมิศาสตร์ทำงานโดยการดึงข้อมูลทางภูมิศาสตร์จากฐานข้อมูลของบุคคลที่สาม แล้วเพิ่มลงในข้อมูลการวิเคราะห์ที่ Edge รวบรวมไว้ ข้อมูลทางภูมิศาสตร์อาจมีเมือง ประเทศ ทวีป เขตเวลา และภูมิภาคของคำขอที่ส่งไปยังพร็อกซี API
หากต้องการใช้การรวมภูมิศาสตร์ คุณต้องซื้อฐานข้อมูล Maxmind GeoIp2 ที่มีข้อมูลทางภูมิศาสตร์นี้ ดูข้อมูลเพิ่มเติมได้ที่ https://www.maxmind.com/en/geoip2-databases
การเปิดใช้การรวมข้อมูลทางภูมิศาสตร์
โดยค่าเริ่มต้น การรวมทางภูมิศาสตร์จะไม่ได้เปิดใช้งานไว้ หากต้องการเปิดใช้การรวมภูมิศาสตร์ คุณต้องทำดังนี้
- ในเซิร์ฟเวอร์ Qpid ทั้งหมด ให้ติดตั้งฐานข้อมูล MaxMind และกำหนดค่าเซิร์ฟเวอร์ Qpid เพื่อใช้งาน
- เปิดใช้การแสดงแผนที่ภูมิศาสตร์ใน Edge UI
ติดตั้งฐานข้อมูล MaxMind ในเซิร์ฟเวอร์ Edge Qpid ทั้งหมด
ใช้ขั้นตอนต่อไปนี้เพื่อติดตั้งฐานข้อมูล MaxMind ในเซิร์ฟเวอร์ Edge Qpid ทั้งหมด
- รับฐานข้อมูล Maxmind GeoIp2
- สร้างโฟลเดอร์ต่อไปนี้ในโหนดเซิร์ฟเวอร์ Qpid:
/opt/apigee/maxmind
- ดาวน์โหลดฐานข้อมูล Maxmind GeoIp2 ไปยัง
/opt/apigee/maxmind
- เปลี่ยนการเป็นเจ้าของไฟล์ฐานข้อมูลเป็นผู้ใช้ "apigee":
chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- ตั้งค่าสิทธิ์ในฐานข้อมูลเป็น 744 ดังนี้
chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- ตั้งค่าโทเค็นต่อไปนี้ใน
/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" หากได้รับฐานข้อมูลใหม่ที่มีชื่อไฟล์ต่างกันในภายหลัง คุณเพียงต้องอัปเดต Symlink โดยไม่ต้องกำหนดค่าใหม่และรีสตาร์ทเซิร์ฟเวอร์ Qpid
- เปลี่ยนการเป็นเจ้าของไฟล์
qpid-server.properties
เป็นผู้ใช้ "apigee":chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
- รีสตาร์ทเซิร์ฟเวอร์ Qpid โดยทำดังนี้
/opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
- ทำขั้นตอนนี้ซ้ำในทุกโหนด Qpid
- หากต้องการตรวจสอบว่าการรวมทางภูมิศาสตร์ใช้งานได้ ให้ทำดังนี้
- ทริกเกอร์การเรียกพร็อกซี API หลายรายการในพร็อกซี API ตัวอย่าง
- รอประมาณ 5-10 นาทีเพื่อให้การรวมเสร็จสมบูรณ์
- เปิดคอนโซลและเชื่อมต่อกับเซิร์ฟเวอร์ Edge Postgres โดยทำดังนี้
psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
- ดำเนินการค้นหา 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/
เพื่อตรวจหาข้อยกเว้นที่อาจเกิดขึ้น
เปิดใช้แผนที่ภูมิศาสตร์ใน UI ของ Edge
ทําตามขั้นตอนต่อไปนี้เพื่อเปิดใช้แผนที่ภูมิศาสตร์ใน UI ของ Edge
- ตั้งค่าโทเค็นต่อไปนี้ใน
/opt/apigee/customer/application/ui.properties
เพื่อเปิดใช้ Geo Maps หากไม่มีไฟล์ดังกล่าว ให้สร้างขึ้นมาโดยทำดังนี้conf_apigee_apigee.feature.disablegeomap=false
- เปลี่ยนการเป็นเจ้าของไฟล์ ui.properties เป็นผู้ใช้ "apigee"
chown apigee:apigee /opt/apigee/customer/application/ui.properties
- รีสตาร์ท UI ของ Edge โดยทำดังนี้
/opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
- ใน Edge UI ให้เลือก Analytics > แผนที่ภูมิศาสตร์ เพื่อแสดงข้อมูลการรวมทางภูมิศาสตร์
การอัปเดตฐานข้อมูล MaxMind GeoIp2
MaxMind จะออกการอัปเดตฐานข้อมูล Maxmind GeoIp2 เป็นระยะๆ หากได้รับฐานข้อมูลที่อัปเดตแล้ว ให้ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้งฐานข้อมูลใน Edge
- รับฐานข้อมูล Maxmind GeoIp2 ที่อัปเดตแล้ว
- ดาวน์โหลดฐานข้อมูล Maxmind GeoIp2 ไปยัง
/opt/apigee/maxmind
- ตรวจสอบชื่อไฟล์ฐานข้อมูล หากเป็นไฟล์เดิมตามที่ระบุไว้ใน
/opt/apigee/customer/application/qpid-server.properties
ให้ไปยังขั้นตอนถัดไป อย่างไรก็ตาม หากไฟล์มีชื่อต่างกัน คุณจะต้องแก้ไขไฟล์qpid-server.properties
เพื่อระบุชื่อไฟล์ฐานข้อมูลใหม่ จากนั้นรีสตาร์ทเซิร์ฟเวอร์ Qpid ตามที่อธิบายไว้ข้างต้นคุณสามารถสร้าง symlink ไปยังไฟล์แทนได้ เช่น สร้างลิงก์สัญลักษณ์สำหรับ "GeoIP2-City-current.mmdb" เป็น "GeoIP2-City_20160127.mmdb" หากได้รับฐานข้อมูลใหม่ที่มีชื่อไฟล์เป็นอย่างอื่นในภายหลัง คุณเพียงต้องอัปเดต symlink โดยไม่ต้องกำหนดค่าเซิร์ฟเวอร์ Qpid ใหม่
- เปลี่ยนการเป็นเจ้าของไฟล์ฐานข้อมูลเป็นผู้ใช้ "apigee":
chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- ตั้งค่าสิทธิ์ในฐานข้อมูลเป็น 744 ดังนี้
chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
- รีสตาร์ทเซิร์ฟเวอร์ Qpid โดยทำดังนี้
/opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
- ทำขั้นตอนนี้ซ้ำในทุกโหนด Qpid