The GeoIP processor adds information about the geographical location of IP addresses, based on data from the Maxmind databases. This processor adds this information by default under the geoip field. The geoip processor can resolve both IPv4 and IPv6 addresses.

The ingest-geoip plugin ships by default with the GeoLite2 City and GeoLite2 Country geoip2 databases from Maxmind made available under the CCA-ShareAlike 3.0 license. For more details see, http://dev.maxmind.com/geoip/geoip2/geolite2/

The GeoIP processor can run with other geoip2 databases from Maxmind. The files must be copied into the geoip config directory, and the database_file option should be used to specify the filename of the custom database. Custom database files must be compressed with gzip. The geoip config directory is located at $ES_HOME/config/ingest/geoip and holds the shipped databases too.

Installationedit

Version 7.0.0-alpha1 of the Elastic Stack has not yet been released.

Removaledit

The plugin can be removed with the following command:

sudo bin/elasticsearch-plugin remove ingest-geoip

The node must be stopped before removing the plugin.