lookup

매핑 테이블을 조회하여 특정한 필드 값을 다른 값으로 변환합니다. 먼저 memlookup 명령어를 이용해 룩업 테이블을 구성해야 매핑 테이블을 조회할 수 있습니다.

문법

lookup LOOKUP_TABLE KEY_FIELD output MAP_FIELD [as ALIAS], ...
필수 매개변수
LOOKUP_TABLE
필드 값 변환에 사용할 룩업 테이블. 로그프레소는 country (ISO 2자리 국가 코드), region (지역), city (도시), latitude (위도), longitude (경도) 필드로 구성된 geoip 룩업 테이블을 내장하고 있습니다. 이 테이블을 이용해 IP 주소 타입 혹은 문자열인 입력 필드 값을 매핑 필드의 값으로 변환할 수 있습니다.
KEY_FIELD
룩업 테이블에서 키로 동작하는 필드 이름
output MAP_FIELD [as ALIAS], ...
룩업 테이블에서 키 값과 일치하는 레코드를 검색하고, 해당 레코드에서 지정된 매핑 필드(MAP_FIELD)의 값을 출력 필드(ALIAS)에 할당합니다. as 절을 이용해 출력 필드(ALIAS)를 지정할 수 있습니다. 생략하면 매핑 필드(MAP_FIELD) 이름이 그대로 사용됩니다.
Note
로그프레소 셸에서 logdb.loadCsvLookup 명령으로 미리 매핑 테이블을 적재하거나, geoip처럼 lookup 쿼리 명령어를 지원하는 확장 모듈을 설치할 수 있습니다.

사용 예

geoip를 이용해 IP 주소를 위치 정보로 변환하기

lookup geoip src_ip output country
lookup geoip src_ip output region
lookup geoip src_ip output city
lookup geoip src_ip output latitude, longitude