Bật tổng hợp địa lý và bản đồ địa lý

Tính năng tổng hợp vị trí địa lý giúp bạn thu thập dữ liệu phân tích cho các lệnh gọi API dựa trên những thuộc tính địa lý như khu vực, châu lục, quốc gia và thành phố. Từ dữ liệu phân tích này, bạn có thể xem Bản đồ địa lý trong giao diện người dùng Edge cho thấy vị trí của các yêu cầu API:

Tính năng tổng hợp theo khu vực địa lý hoạt động bằng cách trích xuất dữ liệu địa lý từ cơ sở dữ liệu của bên thứ ba và thêm dữ liệu này vào dữ liệu phân tích mà Edge thu thập. Thông tin địa lý có thể bao gồm thành phố, quốc gia, châu lục, múi giờ và khu vực của yêu cầu được gửi đến proxy API.

Để sử dụng tính năng tổng hợp địa lý, bạn phải mua cơ sở dữ liệu Maxmind GeoIp2 có chứa thông tin địa lý này. Hãy tham khảo https://www.maxmind.com/en/geoip2-databases để biết thêm thông tin.

Bật tính năng tổng hợp địa lý

Tính năng tổng hợp địa lý không được bật theo mặc định. Để bật tính năng tổng hợp địa lý, bạn phải:

  • Trên tất cả máy chủ Qpid, hãy cài đặt cơ sở dữ liệu MaxMind và định cấu hình máy chủ Qpid để sử dụng cơ sở dữ liệu này.
  • Bật màn hình Bản đồ địa lý trong giao diện người dùng Edge.

Cài đặt cơ sở dữ liệu MaxMind trên tất cả máy chủ Edge Qpid

Hãy dùng quy trình sau để cài đặt cơ sở dữ liệu MaxMind trên tất cả máy chủ Edge Qpid:

  1. Lấy cơ sở dữ liệu Maxmind GeoIp2.
  2. Tạo thư mục sau trên nút máy chủ Qpid: 
    /opt/apigee/maxmind
  3. Tải cơ sở dữ liệu Maxmind GeoIp2 xuống /opt/apigee/maxmind.
  4. Thay đổi quyền sở hữu tệp cơ sở dữ liệu thành người dùng "apigee": 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Thiết lập các quyền trên cơ sở dữ liệu thành 744: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Thiết lập các mã thông báo sau trong /opt/apigee/customer/application/qpid-server.properties. Nếu tệp đó không tồn tại, hãy tạo tệp: 
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

    Nếu bạn đã lưu trữ cơ sở dữ liệu Maxmind GeoIp2 ở một vị trí khác, hãy chỉnh sửa thuộc tính đường dẫn cho phù hợp.

    Lưu ý rằng tệp cơ sở dữ liệu này chứa số phiên bản. Nếu sau đó bạn nhận được một tệp cơ sở dữ liệu cập nhật, tệp đó có thể có số phiên bản khác. Thay vào đó, hãy tạo một đường liên kết tượng trưng với tệp cơ sở dữ liệu và sử dụng đường liên kết tượng trưng trong qpid-server.properties.

    Ví dụ: tạo một đường liên kết tượng trưng cho "GeoIP2-City-current.mmdb" thành "GeoIP2-City_20160127.mmdb". Nếu sau đó bạn nhận được một cơ sở dữ liệu mới có tên tệp khác, bạn chỉ cần cập nhật đường liên kết tượng trưng thay vì phải định cấu hình lại và khởi động lại máy chủ Qpid.

  7. Thay đổi quyền sở hữu tệp qpid-server.properties thành người dùng "apigee": 
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Khởi động lại máy chủ Qpid: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  9. Lặp lại quá trình này trên mọi nút Qpid.
  10. Cách xác thực rằng tính năng tổng hợp theo vị trí địa lý đang hoạt động:
    1. Kích hoạt một số lệnh gọi proxy API trên một proxy API mẫu.
    2. Chờ khoảng 5-10 phút để quá trình tổng hợp hoàn tất.
    3. Mở một bảng điều khiển rồi kết nối với máy chủ Edge Postgres: 
      psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. Thực hiện truy vấn SELECT trên bảng analytics.agg_geo để hiển thị các hàng có thuộc tính địa lý: 
      select * from analytics.agg_geo;

      Bạn sẽ thấy các cột sau trong kết quả truy vấn được trích xuất từ cơ sở dữ liệu Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

      Nếu bảng agg_geo chưa được điền, hãy kiểm tra nhật ký máy chủ Qpid tại /opt/apigee/var/log/edge-qpid-server/logs/ để phát hiện mọi trường hợp ngoại lệ tiềm ẩn.

Bật Maps địa lý trong giao diện người dùng Edge

Hãy sử dụng quy trình sau để bật Maps địa lý trong giao diện người dùng Edge:

  1. Đặt mã thông báo sau trong /opt/apigee/customer/application/ui.properties để bật Maps địa lý. Nếu tệp đó không tồn tại, hãy tạo tệp: 
    conf_apigee_apigee.feature.disablegeomap=false
  2. Thay đổi quyền sở hữu tệp ui.properties thành người dùng "apigee": 
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Khởi động lại giao diện người dùng Edge: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
  4. Trong giao diện người dùng Edge, hãy chọn Analytics > GeoMap (Analytics > Bản đồ địa lý) để hiển thị dữ liệu tổng hợp địa lý.

Cập nhật cơ sở dữ liệu MaxMind GeoIp2

MaxMind đưa ra các bản cập nhật định kỳ cho cơ sở dữ liệu Maxmind GeoIp2. Nếu bạn nhận được cơ sở dữ liệu đã cập nhật, hãy sử dụng quy trình sau để cài đặt cơ sở dữ liệu trên Edge:

  1. Nhận cơ sở dữ liệu Maxmind GeoIp2 đã cập nhật.
  2. Tải cơ sở dữ liệu Maxmind GeoIp2 xuống /opt/apigee/maxmind.
  3. Kiểm tra tên của tệp cơ sở dữ liệu. Nếu tệp này giống với tệp cũ, như xác định trong /opt/apigee/customer/application/qpid-server.properties, hãy chuyển sang bước tiếp theo. Tuy nhiên, nếu tệp này có tên khác, bạn phải chỉnh sửa tệp qpid-server.properties để chỉ định tên của tệp cơ sở dữ liệu mới, sau đó khởi động lại máy chủ Qpid, như mô tả ở trên.

    Thay vào đó, bạn có thể tạo đường liên kết tượng trưng đến tệp. Ví dụ: tạo một đường liên kết tượng trưng cho "GeoIP2-City-current.mmdb" đến "GeoIP2-City_20160127.mmdb". Nếu sau này bạn nhận được một cơ sở dữ liệu mới có tên tệp khác, thì bạn chỉ cần cập nhật đường liên kết tượng trưng thay vì phải định cấu hình lại máy chủ Qpid.

  4. Thay đổi quyền sở hữu tệp cơ sở dữ liệu thành người dùng "apigee": 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Thiết lập các quyền trên cơ sở dữ liệu thành 744: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Khởi động lại máy chủ Qpid: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  7. Lặp lại quá trình này trên mọi nút Qpid.