Как включить геоагрегацию и географические карты

Географические агрегированные данные позволяют собирать аналитические данные о вызовах API на основе географических атрибутов, таких как регион, континент, страна и город. На основе этих данных в интерфейсе Edge можно посмотреть карту, на которой показано, откуда поступают запросы к API.

Географические агрегированные данные извлекаются из сторонней базы данных и добавляются к данным аналитики, собранным Edge. Географическая информация может содержать город, страну, континент, часовой пояс и регион запроса, отправленного на прокси-сервер API.

Чтобы использовать геоагрегирование, необходимо приобрести базу данных Maxmind GeoIp2, которая содержит эту географическую информацию. Дополнительную информацию можно найти на странице https://www.maxmind.com/en/geoip2-databases.

Включение агрегирования по местоположению

По умолчанию агрегирование по местоположению отключено. Чтобы включить агрегирование по местоположению, выполните следующие действия:

  • На всех серверах Qpid установите базу данных MaxMind и настройте сервер Qpid для ее использования.
  • Включите показ географической карты в интерфейсе Edge.

Установите базу данных MaxMind на всех серверах Edge Qpid.

Чтобы установить базу данных MaxMind на всех серверах Edge Qpid, выполните следующие действия:

  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 в другом месте, измените свойство path.

    Обратите внимание, что файл базы данных содержит номер версии. Если вы позже получите обновленный файл базы данных, у него может быть другой номер версии. В качестве альтернативы создайте символическую ссылку на файл базы данных и используйте ее в 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/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  9. Повторите этот процесс на каждом узле Qpid.
  10. Чтобы проверить, работает ли агрегирование по местоположению, выполните следующие действия:
    1. Вызовите несколько прокси-серверов API на примере прокси-сервера API.
    2. Подождите 5–10 минут, пока агрегирование не будет завершено.
    3. Откройте консоль и подключитесь к серверу Edge Postgres: 
      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/, чтобы выявить возможные исключения.

Как включить географические карты в интерфейсе Edge

Чтобы включить географические карты в интерфейсе Edge, выполните следующие действия:

  1. Чтобы включить географические карты, задайте в /opt/apigee/customer/application/ui.properties следующий токен: Если такого файла нет, создайте его: 
    conf_apigee_apigee.feature.disablegeomap=false
  2. Передайте право собственности на файл ui.properties пользователю apigee: 
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Перезапустите Edge UI: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
  4. В интерфейсе Edge выберите Analytics (Аналитика) > 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/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  7. Повторите этот процесс на каждом узле Qpid.