Diese Seite wurde von der Cloud Translation API übersetzt.

Aggregation von Geodaten und Landkarten aktivieren

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

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

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

Geografische Aggregation aktivieren

Standardmäßig sind die geografischen Aggregationen nicht aktiviert. So aktivieren Sie geografische Aggregationen:

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

MaxMind-Datenbank auf allen Edge-Qpid-Servern installieren

Gehen Sie so vor, um die MaxMind-Datenbank auf allen Edge-Qpid-Servern zu installieren:

Maxmind GeoIp2-Datenbank abrufen

Hinweis: Bei geografischen Aggregationen werden geografische Daten aus einer Drittanbieterdatenbank zu den von Edge erfassten Analysedaten hinzugefügt. Wenn Sie die geografische Aggregation verwenden möchten, müssen Sie die Maxmind GeoIp2-Datenbank erwerben, die diese Informationen enthält. Weitere Informationen finden Sie unter https://www.maxmind.com/en/geoip2-databases.
Erstellen Sie den folgenden Ordner auf dem Qpid-Serverknoten:
```
/opt/apigee/maxmind
```
Laden Sie die Maxmind GeoIp2-Datenbank in /opt/apigee/maxmind herunter.
Ändern Sie den Eigentümer der Datenbankdatei in den Nutzer „apigee“:
```
chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
```
Legen Sie die Berechtigungen für die Datenbank auf 744 fest:
```
chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
```
Legen Sie die folgenden Tokens in /opt/apigee/customer/application/qpid-server.properties fest. Wenn diese 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 Ort 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 diese 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.
Ändern Sie die Eigentümerschaft der Datei qpid-server.properties zum Nutzer „apigee“:
```
chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
```

Starten Sie den Qpid-Server neu:

/opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart

Wiederholen Sie diesen Vorgang auf jedem Qpid-Knoten.
So prüfen Sie, ob die geografische 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 aufzurufen:
```
select * from analytics.agg_geo;
```
  In den Abfrageergebnissen sollten die folgenden Spalten angezeigt werden, die aus der Maxmind GeoIp2-Datenbank extrahiert werden: 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-Serverlogs unter /opt/apigee/var/log/edge-qpid-server/logs/ auf mögliche Ausnahmen.

Geokarten in der Edge-Benutzeroberfläche aktivieren

Gehen Sie so vor, um geografische Karten in der Edge-Benutzeroberfläche zu aktivieren:

Legen Sie das folgende Token in /opt/apigee/customer/application/ui.properties fest, um geografische Karten zu aktivieren. Wenn diese Datei nicht vorhanden ist, erstellen Sie sie:
```
conf_apigee_apigee.feature.disablegeomap=false
```
Hinweis:In einer Air-Gap-Umgebung, in der die Edge-Benutzeroberfläche keinen Internetzugriff hat, führt die Aktivierung der GeoMap-Funktion zu einer erheblichen Ladeverzögerung von etwa 20 bis 30 Sekunden für die Edge-Benutzeroberfläche. Diese Verzögerung tritt auf, weil die Funktion versucht, die Google Maps JavaScript API von einem externen Google-Server zu laden. Diese Anfrage läuft in einer Umgebung ohne Internetverbindung ab. Um diese Verzögerung zu vermeiden, empfiehlt es sich, das GeoMap-Feature in einer Air-Gap-Umgebung deaktiviert zu lassen. Dazu muss in der Datei /opt/apigee/customer/application/ui.properties das Attribut conf_apigee_apigee.feature.disablegeomap auf true gesetzt sein.
Ändern Sie den Eigentümer der Datei „ui.properties“ in den Nutzer „apigee“:
```
chown apigee:apigee /opt/apigee/customer/application/ui.properties
```

Starten Sie die Edge-Benutzeroberfläche neu:

/opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart

Wählen Sie in der Edge-Benutzeroberfläche Analytics > Geomap aus, um die Daten zur geografischen Aggregation aufzurufen.

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:

Aktualisierte Maxmind GeoIp2-Datenbank abrufen
Laden Sie die Maxmind GeoIp2-Datenbank in /opt/apigee/maxmind herunter.
Prüfen Sie den Namen der Datenbankdatei. Wenn sie mit 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 Datei qpid-server.properties 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 symbolischen Link 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 und nicht den Qpid-Server neu konfigurieren.
Ändern Sie den Eigentümer der Datenbankdatei in den Nutzer „apigee“:
```
chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
```
Legen Sie die Berechtigungen für die Datenbank auf 744 fest:
```
chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
```

Starten Sie den Qpid-Server neu:

/opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart

Wiederholen Sie diesen Vorgang auf jedem Qpid-Knoten.