GeoEnrichIP 2025.10.9.21

Bundle

org.apache.nifi | nifi-enrich-nar

Description

Looks up geolocation information for an IP address and adds the geo information to FlowFile attributes. The geo data is provided as a MaxMind database. The attribute that contains the IP address to lookup is provided by the ‘IP Address Attribute’ property. If the name of the attribute provided is ‘X’, then the attributes added by enrichment will take the form X.geo.<fieldName>

Tags

enrich, geo, ip, maxmind

Input Requirement

REQUIRED

Supports Sensitive Dynamic Properties

false

Properties

PropertyDescription
IP Address AttributeThe name of an attribute whose value is a dotted decimal IP address for which enrichment should occur
Log LevelThe Log Level to use when an IP is not found in the database. Accepted values: INFO, DEBUG, WARN, ERROR.
MaxMind Database FilePath to Maxmind IP Enrichment Database File

Relationships

NameDescription
foundWhere to route flow files after successfully enriching attributes with data provided by database
not foundWhere to route flow files after unsuccessfully enriching attributes because no data was found

Writes attributes

NameDescription
X.geo.lookup.microsThe number of microseconds that the geo lookup took
X.geo.cityThe city identified for the IP address
X.geo.accuracyThe accuracy radius if provided by the database (in Kilometers)
X.geo.latitudeThe latitude identified for this IP address
X.geo.longitudeThe longitude identified for this IP address
X.geo.subdivision.NEach subdivision that is identified for this IP address is added with a one-up number appended to the attribute name, starting with 0
X.geo.subdivision.isocode.NThe ISO code for the subdivision that is identified by X.geo.subdivision.N
X.geo.countryThe country identified for this IP address
X.geo.country.isocodeThe ISO Code for the country identified
X.geo.postalcodeThe postal code for the country identified