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

Edge for Private Cloud phiên bản 4.17.01

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.
    Lưu ý: Tính năng tổng hợp theo vị trí địa lý hoạt động bằng cách thêm dữ liệu theo địa lý từ cơ sở dữ liệu của bên thứ ba vào dữ liệu phân tích do Edge thu thập. Để 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 này. Hãy tham khảo https://www.maxmind.com/en/geoip2-databases để biết thêm thông tin.
  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. Đặt 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 thì hãy chỉnh sửa thuộc tính Geopmind theo vị trí tương ứng

    Nếu bạn đã lưu trữ một đường dẫn Geopmind tương ứng, hãy


    Xin 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 đó, bạn có thể tạo một đường 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" đến "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 để cho thấy các hàng có thuộc tính địa lý:
      apigee=# chọn * từ 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_geo_region, ax_geo_geo_

      Nếu bảng agg_geo chưa được điền sẵn thông tin, 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ệ có thể xảy ra.

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 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 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 rồi khởi động lại máy chủ Qpid như mô tả ở trên.

    Ngoài ra, 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.