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

Edge para nube privada v. 4.17.05

Las agregaciones geográficas te permiten recopilar datos de estadísticas para las llamadas a la API según atributos geográficos, como la región, el continente, el país y la ciudad. A partir de estos datos de estadísticas, puedes ver un mapa geográfico 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 su incorporació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 esta información geográfica. Consulta https://www.maxmind.com/en/geoip2-databases para obtener más información.

Cómo habilitar 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:

  • En todos los servidores de Qpid, instala la base de datos de MaxMind y configura el servidor de Qpid para que la use.
  • Habilitar la visualización del mapa geográfico en la IU de Edge

Instala la base de datos de MaxMind en todos los servidores de Qpid de Edge

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

  1. Obtén la base de datos Maxmind GeoIp2.
    Nota: Las agregaciones geográficas funcionan agregando datos geográficos de una base de datos de terceros a los datos de estadísticas que recopila Edge. Para usar la agregación geográfica, debes comprar la base de datos Maxmind GeoIp2 que contiene esta información. Consulta https://www.maxmind.com/en/geoip2-databases para obtener más información.
  2. Crea la siguiente carpeta en el nodo del servidor de Qpid:
    /opt/apigee/maxmind
  3. Descarga la base de datos de Maxmind GeoIp2 a /opt/apigee/maxmind.
  4. Cambia la propiedad del archivo de base de datos al usuario de “apigee”:
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Establece los permisos en 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




    Ten en cuenta que este archivo de base de datos contiene un número de versión. Si luego recibes un archivo de base de datos actualizado, es posible que tenga un número de versión diferente. Como alternativa, crea un symlink al archivo de la base de datos y úsalo en qpid-server.properties.

    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 tendrás que actualizar el symlink, en lugar de tener que volver a configurar y reiniciar el servidor de Qpid.
  7. Cambia la propiedad del archivo qpid-server.properties al usuario de “apigee”:
    > chown apigee:apigee:/opt/apigee/customer/application/qpid-server.properties
  8. Reinicia el servidor de Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-qpid-server restart
  9. Repite este proceso en cada nodo de Qpid.
  10. Para validar que la agregación geográfica funcione, sigue estos pasos:
    1. Activar varias llamadas al proxy de la 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:
      apigee=# select * from analytics.agg_geo;

      Deberías ver las siguientes columnas en los resultados de la consulta que se extraen de la base de datos de Maxmind GeoIp2: ax_geo_city, ax_geo_country, ax_geo_geo_geo_geo.

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

Habilita mapas geográficos en la IU de Edge

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

  1. Establece el siguiente token en /opt/apigee/customer/application/ui.properties para habilitar Geo Maps. Si ese archivo no existe, créalo:
    conf_apigee_apigee.feature.disablegeomap=false
  2. Cambia la propiedad del archivo ui.properties al usuario “apigee”:
    > 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 los datos de agregación geográfica.

Actualiza la base de datos de MaxMind GeoIp2

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

  1. Obtén la base de datos de Maxmind GeoIp2 actualizada.
  2. Descarga la base de datos de Maxmind GeoIp2 a /opt/apigee/maxmind.
  3. Verifica el nombre del archivo de la base de datos. Si es igual que el archivo anterior, como se define en /opt/apigee/customer/application/qpid-server.properties, continúa con el siguiente paso. Sin embargo, si el archivo tiene un nombre diferente, debes editar el archivo qpid-server.properties para especificar el nombre del nuevo archivo de base de datos y, luego, reiniciar el servidor de 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 tendrás que actualizar el symlink, en lugar de tener que volver a configurar el servidor de Qpid.
  4. Cambia la propiedad del archivo de base de datos al usuario de “apigee”:
    > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. Establece los permisos en la base de datos en 744:
    > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Reinicia el servidor de Qpid:
    > /opt/apigee/bin/apigee-service/bin/apigee-serviceedge-qpid-server restart
  7. Repite este proceso en cada nodo de Qpid.