Geo Data Resolution

Luden looks up geolocation data by IP address during enrichment step. Here's a full list of fields Luden could get from the IP address:

{
  "location": {
    "continent": "North America",
    "country": "US",
    "country_name": "United States",
    "region": "NY",
    "city": "New York",
    "latitude": 40.7809,
    "longitude": -73.9502,
    "zip": "10128",
    "autonomous_system_number": 16509,
    "autonomous_system_organization": "AMAZON-02",
    "organization": "Amazon.com",
    "domain": "amazonaws.com"
  }
}

Configuration

Luden uses MaxMind databases for doing geo lookup. There are two families of MaxMind databases: GeoIP2 and GeoLite2.

GeoIP2 databases such as GeoIP2-Country, GeoIP2-City, GeoIP2-ISP, GeoIP2-Domain are paid product. You can buy a license on maxmind.com. After purchasing, you will receive a license key. You can use the license key Luden:

• Put obtained license key on Luden UI → Geo data resolver section if you're using Configurator UI.

• Or use MAX_MIND_PATH env variable.

GeoLite2 databases such as GeoLite2-Country, GeoLite2-City, GeoLite2-ASN are free. For obtaining them you should just create a free account and generate a license key. Configuration steps are the same as with paid database: either put obtained license key on Jitsu UI → Geo data resolver, or useMAX_MIND_PATH

With the key, Luden will download all databases available for the key. If you want to limit the databases, you can specify them as a postfix to Maxmind license key as [key]?edition_id=GeoIP2-City,GeoIP2-ISP

Also, you can point MAX_MIND_PATH environment variable directly to a local file.