Attivazione dell'aggregazione geografica e di Google Maps

Edge per Private Cloud v4.18.01

Le aggregazioni geografiche 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 nella UI Edge che mostra la posizione delle richieste API:

Le aggregazioni geografiche estrae i dati geografici da un database di terze parti e li aggiungono 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 effettuata a un proxy API.

Per utilizzare l'aggregazione geografica, devi acquistare il database Maxmind GeoIp2 che contiene queste informazioni geografiche. Consulta la pagina https://www.maxmind.com/en/geoip2-databases per maggiori informazioni.

Attivazione dell'aggregazione dei dati geografici

Per impostazione predefinita, le aggregazioni geografiche non sono abilitate. Per attivare le aggregazioni geografiche, è necessario:

  • Su tutti i server Qpid, installa il database MaxMind e configura il server Qpid per utilizzarlo.
  • Attiva la visualizzazione della mappa geografica nell'interfaccia utente Edge.

Installa il database MaxMind su tutti i server Edge Qpid

Utilizza la procedura seguente per installare il database MaxMind su tutti i server Edge Qpid:

  1. Ottieni il database Maxmind GeoIp2.
    Nota: le aggregazioni geografiche funzionano mediante l'aggiunta di dati geografici di 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. Consulta la pagina https://www.maxmind.com/en/geoip2-databases per ulteriori informazioni.
  2. Crea la seguente cartella sul nodo server Qpid:
    /opt/apigee/maxmind
  3. Scarica il database Maxmind GeoIp2 su /opt/apigee/maxmind.
  4. Cambia la proprietà del file del database in utente apigee':
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Imposta le autorizzazioni sul database su 744:
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. 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


    Tieni presente che questo file di database contiene un numero di versione. Se in seguito ricevi un file di database aggiornato, potrebbe avere un numero di versione diverso. In alternativa, crea un link simbolico al file di database e utilizza il link simbolico in qpid-server.properties.

    Ad esempio, crea un link simbolico per "GeoIP2-City-current.mmdb" a "GeoIP2-City_20160127.mmdb". Se in seguito riceverai un nuovo database con un nome file diverso, dovrai solo aggiornare il link simbolico anziché riconfigurare e riavviare il server Qpid.
  7. Cambia la proprietà del file qpid-server.properties all'utente 'apigee':
    > chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Riavvia il server Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server reboot
  9. Ripeti questa procedura su ogni nodo Qpid.
  10. Per verificare il funzionamento dell'aggregazione geografica:
    1. Attivare diverse chiamate proxy API su un proxy API di esempio.
    2. Attendi circa 5-10 minuti per il completamento delle aggregazioni.
    3. Apri una console e connettiti al server Edge Postgres:
      > psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. Esegui una query SELECT sulla tabella analytics.agg_geo per visualizzare le righe con attributi geografici:
      apigee=# select * from analytics.agg_geo;

      Nei risultati della query dovrebbero essere visualizzate le seguenti colonne estratte dal database Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_region, ax_geo_continent, ax_geo_region

      Se la tabella agg_geo non viene completata, controlla i log del server Qpid all'indirizzo /opt/apigee/var/log/edge-qpid-server/logs/ per rilevare potenziali eccezioni.

Attiva mappe geografiche nell'interfaccia utente Edge

Utilizza la seguente procedura per abilitare le mappe geografiche nell'interfaccia utente Edge:

  1. Imposta il seguente token in /opt/apigee/customer/application/ui.properties per abilitare le mappe geografiche. Se il file non esiste, crealo:
    conf_apigee_apigee.feature.disablegeomap=false
  2. Modifica la proprietà del file ui.properties all 'utente apigee':
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Riavvia la UI Edge:
    > /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui reboot
  4. Nella UI di Edge, seleziona Analytics > Mappa geografica per visualizzare i dati di aggregazione dei dati geografici.

Aggiornamento del database MaxMind GeoIp2

MaxMind emette aggiornamenti periodici al database Maxmind GeoIp2. Se ricevi un database aggiornato, utilizza la procedura seguente per installarlo su Edge:

  1. Ottieni il database Maxmind GeoIp2 aggiornato.
  2. Scarica il database Maxmind GeoIp2 su /opt/apigee/maxmind.
  3. Controlla il nome del file del database. Se è uguale al file precedente, come definito in ?/opt/apigee/customer/application/qpid-server.properties, vai al passaggio successivo. Tuttavia, se il nome del file è diverso, devi modificare il file qpid-server.properties per specificare il nome del nuovo file di database e quindi riavviare il server Qpid, come descritto sopra.

    In alternativa, puoi creare un link simbolico al file. Ad esempio, crea un link simbolico per "GeoIP2-City-current.mmdb" a "GeoIP2-City_20160127.mmdb". Se in seguito riceverai un nuovo database con un nome file diverso, dovrai solo aggiornare il link simbolico anziché riconfigurare il server Qpid.
  4. Cambia la proprietà del file del database in utente apigee':
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Imposta le autorizzazioni sul database su 744:
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Riavvia il server Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server reboot
  7. Ripeti questa procedura su ogni nodo Qpid.