Activer l'agrégation géographique et les cartes géographiques

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 une carte géographique dans la nouvelle interface utilisateur Edge qui indique l'emplacement des requêtes API :

Les agrégations géographiques fonctionnent en extrayant des données géographiques d'une base de données tierce et en les ajoutant aux données d'analyse collectées par Edge. Les informations géographiques peuvent contenir la ville, 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 Maxmind GeoIp2 qui contient ces informations géographiques. Pour en savoir plus, consultez https://www.maxmind.com/en/geoip2-databases

Activer l'agrégation géographique

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

• Sur tous les serveurs Qpid, installez la base de données MaxMind et configurez le serveur Qpid pour l'utiliser it.
• Activez l'affichage de la carte géographique dans la nouvelle 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 Maxmind GeoIp2.
   
2. Créez le dossier suivant sur le nœud du serveur Qpid :

   /opt/apigee/maxmind

3. Téléchargez la base de données Maxmind GeoIp2 dans /opt/apigee/maxmind.
4. Modifiez le propriétaire du fichier de base de données pour 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

   Si vous avez stocké la base de données Maxmind GeoIp2 dans un autre emplacement, modifiez la propriété du chemin d'accès en conséquence.

   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, il peut avoir un numéro de version 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, vous n'aurez qu'à mettre à jour le lien symbolique au lieu de devoir reconfigurer et redémarrer le serveur Qpid.

7. Modifiez le propriétaire 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/apigee-service/bin/apigee-service edge-qpid-server restart

9. Répétez cette procédure sur chaque nœud Qpid.
10. Pour vérifier que l'agrégation géographique fonctionne :
    1. Déclenchez 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 avec des attributs géographiques :

       select * from analytics.agg_geo;

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

       Si la table agg_geo n'est pas remplie, consultez les journaux de serveur Qpid dans /opt/apigee/var/log/edge-qpid-server/logs/ pour détecter d'éventuelles exceptions.

Activer les cartes géographiques dans la nouvelle interface utilisateur Edge

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

1. Définissez le jeton suivant dans /opt/apigee/customer/application/management-ui.properties pour activer les cartes géographiques. Si ce fichier n'existe pas, créez-le :

   conf_uebe_disableGeoMap=false

2. Modifiez le propriétaire du fichier management-ui.properties pour l'utilisateur apigee :

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties

3. Redémarrez la nouvelle interface utilisateur Edge :

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

4. Dans la nouvelle interface utilisateur Edge, sélectionnez Analyze > End Users > Geomap (Analyser > Utilisateurs finaux > Carte géographique) pour afficher les données d'agrégation géographique.

Mettre à jour la base de données MaxMind GeoIp2

MaxMind publie régulièrement des mises à jour de la base de données Maxmind GeoIp2. 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 Maxmind GeoIp2 mise à jour.
2. Téléchargez la base de données Maxmind GeoIp2 dans /opt/apigee/maxmind.
3. Vérifiez le nom du fichier de base de données. S'il est identique à l'ancien fichier, tel que défini dans /opt/apigee/customer/application/qpid-server.properties, passez à l'étape suivante. Toutefois, si le fichier porte un nom différent, vous devez modifier le 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, vous n'aurez qu'à mettre à jour le lien symbolique au lieu de devoir reconfigurer le serveur Qpid.

4. Modifiez le propriétaire du fichier de base de données pour 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/apigee-service/bin/apigee-service edge-qpid-server restart

7. Répétez cette procédure sur chaque nœud Qpid.