GeoEnrichIPRecord 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. This version uses the NiFi Record API to allow large scale enrichment of record-oriented data sets. Each field provided by the MaxMind database can be directed to a field of the user’s choosing by providing a record path for that field configuration.
Tags¶
enrich, geo, ip, maxmind, record
Input Requirement¶
REQUIRED
Supports Sensitive Dynamic Properties¶
false
Properties¶
| Property | Description |
|---|---|
| City Record Path | Record path for putting the city identified for the IP address |
| Country ISO Code Record Path | Record path for putting the ISO Code for the country identified |
| Country Postal Code Record Path | Record path for putting the postal code for the country identified |
| Country Record Path | Record path for putting the country identified for this IP address |
| IP Address Record Path | The record path to retrieve the IP address for doing the lookup. |
| Latitude Record Path | Record path for putting the latitude identified for this IP address |
| Log Level | The Log Level to use when an IP is not found in the database. Accepted values: INFO, DEBUG, WARN, ERROR. |
| Longitude Record Path | Record path for putting the longitude identified for this IP address |
| MaxMind Database File | Path to Maxmind IP Enrichment Database File |
| Record Reader | Record reader service to use for reading the flowfile contents. |
| Record Writer | Record writer service to use for enriching the flowfile contents. |
| Separate Enriched From Not Enriched | Separate records that have been enriched from ones that have not. Default behavior is to send everything to the found relationship if even one record is enriched. |
Relationships¶
| Name | Description |
|---|---|
| found | Where to route flow files after successfully enriching attributes with data provided by database |
| not found | Where to route flow files after unsuccessfully enriching attributes because no data was found |
| original | The original input flowfile goes to this relationship regardless of whether the content was enriched or not. |