Aggregation von Geodaten und Landkarten aktivieren

Mit Geo-Aggregationen können Sie Analysedaten für API-Aufrufe basierend auf geografischen Attributen wie Region, Kontinent, Land und Stadt erfassen. Aus diesen Analysedaten können Sie in der neuen Edge-Benutzeroberfläche eine geografische Karte aufrufen, auf der der Standort von API-Anfragen angezeigt wird:

GeoMap-Dashboard in der neuen Edge-Benutzeroberfläche

Bei Geo-Aggregationen werden geografische Daten aus einer Drittanbieterdatenbank extrahiert und den von Edge erfassten Analysedaten hinzugefügt. Die geografischen Informationen können die Stadt, Land, Kontinent, Zeitzone und Region einer Anfrage an einen API-Proxy enthalten.

Wenn Sie Geo-Aggregationen verwenden möchten, müssen Sie die Maxmind GeoIp2-Datenbank kaufen, die diese geografischen Informationen enthält. Weitere Informationen finden Sie unter https://www.maxmind.com/en/geoip2-databases.

Geo-Aggregationen aktivieren

Geo-Aggregationen sind standardmäßig nicht aktiviert. So aktivieren Sie Geo-Aggregationen:

  • Installieren Sie auf allen Qpid-Servern die MaxMind-Datenbank und konfigurieren Sie den Qpid-Server für die Verwendung.
  • Aktivieren Sie die Anzeige der geografischen Karte in der neuen Edge-Benutzeroberfläche.

MaxMind -Datenbank auf allen Edge-Qpid-Servern installieren

So installieren Sie die MaxMind-Datenbank auf allen Edge-Qpid-Servern:

  1. Rufen Sie die Maxmind GeoIp2-Datenbank ab.
  2. Erstellen Sie den folgenden Ordner auf dem Qpid-Serverknoten: 
    /opt/apigee/maxmind
  3. Laden Sie die Maxmind GeoIp2-Datenbank in /opt/apigee/maxmind herunter.
  4. Ändern Sie die Eigentümerschaft der Datenbankdatei in den Nutzer „apigee“: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Legen Sie die Berechtigungen für die Datenbank auf 744 fest: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Legen Sie die folgenden Tokens in /opt/apigee/customer/application/qpid-server.properties fest. Wenn die Datei nicht vorhanden ist, erstellen Sie sie: 
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

    Wenn Sie die Maxmind GeoIp2-Datenbank an einem anderen Speicherort gespeichert haben, bearbeiten Sie die Pfadeigenschaft entsprechend.

    Beachten Sie, dass diese Datenbankdatei eine Versionsnummer enthält. Wenn Sie später eine aktualisierte Datenbankdatei erhalten, hat sie möglicherweise eine andere Versionsnummer. Alternativ können Sie einen Symlink zur Datenbankdatei erstellen und den Symlink in qpid-server.properties verwenden.

    Erstellen Sie beispielsweise einen Symlink für „GeoIP2-City-current.mmdb“ zu „GeoIP2-City_20160127.mmdb“. Wenn Sie später eine neue Datenbank mit einem anderen Dateinamen erhalten, müssen Sie nur den Symlink aktualisieren, anstatt den Qpid-Server neu zu konfigurieren und neu zu starten.

  7. Ändern Sie die Eigentümerschaft der Datei qpid-server.properties in den Nutzer „apigee“: 
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Starten Sie den Qpid-Server neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  9. Wiederholen Sie diesen Vorgang auf jedem Qpid-Knoten.
  10. So prüfen Sie, ob die Geo-Aggregation funktioniert:
    1. Lösen Sie mehrere API-Proxy-Aufrufe für einen Beispiel-API-Proxy aus.
    2. Warten Sie etwa 5 bis 10 Minuten, bis die Aggregationen abgeschlossen sind.
    3. Öffnen Sie eine Konsole und stellen Sie eine Verbindung zum Edge-Postgres-Server her: 
      psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. Führen Sie eine SELECT-Abfrage für die Tabelle „analytics.agg_geo“ aus, um die Zeilen mit geografischen Attributen anzuzeigen: 
      select * from analytics.agg_geo;

      In den Abfrageergebnissen sollten die folgenden Spalten angezeigt werden, die aus der Maxmind GeoIp2-Datenbank extrahiert wurden: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

      Wenn die Tabelle agg_geo nicht gefüllt wird, prüfen Sie die Qpid-Server-Logs unter /opt/apigee/var/log/edge-qpid-server/logs/ auf mögliche Ausnahmen.

Geografische Karten in der neuen Edge-Benutzeroberfläche aktivieren

So aktivieren Sie geografische Karten in der neuen Edge-Benutzeroberfläche:

  1. Legen Sie das folgende Token in /opt/apigee/customer/application/management-ui.properties fest, um Landkarten zu aktivieren. Wenn die Datei nicht vorhanden ist, erstellen Sie sie: 
    conf_uebe_disableGeoMap=false
  2. Ändern Sie die Eigentümerschaft der Datei management-ui.properties in den Nutzer apigee: 
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  3. Starten Sie die neue Edge-Benutzeroberfläche neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  4. Wählen Sie in der neuen Edge-Benutzeroberfläche Analysieren > Endnutzer > Geografische Karte aus, um die Geo-Aggregationsdaten anzuzeigen.

MaxMind GeoIp2-Datenbank aktualisieren

MaxMind veröffentlicht regelmäßig Updates für die Maxmind GeoIp2-Datenbank. Wenn Sie eine aktualisierte Datenbank erhalten, gehen Sie so vor, um sie in Edge zu installieren:

  1. Rufen Sie die aktualisierte Maxmind GeoIp2-Datenbank ab.
  2. Laden Sie die Maxmind GeoIp2-Datenbank in /opt/apigee/maxmind herunter.
  3. Prüfen Sie den Namen der Datenbankdatei. Wenn er mit dem Namen der alten Datei übereinstimmt, wie in /opt/apigee/customer/application/qpid-server.properties definiert, fahren Sie mit dem nächsten Schritt fort. Wenn die Datei jedoch einen anderen Namen hat, müssen Sie die qpid-server.properties Datei bearbeiten, um den Namen der neuen Datenbankdatei anzugeben, und dann den Qpid-Server neu starten, wie oben beschrieben.

    Alternativ können Sie einen Symlink zur Datei erstellen. Erstellen Sie beispielsweise einen Symlink für „GeoIP2-City-current.mmdb“ zu „GeoIP2-City_20160127.mmdb“. Wenn Sie später eine neue Datenbank mit einem anderen Dateinamen erhalten, müssen Sie nur den Symlink aktualisieren, anstatt den Qpid-Server neu zu konfigurieren.

  4. Ändern Sie die Eigentümerschaft der Datenbankdatei in den Nutzer „apigee“: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Legen Sie die Berechtigungen für die Datenbank auf 744 fest: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Starten Sie den Qpid-Server neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  7. Wiederholen Sie diesen Vorgang auf jedem Qpid-Knoten.