Activer Geo Agrégation et Geo Maps

Edge pour Private Cloud version 4.17.01

Les agrégations géographiques vous permettent de collecter des données d'analyse pour les appels d'API en fonction d'attributs géographiques tels que la région, le continent, le pays et la ville. À partir de ces données d'analyse, vous pouvez afficher un GeoMap dans l'interface utilisateur Edge qui indique l'emplacement des requêtes API:

Les agrégations géographiques consistent à extraire des données géographiques d'une base de données tierce et à les ajouter aux données d'analyse collectées par Edge. Les informations géographiques peuvent contenir la ville, le pays, le continent, le fuseau horaire et la région d'une requête adressée à un proxy d'API.

Pour utiliser l'agrégation géographique, vous devez acheter la base de données GeoIp2 Maxmind qui contient ces informations géographiques. Pour en savoir plus, consultez la page https://www.maxmind.com/en/geoip2-databases.

Activation de l'agrégation géographique

Par défaut, les agrégations géographiques ne sont pas activées. Pour activer les agrégations géographiques, vous devez:

  • Sur tous les serveurs Qpid, installez la base de données MaxMind et configurez le serveur Qpid pour l'utiliser.
  • Activer l'affichage de Geo Map dans l'interface utilisateur Edge.

Installer la base de données MaxMind sur tous les serveurs Edge Qpid

Procédez comme suit pour installer la base de données MaxMind sur tous les serveurs Edge Qpid:

  1. Obtenez la base de données GeoIp2 Maxmind.
    Remarque: Les agrégations géographiques fonctionnent en ajoutant des données géographiques d'une base de données tierce aux données d'analyse collectées par Edge. Pour utiliser l'agrégation géographique, vous devez acheter la base de données GeoIp2 Maxmind qui contient ces informations. Pour en savoir plus, consultez la page https://www.maxmind.com/en/geoip2-databases.
  2. Créez le dossier suivant sur le nœud de serveur Qpid:
    /opt/apigee/maxmind
  3. Téléchargez la base de données GeoIp2 de Maxmind dans /opt/apigee/maxmind.
  4. Changez la propriété du fichier de base de données à l'utilisateur "apigee" :
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Définissez les autorisations sur la base de données sur 744:
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Définissez les jetons suivants dans /opt/apigee/customer/application/qpid-server.properties. Si ce fichier n'existe pas, créez-le:
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
    conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb




    Notez que ce fichier de base de données contient un numéro de version. Si vous recevez ultérieurement un fichier de base de données mis à jour, son numéro de version peut être différent. Vous pouvez également créer un lien symbolique vers le fichier de base de données et l'utiliser dans qpid-server.properties.

    Par exemple, créez un lien symbolique pour "GeoIP2-City-current.mmdb" vers "GeoIP2-City_20160127.mmdb". Si vous recevez ultérieurement une nouvelle base de données avec un nom de fichier différent, il vous suffit de mettre à jour le lien symbolique au lieu de devoir reconfigurer et redémarrer le serveur Qpid.
  7. Changez la propriété du fichier qpid-server.properties pour l'utilisateur "apigee" :
    > chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Redémarrez le serveur Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-qpid-server restart
  9. Répétez ce processus sur chaque nœud Qpid.
  10. Pour vérifier le bon fonctionnement de l'agrégation géographique :
    1. Déclencher plusieurs appels de proxy d'API sur un exemple de proxy d'API
    2. Attendez environ 5 à 10 minutes que les agrégations se terminent.
    3. Ouvrez une console et connectez-vous au serveur Edge Postgres:
      > psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. Exécutez une requête SELECT sur la table analytics.agg_geo pour afficher les lignes comportant des attributs géographiques:
      apigee=# select * from analytics.agg_geo;

      Les colonnes suivantes doivent s'afficher dans les résultats de la requête, qui sont extraites de la base de données GeoIp2 Maxmind: ax_geo_city, ax_geo_country, ax_geo_region, ax_geo_continent, ax_geo_continent.

      Si la table agg_geo n'est pas renseignée, consultez les journaux du serveur Qpid à l'adresse /opt/apigee/var/log/edge-qpid-server/logs/ pour détecter toute exception potentielle.

Activer les cartes géographiques dans l'interface utilisateur Edge

Procédez comme suit pour activer les cartes géographiques dans l'interface utilisateur Edge:

  1. Définissez le jeton suivant dans /opt/apigee/customer/application/ui.properties pour activer Geo Maps. Si ce fichier n'existe pas, créez-le:
    conf_apigee_apigee.feature.disablegeomap=false
  2. Changez la propriété du fichier ui.properties pour l'utilisateur "apigee" :
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Redémarrez l'interface utilisateur Edge:
    > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-ui restart
  4. Dans l'interface utilisateur Edge, sélectionnez Analytics > GeoMap pour afficher les données d'agrégation géographique.

Mettre à jour la base de données GeoIp2 MaxMind

MaxMind publie des mises à jour périodiques de la base de données GeoIp2 de Maxmind. Si vous recevez une base de données mise à jour, procédez comme suit pour l'installer sur Edge:

  1. Obtenez la base de données GeoIp2 Maxmind mise à jour.
  2. Téléchargez la base de données GeoIp2 de Maxmind dans /opt/apigee/maxmind.
  3. Vérifiez le nom du fichier de base de données. Si elle est identique à l'ancien fichier, comme défini dans la section /opt/apigee/customer/application/qpid-server.properties, passez à l'étape suivante. Toutefois, si le fichier porte un nom différent, vous devez modifier le fichier qpid-server.properties pour spécifier le nom du nouveau fichier de base de données, puis redémarrer le serveur Qpid, comme décrit ci-dessus.

    Vous pouvez également créer un lien symbolique vers le fichier. Par exemple, créez un lien symbolique pour "GeoIP2-City-current.mmdb" vers "GeoIP2-City_20160127.mmdb". Si vous recevez ultérieurement une nouvelle base de données avec un nom de fichier différent, il vous suffit de mettre à jour le lien symbolique au lieu de devoir reconfigurer le serveur Qpid.
  4. Changez la propriété du fichier de base de données à l'utilisateur "apigee" :
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Définissez les autorisations sur la base de données sur 744:
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Redémarrez le serveur Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-qpid-server restart
  7. Répétez ce processus sur chaque nœud Qpid.