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

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

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

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

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

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

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

ติดตั้งฐานข้อมูล MaxMind ในเซิร์ฟเวอร์ Qpid ของ Edge ทั้งหมด

ใช้ขั้นตอนต่อไปนี้เพื่อติดตั้งฐานข้อมูล MaxMind ในเซิร์ฟเวอร์ Qpid ของ Edge ทั้งหมด

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/apigee-service/bin/apigee-service edge-qpid-server restart

9. ทำกระบวนการนี้ซ้ำในโหนด Qpid ทุกโหนด
10. วิธีตรวจสอบว่าการรวบรวมข้อมูลทางภูมิศาสตร์ทำงานได้
    1. ทริกเกอร์การเรียกพร็อกซี API หลายรายการในพร็อกซี API ตัวอย่าง
    2. รอประมาณ 5-10 นาทีเพื่อให้การรวบรวมข้อมูลเสร็จสมบูรณ์
    3. เปิดคอนโซลและเชื่อมต่อกับเซิร์ฟเวอร์ Postgres ของ Edge โดยใช้คำสั่งต่อไปนี้

       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/ เพื่อตรวจหาข้อยกเว้นที่อาจเกิดขึ้น

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

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

1. ตั้งค่าโทเค็นต่อไปนี้ใน /opt/apigee/customer/application/management-ui.properties เพื่อเปิดใช้แผนที่ภูมิศาสตร์ หากไม่มีไฟล์ดังกล่าว ให้สร้างขึ้นมา

   conf_uebe_disableGeoMap=false

2. เปลี่ยนการเป็นเจ้าของไฟล์ management-ui.properties เป็นผู้ใช้ apigee โดยใช้คำสั่งต่อไปนี้

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

3. รีสตาร์ท UI ของ New Edge โดยใช้คำสั่งต่อไปนี้

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

4. ใน UI ของ New Edge ให้เลือกวิเคราะห์ > ผู้ใช้ปลายทาง > 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/apigee-service/bin/apigee-service edge-qpid-server restart

7. ทำกระบวนการนี้ซ้ำในโหนด Qpid ทุกโหนด