GeoIP data for Tracker documents
TORO Integrate can also automatically add geolocation data to a
Tracker document from an HTTP request. It does this by leveraging
MaxMind's GeoIP database. You can either install the database yourself in the
data/geoip
directory, or have TORO Integrate download and update them for you.
Installation using the user interface
To have TORO Integrate download the GeoIP database for you, hover over the Configuration menu in the Server Admin UI, then click Geo. IP Database.
Once the file has been downloaded, a dialog will appear telling you that it has completed:
Installation using REST endpoints
TORO Integrate also provides REST endpoints for downloading and updating the GeoIP database.
Send a POST
request to the following endpoint to download the database:
<host>:<port>/esbapi/tracker/geoip/initialize
.
The easiest way to do this is to use the API Explorer.
TORO Integrate will also log messages similar to the ones below outlining that the database has been downloaded.
1 2 3 4 | 14/09/18 16:33:31.750 INFO [MaxmindGeoIpService] Starting download on http://geolite.maxmind.com/download/geoip/database/GeoLite2-City.mmdb.gz 14/09/18 16:33:42.833 INFO [MaxmindGeoIpService] GeoIP database http://geolite.maxmind.com/download/geoip/database/GeoLite2-City.mmdb.gz downloaded to /opt/toro-integrate/data/geoip/GeoIP2-City.mmdb.gz 14/09/18 16:33:42.839 INFO [MaxmindGeoIpService] Starting download on http://geolite.maxmind.com/download/geoip/database/GeoLite2-Country.mmdb.gz 14/09/18 16:33:43.664 INFO [MaxmindGeoIpService] GeoIP database http://geolite.maxmind.com/download/geoip/database/GeoLite2-Country.mmdb.gz downloaded to /opt/toro-integrate/data/geoip/GeoIP2-Country.mmdb.gz |
GeoIP properties
Once the database is installed, any subsequent document that was created from an HTTP request will have the Request
City
, Request Coordinates
, and Request Country
properties added, as shown below:
Integration with Google Maps
TORO Integrate can also show a map of the GeoIP location. To enable this, get a Google Maps API
key, and add it to the tracker.maps.google.apiKey
application property. Once this is done, the Server Admin UI will also display a map of the
location for all existing and new documents with the related GeoIP properties.