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

Tính năng tổng hợp địa lý cho phé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 vị trí đị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 GeoMap trong giao diện người dùng Edge hiển thị vị trí của các yêu cầu API:

Tính năng tổng hợp đị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 với dữ liệu phân tích mà Edge thu thập được. 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 về địa lý. Truy cập và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ý

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

  • Trên tất cả cá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 nó.
  • Bật chế độ hiển thị Bản đồ địa lý trong giao diện người dùng Edge.

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

Sử dụng quy trình sau để cài đặt cơ sở dữ liệu MaxMind trên tất cả cá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 "api" người dùng: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Đặt 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 tệp cơ sở dữ liệu, tệp này có thể có số phiên bản khác. Thay vào đó, hãy tạo một liên kết tượng trưng đến 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" vào "GeoIP2-City_20160127.mmdb". Nếu bạn sẽ nhận được một cơ sở dữ liệu mới có tên tệp khác, bạn chỉ phải cập nhật 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 của tệp qpid-server.properties thành "API" người dùng: 
    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 quy 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 đị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. Đợi khoảng 5 đến 10 phút để quá trình tổng hợp hoàn tất.
    3. Mở 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 sẵn dữ liệu, 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 nguy cơ ngoại lệ.

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

Sử dụng quy trình sau để bật Bản đồ địa lý trong giao diện người dùng Edge:

  1. Thiết lập mã thông báo sau trong /opt/apigee/customer/application/ui.properties để bật Bản đồ đị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 "apigee" người dùng: 
    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 để hiển thị dữ liệu tổng hợp địa lý .

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

MaxMind phát hành bản cập nhật định kỳ cho cơ sở dữ liệu MaxMind GeoIp2. Nếu bạn nhận được , hãy sử dụng quy trình sau để cài đặt nó 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 giống với tệp cũ, như được xác định trong /opt/apigee/customer/application/qpid-server.properties, chuyển sang bước tiếp theo. Tuy nhiên, nếu tệp 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 liên kết tượng trưng cho "GeoIP2-City-current.mmdb" vào "GeoIP2-City_20160127.mmdb". Nếu sau đó bạn nhận được cơ sở dữ liệu mới có tên tệp khác, bạn chỉ phải cập nhật liên kết tượng trưng thay vì phải cập nhật đị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 "api" người dùng: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Đặt 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 quy trình này trên mọi nút Qpid.