Edge dla chmury prywatnej w wersji 4.18.01
Agregacje geograficzne umożliwiają zbieranie danych analitycznych dotyczących wywołań interfejsu API na podstawie atrybutów geograficznych, takich jak region, kontynent, kraj i miasto. Na podstawie tych danych analitycznych możesz wyświetlić w interfejsie Edge mapę geograficzną, która pokazuje lokalizację żądań do interfejsu API:
Agregacje geograficzne polegają na wyodrębnianiu danych geograficznych z bazy danych innej firmy i dodawaniu ich do danych analitycznych zbieranych przez Edge. Informacje geograficzne mogą zawierać miasto, kraj, kontynent, strefę czasową i region żądania wysłanego do serwera proxy interfejsu API.
Aby korzystać z agregacji geograficznej, musisz kupić bazę danych Maxmind GeoIp2, która zawiera te informacje geograficzne. Więcej informacji znajdziesz na stronie https://www.maxmind.com/en/geoip2-databases.
Włączam agregację geograficzną
Domyślnie agregacje geograficzne są wyłączone. Aby włączyć agregacje geograficzne:
- Na wszystkich serwerach Qpid zainstaluj bazę danych MaxMind i skonfiguruj serwer Qpid, aby jej używał.
- Włącz wyświetlanie mapy geograficznej w interfejsie Edge.
Zainstaluj bazę danych MaxMind na wszystkich serwerach Edge Qpid
Aby zainstalować bazę danych MaxMind na wszystkich serwerach Edge Qpid, wykonaj te czynności:
- Pobierz bazę danych Maxmind GeoIp2.
Uwaga: agregacje geograficzne działają przez dodanie danych geograficznych z bazy danych innej firmy do danych analitycznych zebranych przez Edge. Aby korzystać z agregacji geograficznej, musisz kupić bazę danych Maxmind GeoIp2, która zawiera te informacje. Więcej informacji znajdziesz na stronie https://www.maxmind.com/en/geoip2-databases. - Utwórz ten folder w węźle serwera Qpid:
/opt/apigee/maxmind - Pobierz bazę danych Maxmind GeoIp2 do katalogu /opt/apigee/maxmind.
- Zmień właściciela pliku bazy danych na użytkownika „apigee”:
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Ustaw uprawnienia bazy danych na 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Ustaw te tokeny w pliku /opt/apigee/customer/application/qpid-server.properties.
Jeśli ten plik nie istnieje, utwórz go:
conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
Jeśli baza danych Maxmind GeoIp2 jest przechowywana w innej lokalizacji, odpowiednio zmień właściwość ścieżki.
Zwróć uwagę, że ten plik bazy danych zawiera numer wersji. Jeśli później otrzymasz zaktualizowany plik bazy danych, może on mieć inny numer wersji. Możesz też utworzyć dowiązanie symboliczne do pliku bazy danych i użyć go w pliku qpid-server.properties.
Na przykład utwórz dowiązanie symboliczne dla „GeoIP2-City-current.mmdb” do „GeoIP2-City_20160127.mmdb”. Jeśli później otrzymasz nową bazę danych z inną nazwą pliku, wystarczy zaktualizować dowiązanie symboliczne, zamiast ponownie konfigurować i uruchamiać serwer Qpid. - Zmień właściciela pliku qpid-server.properties na użytkownika „apigee”:
> chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties - Uruchom ponownie serwer Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Powtórz ten proces na każdym węźle Qpid.
- Aby sprawdzić, czy agregacja geograficzna działa:
- wywołać kilka razy przykładowy serwer proxy interfejsu API,
- Poczekaj około 5–10 minut na zakończenie agregacji.
- Otwórz konsolę i połącz się z serwerem Edge Postgres:
> psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee - Wykonaj zapytanie SELECT w tabeli analytics.agg_geo, aby wyświetlić wiersze z atrybutami geograficznymi:
apigee=# select * from analytics.agg_geo;
W wynikach zapytania powinny pojawić się następujące kolumny wyodrębnione z bazy danych Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.
Jeśli tabela agg_geo nie jest wypełniana, sprawdź logi serwera Qpid w /opt/apigee/var/log/edge-qpid-server/logs/, aby wykryć potencjalne wyjątki.
Włączanie map geograficznych w interfejsie Edge
Aby włączyć mapy geograficzne w interfejsie Edge:
- Aby włączyć mapy geograficzne, ustaw ten token w pliku /opt/apigee/customer/application/ui.properties. Jeśli ten plik nie istnieje, utwórz go:
conf_apigee_apigee.feature.disablegeomap=false - Zmień własność pliku ui.properties na użytkownika „apigee”:
> chown apigee:apigee /opt/apigee/customer/application/ui.properties - Uruchom ponownie interfejs Edge:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart - W interfejsie Edge wybierz Analytics > GeoMap (Analityka > Mapa geograficzna), aby wyświetlić dane zbiorcze dotyczące lokalizacji geograficznej.
Aktualizowanie bazy danych MaxMind GeoIp2
MaxMind okresowo aktualizuje bazę danych Maxmind GeoIp2. Jeśli otrzymasz zaktualizowaną bazę danych, wykonaj tę procedurę, aby zainstalować ją w Edge:
- Pobierz zaktualizowaną bazę danych Maxmind GeoIp2.
- Pobierz bazę danych Maxmind GeoIp2 do katalogu /opt/apigee/maxmind.
- Sprawdź nazwę pliku bazy danych. Jeśli jest taki sam jak stary plik, zgodnie z definicją w ?/opt/apigee/customer/application/qpid-server.properties, przejdź do następnego kroku. Jeśli jednak plik ma inną nazwę, musisz zmodyfikować plik qpid-server.properties, aby określić nazwę nowego pliku bazy danych, a następnie ponownie uruchomić serwer Qpid, jak opisano powyżej.
Możesz też utworzyć dowiązanie symboliczne do pliku. Możesz na przykład utworzyć dowiązanie symboliczne dla „GeoIP2-City-current.mmdb” do „GeoIP2-City_20160127.mmdb”. Jeśli później otrzymasz nową bazę danych z inną nazwą pliku, wystarczy, że zaktualizujesz dowiązanie symboliczne, zamiast ponownie konfigurować serwer Qpid. - Zmień właściciela pliku bazy danych na użytkownika „apigee”:
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Ustaw uprawnienia bazy danych na 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Uruchom ponownie serwer Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Powtórz ten proces na każdym węźle Qpid.