GeoIP service extension

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

geoip_service 확장은 OpenSearch Data Prepper의 모든 geoip 프로세서를 구성해요.

Data Prepper가 geoip 프로세서에 사용하는 GeoIP 서비스를 구성할 수 있어요. 기본적으로 GeoIP 서비스는 maxmind 옵션이 구성되어 제공돼요.

다음 예제는 data-prepper-config.yaml 파일에서 geoip_service를 구성하는 방법을 보여줘요.

extensions:
  geoip_service:
    maxmind:
      database_refresh_interval: PT1H
      cache_count: 16_384

GeoIP 서비스는 MaxMind GeoIP 및 GeoLite 데이터베이스를 지원해요. 기본적으로 Data Prepper는 다음 MaxMind GeoLite2 데이터베이스 세 개를 모두 사용해요:

또한 서비스는 데이터베이스를 자동으로 다운로드하여 Data Prepper가 MaxMind의 변경 사항을 최신 상태로 유지해요.

다음 옵션을 사용하여 maxmind 확장을 구성할 수 있어요.

옵션	필수	유형	설명
`databases`	아니요	database	데이터베이스 구성이에요.
`database_refresh_interval`	아니요	Duration	MaxMind에서 업데이트를 확인하는 빈도예요. 15분에서 30일 사이의 기간으로 설정할 수 있어요. 기본값은 `PT7D`예요.
`cache_count`	아니요	Integer	캐시 항목 수에 따른 최대 캐시 개수예요. 범위는 100~100,000이에요. 기본값은 `4096`이에요.
`database_destination`	아니요	String	다운로드한 데이터베이스를 저장할 디렉터리 이름이에요. 기본값은 `{data-prepper.dir}/data/geoip`예요.
`aws`	아니요	`aws`	Amazon Simple Storage Service(Amazon S3)에서 데이터베이스를 다운로드하기 위한 AWS 자격 증명을 구성해요.
`insecure`	아니요	Boolean	`true`로 설정하면 HTTP를 통해 데이터베이스 파일을 다운로드할 수 있어요. 기본값은 `false`예요.

옵션	필수	유형	설명
`city`	아니요	String	데이터베이스가 있는 도시의 URL이에요. 매니페스트 파일, MMDB 파일 또는 S3 URL의 HTTP URL일 수 있어요.
`country`	아니요	String	데이터베이스가 있는 국가의 URL이에요. 매니페스트 파일, MMDB 파일 또는 S3 URL의 HTTP URL일 수 있어요.
`asn`	아니요	String	데이터베이스가 있는 자율 시스템 번호(ASN)의 URL이에요. 매니페스트 파일, MMDB 파일 또는 S3 URL의 HTTP URL일 수 있어요.
`enterprise`	아니요	String	데이터베이스가 있는 엔터프라이즈의 URL이에요. 매니페스트 파일, MMDB 파일 또는 S3 URL의 HTTP URL일 수 있어요.

옵션	필수	유형	설명
`region`	아니요	String	자격 증명에 사용할 AWS 리전이에요. 기본값은 리전 결정을 위한 표준 SDK 동작을 따라요.
`sts_role_arn`	아니요	String	Amazon S3 요청에 사용할 AWS Security Token Service(AWS STS) 역할이에요. 기본값은 `null`이며, 이 경우 자격 증명에 대한 표준 SDK 동작을 사용해요.
`aws_sts_header_overrides`	아니요	Map	Amazon S3에서 다운로드할 때 AWS Identity and Access Management(IAM) 역할이 사용하는 헤더 재정의 맵이에요.
`sts_external_id`	아니요	String	Data Prepper가 STS 역할을 수임할 때 사용하는 STS 외부 ID예요. 자세한 내용은 STS AssumeRole API 참조의 `ExternalID` 문서를 참조해요.