Skip to content
share library_books

Add GeoIP information to logs

Output filter: geoip

This plugin adds GeoIP information to logs. An everyday use case is to enrich web server logs, or any logs with IP addresses, with geographical information derived from those IP addresses.

Things you do not need to think about at all:

  • The Maxmind GeoIP lite database is downloaded automatically to /tmp/ To change the location of the DB set MAXMIND_DB_DIR=path
  • Integrated automatic updates for the GeoIP database. The update check runs every hour.
  • Elasticsearch mapping for the Geo-Coordinates in Sematext Logs for geographic queries and map displays. Sematext Logs indices support the geoip field out of the box.


Here is how to enable Geo IP lookups for your logs:

  1. Command line

    logagent  --geoipEnabled true --geoipFields "client_ip,remote_address"

  1. Environment variables

   MAXMIND_LICENSE_KEY="<your MaxMind license key>"

  1. Configuration file

Add the following outputFilter section to the Logagent configuration file. Note that you can use the plugin with multiple configurations for different event sources.

# Logagent configuration file: logagent-geoip.yml 
# tail web server logs
    - '/var/log/*/access_log'

# Logagent parses web server logs out of the box ...
# Output filter to perform GeoIP lookups 
# for the field client_ip or remote_address
    module: geoip
      - client_ip
      - remote_address

Test Logagent with your config:

logagent --config logagent-geoip.yml -n httpd --yaml

The output contains new fields under geoip with the location of the IP address.

logSource:    httpd
_type:       access_log_combined
remote_id:   -
user:        -
method:      GET
path:        /about/ HTTP/1.1
status_code: 200
size:        14243
user_agent:  Mozilla/5.0 (iPhone; CPU iPhone OS 8_1_1 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Mobile/12B436 Twitter for iPhone
@timestamp:  Sun Apr 03 2016 08:25:38 GMT+0200 (Central European Summer Time)
message:     GET /about/ HTTP/1.1
    - -70.6653
    - -33.4513
    country:   CL
    continent: SA
    city:      Santiago