Включение геоагрегации и географических карт

Географические агрегации позволяют собирать аналитические данные для вызовов 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 в другом месте, отредактируйте свойство пути соответствующим образом.

   Обратите внимание, что этот файл базы данных содержит номер версии. Если позже вы получите обновленный файл базы данных, он может иметь другой номер версии. В качестве альтернативы создайте символическую ссылку на файл базы данных и используйте символическую ссылку в 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:

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

4. В пользовательском интерфейсе Edge выберите Аналитика > Геокарта , чтобы отобразить данные географической агрегации.

Обновление базы данных 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.