Edge for Private Cloud v4.18.01
Географические агрегированные данные позволяют собирать аналитические данные о вызовах API на основе географических атрибутов, таких как регион, континент, страна и город. На основе этих данных в интерфейсе Edge можно посмотреть карту, на которой показано, откуда поступают запросы к API.
Географические агрегированные данные извлекаются из сторонней базы данных и добавляются к данным аналитики, собранным Edge. Географическая информация может содержать город, страну, континент, часовой пояс и регион запроса, отправленного на прокси-сервер API.
Чтобы использовать геоагрегирование, необходимо приобрести базу данных Maxmind GeoIp2, которая содержит эту географическую информацию. Подробную информацию можно найти на странице https://www.maxmind.com/en/geoip2-databases.
Включение агрегирования по местоположению
По умолчанию агрегирование по местоположению отключено. Чтобы включить агрегирование по местоположению, выполните следующие действия:
- На всех серверах Qpid установите базу данных MaxMind и настройте сервер Qpid для ее использования.
- Включите показ географической карты в интерфейсе Edge.
Установите базу данных MaxMind на всех серверах Edge Qpid.
Чтобы установить базу данных MaxMind на всех серверах Edge Qpid, выполните следующие действия:
- Получите базу данных Maxmind GeoIp2.
Примечание. Географические агрегированные данные создаются путем добавления географических данных из сторонней базы данных к аналитическим данным, собранным Edge. Чтобы использовать агрегирование по местоположению, необходимо приобрести базу данных Maxmind GeoIp2, которая содержит эту информацию. Дополнительную информацию можно найти на странице https://www.maxmind.com/en/geoip2-databases. - Создайте на узле сервера Qpid следующую папку:
/opt/apigee/maxmind - Скачайте базу данных Maxmind GeoIp2 в каталог /opt/apigee/maxmind.
- Смените владельца файла базы данных на пользователя apigee:
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Установите для базы данных разрешения 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Задайте следующие токены в файле /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. - Измените владельца файла qpid-server.properties на пользователя apigee:
> chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties - Перезапустите сервер Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Повторите этот процесс на каждом узле Qpid.
- Чтобы проверить, работает ли агрегирование по местоположению:
- Вызовите несколько прокси-серверов API на примере прокси-сервера API.
- Подождите 5–10 минут, пока агрегирование не будет завершено.
- Откройте консоль и подключитесь к серверу Edge Postgres:
> psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee - Выполните запрос SELECT для таблицы analytics.agg_geo, чтобы показать строки с географическими атрибутами:
apigee=# 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, выполните следующие действия:
- Чтобы включить географические карты, задайте следующий токен в файле /opt/apigee/customer/application/ui.properties: Если такого файла нет, создайте его:
conf_apigee_apigee.feature.disablegeomap=false - Передайте право собственности на файл ui.properties пользователю apigee:
> chown apigee:apigee /opt/apigee/customer/application/ui.properties - Перезапустите Edge UI:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart - В интерфейсе Edge выберите Analytics (Аналитика) > GeoMap (Геокарта), чтобы посмотреть агрегированные данные о местоположении.
Обновление базы данных MaxMind GeoIp2
MaxMind периодически обновляет базу данных Maxmind GeoIp2. Если вы получили обновленную базу данных, установите ее в Edge, выполнив следующие действия:
- Получите обновленную базу данных Maxmind GeoIp2.
- Скачайте базу данных Maxmind GeoIp2 в каталог /opt/apigee/maxmind.
- Проверьте название файла базы данных. Если он совпадает со старым файлом, как определено в /opt/apigee/customer/application/qpid-server.properties, перейдите к следующему шагу. Если же у файла другое название, вам нужно будет указать его в файле qpid-server.properties, а затем перезапустить сервер Qpid, как описано выше.
В качестве альтернативы можно создать символическую ссылку на файл. Например, создайте символическую ссылку для GeoIP2-City-current.mmdb на GeoIP2-City_20160127.mmdb. Если вы позже получите новую базу данных с другим именем файла, вам нужно будет только обновить символическую ссылку, а не перенастраивать сервер Qpid. - Смените владельца файла базы данных на пользователя apigee:
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Установите для базы данных разрешения 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Перезапустите сервер Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Повторите этот процесс на каждом узле Qpid.