GeoEnrichIP 2025.5.31.15

번들

org.apache.nifi | nifi-enrich-nar

설명

IP 주소의 지리적 위치 정보를 조회하고 FlowFile 특성에 지리적 정보를 추가합니다. 지리적 데이터는 MaxMind 데이터베이스로 제공됩니다. 조회할 IP 주소가 포함된 특성은 ‘IP Address Attribute’ 속성에 의해 제공됩니다. 제공된 특성의 이름이 ‘X’인 경우, 보강으로 추가된 특성은 X.geo.<fieldName> 형식을 취합니다.

태그

enrich, geo, ip, maxmind

입력 요구 사항

REQUIRED

민감한 동적 속성 지원

false

속성

속성

설명

지리 데이터베이스 파일

Maxmind IP 강화 데이터베이스 파일의 경로

IP 주소 특성

보강을 수행해야 하는 점으로 구분된 10진수 IP 주소가 값인 특성의 이름입니다.

로그 수준

데이터베이스에서 IP 를 찾을 수 없을 때 사용할 로깅 수준입니다. 허용되는 값: INFO, DEBUG, WARN, ERROR.

관계

이름

설명

발견됨

데이터베이스에서 제공한 데이터로 특성을 성공적으로 보강한 후 플로우 파일을 라우팅할 위치

찾을 수 없음

데이터를 찾을 수 없어 특성 보강에 실패한 후 플로우 파일을 라우팅할 위치

Writes 특성

이름

설명

X.geo.lookup.micros

지리적 위치 조회에 걸린 마이크로초 수

X.geo.city

IP 주소에 대해 식별된 도시 식별자

X.geo.accuracy

데이터베이스에서 제공하는 경우 정확도 반경(킬로미터 단위)

X.geo.latitude

이 IP 주소의 식별자 위도

X.geo.longitude

이 IP 주소의 식별자 경도

X.geo.subdivision.N

이 IP 주소에 대해 식별되는 각 세분화에는 특성 이름에 0으로 시작하는 숫자 1이 추가됩니다

X.geo.subdivision.isocode.N

X.geo.subdivision.N으로 식별되는 세분화의 ISO 코드

X.geo.country

이 IP 주소의 식별자 국가

X.geo.country.isocode

국가 식별자의 ISO 코드

X.geo.postalcode

식별된 국가의 우편 번호