Edge for Private Cloud v4.18.01
Le aggregazioni geografiche ti consentono di raccogliere dati di analisi per le chiamate API in base ad attributi geografici come regione, continente, paese e città. Da questi dati di analisi, puoi visualizzare una mappa geografica nell'interfaccia utente di Edge che mostra la posizione delle richieste API:
Le aggregazioni geografiche funzionano estraendo i dati geografici da un database di terze parti e aggiungendoli ai dati di analisi raccolti da Edge. Le informazioni geografiche possono contenere la città, il paese, il continente, il fuso orario e la regione di una richiesta inviata a un proxy API.
Per utilizzare l'aggregazione geografica, devi acquistare il database Maxmind GeoIp2 che contiene queste informazioni geografiche. Per saperne di più, consulta https://www.maxmind.com/en/geoip2-databases.
Abilitazione dell'aggregazione geografica
Per impostazione predefinita, le aggregazioni geografiche non sono abilitate. Per attivare le aggregazioni geografiche, devi:
- Su tutti i server Qpid, installa il database MaxMind e configura il server Qpid in modo che lo utilizzi.
- Abilita la visualizzazione della cartina geografica nell'interfaccia utente di Edge.
Installa il database MaxMind su tutti i server Edge Qpid
Utilizza la seguente procedura per installare il database MaxMind su tutti i server Edge Qpid:
- Ottieni il database Maxmind GeoIp2.
Nota: le aggregazioni geografiche funzionano aggiungendo dati geografici da un database di terze parti ai dati di analisi raccolti da Edge. Per utilizzare l'aggregazione geografica, devi acquistare il database Maxmind GeoIp2 che contiene queste informazioni. Per saperne di più, consulta https://www.maxmind.com/en/geoip2-databases. - Crea la seguente cartella sul nodo del server Qpid:
/opt/apigee/maxmind - Scarica il database Maxmind GeoIp2 in /opt/apigee/maxmind.
- Cambia la proprietà del file di database impostandola sull'utente "apigee":
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Imposta le autorizzazioni sul database su 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Imposta i seguenti token in /opt/apigee/customer/application/qpid-server.properties.
Se il file non esiste, crealo:
conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
Se hai archiviato il database Maxmind GeoIp2 in una posizione diversa, modifica la proprietà del percorso di conseguenza.
Tieni presente che questo file di database contiene un numero di versione. Se in un secondo momento ricevi un file di database aggiornato, potrebbe avere un numero di versione diverso. In alternativa, crea un collegamento simbolico al file del database e utilizza il collegamento simbolico in qpid-server.properties.
Ad esempio, crea un collegamento simbolico per "GeoIP2-City-current.mmdb" a "GeoIP2-City_20160127.mmdb". Se in un secondo momento ricevi un nuovo database con un nome file diverso, devi solo aggiornare il collegamento simbolico anziché dover riconfigurare e riavviare il server Qpid. - Cambia la proprietà del file qpid-server.properties in modo che appartenga all'utente "apigee":
> chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties - Riavvia il server Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Ripeti questa procedura su ogni nodo Qpid.
- Per verificare che l'aggregazione geografica funzioni:
- Attivare diverse chiamate proxy API su un proxy API di esempio.
- Attendi circa 5-10 minuti per il completamento delle aggregazioni.
- Apri una console e connettiti al server Edge Postgres:
> psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee - Esegui una query SELECT sulla tabella analytics.agg_geo per mostrare le righe con attributi geografici:
apigee=# select * from analytics.agg_geo;
Nei risultati della query dovresti vedere le seguenti colonne estratte dal database Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.
Se la tabella agg_geo non viene compilata, controlla i log del server Qpid in /opt/apigee/var/log/edge-qpid-server/logs/ per rilevare eventuali eccezioni.
Abilita le cartine geografiche nell'interfaccia utente di Edge
Per attivare le cartine geografiche nell'interfaccia utente di Edge, segui questa procedura:
- Imposta il seguente token in /opt/apigee/customer/application/ui.properties
per attivare le cartine geografiche. Se il file non esiste, crealo:
conf_apigee_apigee.feature.disablegeomap=false - Cambia la proprietà del file ui.properties impostandola sull'utente "apigee":
> chown apigee:apigee /opt/apigee/customer/application/ui.properties - Riavvia la UI Edge:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart - Nella UI di Edge, seleziona Analisi > GeoMap per visualizzare i dati di aggregazione geografica.
Aggiornamento del database MaxMind GeoIp2
MaxMind pubblica aggiornamenti periodici del database Maxmind GeoIp2. Se ricevi un database aggiornato, utilizza la seguente procedura per installarlo su Edge:
- Ottieni il database Maxmind GeoIp2 aggiornato.
- Scarica il database Maxmind GeoIp2 in /opt/apigee/maxmind.
- Controlla il nome del file del database. Se è uguale al file precedente, come definito in
?/opt/apigee/customer/application/qpid-server.properties,
procedi al passaggio successivo. Tuttavia, se il file ha un nome diverso, devi modificare il file qpid-server.properties per specificare il nome del nuovo file di database e poi riavviare il server Qpid, come descritto sopra.
In alternativa, puoi creare un collegamento simbolico al file. Ad esempio, crea un collegamento simbolico per "GeoIP2-City-current.mmdb" a "GeoIP2-City_20160127.mmdb". Se in un secondo momento ricevi un nuovo database con un nome file diverso, devi solo aggiornare il collegamento simbolico anziché riconfigurare il server Qpid. - Cambia la proprietà del file di database impostandola sull'utente "apigee":
> chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Imposta le autorizzazioni sul database su 744:
> chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb - Riavvia il server Qpid:
> /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart - Ripeti questa procedura su ogni nodo Qpid.