Cómo habilitar la agregación geográfica y los mapas geográficos

Las agregaciones geográficas te permiten recopilar datos de estadísticas para llamadas a la API según la ubicación atributos como región, continente, país y ciudad. A partir de estos datos de estadísticas, puedes ver un GeoMap en la IU de Edge que muestra la ubicación de las solicitudes a la API:

Las agregaciones geográficas funcionan mediante la extracción de datos geográficos de una base de datos de terceros y la adición a los datos de estadísticas que recopila Edge. La información geográfica puede contener la ciudad, el país, el continente, la zona horaria y la región de una solicitud realizada a un proxy de API.

Para usar la agregación geográfica, debes comprar la base de datos Maxmind GeoIp2 que contiene este información geográfica. Consulta https://www.maxmind.com/en/geoip2-databases para obtener más información.

Habilita la agregación geográfica

De forma predeterminada, las agregaciones geográficas no están habilitadas. Para habilitar las agregaciones geográficas, debes hacer lo siguiente:

  • Instala la base de datos MaxMind y configura el servidor Qpid para usar en todos los servidores Qpid. que la modifica.
  • Habilita la visualización del mapa geográfico en la IU de Edge.

Instala MaxMind Base de datos en todos los servidores Qpid de Edge

Usa el siguiente procedimiento para instalar la base de datos de MaxMind en todos los servidores de Edge Qpid:

  1. Obtén la base de datos de Maxmind GeoIp2.
  2. Crea la siguiente carpeta en el nodo del servidor Qpid: 
    /opt/apigee/maxmind
  3. Descarga la base de datos de Maxmind GeoIp2 en /opt/apigee/maxmind.
  4. Cambiar la propiedad del archivo de base de datos a Apigee usuario: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Configura los permisos de la base de datos en 744: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Configura los siguientes tokens en /opt/apigee/customer/application/qpid-server.properties. Si ese archivo no existe, créalo: 
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

    Si almacenaste la base de datos Maxmind GeoIp2 en una ubicación diferente, edita la propiedad de la ruta de acceso. según corresponda.

    Ten en cuenta que este archivo de base de datos contiene un número de versión. Si luego recibes una actualización archivo de base de datos, podría tener un número de versión diferente. Como alternativa, crea un symlink para el archivo de base de datos y usa el symlink en qpid-server.properties.

    Por ejemplo, crea un symlink para "GeoIP2-City-current.mmdb". a “GeoIP2-City_20160127.mmdb”. Si después recibes una nueva base de datos con un nombre de archivo diferente, solo tienes que actualizar el symlink, en lugar de tener que reconfigurar y reiniciar el servidor Qpid.

  7. Cambiar la propiedad del archivo qpid-server.properties a “apigee” usuario: 
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Reinicia el servidor Qpid: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  9. Repite este proceso en cada nodo Qpid.
  10. Para validar que la agregación geográfica funciona, sigue estos pasos:
    1. Activar varias llamadas de proxy de API en un proxy de API de muestra
    2. Espera entre 5 y 10 minutos para que se completen las agregaciones.
    3. Abre una consola y conéctate al servidor de Edge Postgres: 
      psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. Realiza una consulta SELECT en la tabla analytics.agg_geo para mostrar las filas con atributos geográficos: 
      select * from analytics.agg_geo;

      Deberías ver las siguientes columnas en los resultados de la consulta, que se extrajeron de Base de datos de Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.

      Si la tabla agg_geo no se completa, verifica los registros del servidor Qpid en /opt/apigee/var/log/edge-qpid-server/logs/ para detectar cualquier posible excepciones.

Habilitar los mapas geográficos en la IU de Edge

Usa el siguiente procedimiento para habilitar los mapas geográficos en la IU de Edge:

  1. Configura el siguiente token en /opt/apigee/customer/application/ui.properties para habilitar los mapas geográficos. Si ese archivo no existe, créalo: 
    conf_apigee_apigee.feature.disablegeomap=false
  2. Cambiar la propiedad del archivo ui.properties al archivo “apigee” usuario: 
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Reinicia la IU de Edge: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
  4. En la IU de Edge, selecciona Analytics > GeoMap para mostrar la agregación geográfica de datos no estructurados.

Actualiza la base de datos de MaxMind GeoIp2

MaxMind emite actualizaciones periódicas a la base de datos GeoIp2 de Maxmind. Si recibes una actualización base de datos, usa el siguiente procedimiento para instalarla en Edge:

  1. Obtén la base de datos actualizada de Maxmind GeoIp2.
  2. Descarga la base de datos de Maxmind GeoIp2 en /opt/apigee/maxmind.
  3. Verifica el nombre del archivo de la base de datos. Si es igual al archivo anterior, como se define en /opt/apigee/customer/application/qpid-server.properties, continúa con el paso siguiente. Sin embargo, si el archivo tiene un nombre diferente, deberás editar el archivo qpid-server.properties para especificar el nombre del archivo de base de datos nuevo y, luego, reiniciar el servidor Qpid como se describió anteriormente.

    Como alternativa, puedes crear un symlink al archivo. Por ejemplo, crea un symlink para “GeoIP2-City-current.mmdb” a “GeoIP2-City_20160127.mmdb”. Si luego recibes una base de datos nueva con un nombre de archivo diferente, solo debes actualizar el symlink en lugar de reconfigurar el servidor Qpid.

  4. Cambiar la propiedad del archivo de base de datos a Apigee usuario: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Configura los permisos de la base de datos en 744: 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Reinicia el servidor Qpid: 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  7. Repite este proceso en cada nodo Qpid.