GeoEnrichIP 프로세서
GeoEnrichIP 프로세서
Openflow의 GeoEnrichIP 프로세서는 IP 주소의 지리 정보를 조회해 FlowFile 속성에 추가해주는 프로세서예요. MaxMind 데이터베이스를 이용해 위치 정보를 제공해요.
출처: Snowflake 문서
본문
번들 (Bundle)
org.apache.nifi | nifi-enrich-nar
설명 (Description)
IP 주소의 지리 정보를 조회해 FlowFile 속성에 추가해요. 지리 데이터는 MaxMind 데이터베이스로 제공돼요. 조회할 IP 주소가 담긴 속성은 'IP Address Attribute' 속성으로 제공돼요. 제공된 속성의 이름이 'X'라면 강화로 추가되는 속성은 X.geo.<fieldName> 형태가 돼요.
태그 (Tags)
enrich, geo, ip, maxmind
입력 요구 사항 (Input Requirement)
필수 (REQUIRED)
민감 동적 속성 지원 (Supports Sensitive Dynamic Properties)
아니요 (false)
속성 (Properties)
| 속성 | 설명 |
|---|---|
| IP Address Attribute | 강화를 수행할 점으로 구분된 10진 IP 주소 값을 가진 속성의 이름이에요. |
| Log Level | 데이터베이스에서 IP를 찾지 못할 때 사용할 로그 레벨이에요. 허용 값: INFO, DEBUG, WARN, ERROR. |
| MaxMind Database File | Maxmind IP 강화 데이터베이스 파일의 경로예요. |
관계 (Relationships)
| 이름 | 설명 |
|---|---|
| found | 데이터베이스가 제공하는 데이터로 속성을 성공적으로 강화한 뒤 FlowFile을 보낼 곳이에요. |
| not found | 데이터를 찾지 못해 속성 강화에 실패한 FlowFile을 보낼 곳이에요. |
쓰기 속성 (Writes attributes)
| 이름 | 설명 |
|---|---|
| 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부터 시작하는 번호를 붙여 추가돼요. |
| X.geo.subdivision.isocode.N | X.geo.subdivision.N으로 식별된 하위 구역의 ISO 코드예요. |
| X.geo.country | 이 IP 주소에 대해 식별된 국가예요. |
| X.geo.country.isocode | 식별된 국가의 ISO 코드예요. |
| X.geo.postalcode | 식별된 국가의 우편번호예요. |