geoip_service
该 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
maxmind
GeoIP 服务支持 MaxMind GeoIP 和 GeoLite 数据库。默认情况下，Data Prepper 将使用以下所有三个 MaxMind GeoLite2 数据库：
- 城市
- 国家
- ASN
该服务还会自动下载数据库，以使 Data Prepper 与 MaxMind 的更新保持同步。
您可以使用以下选项来配置 maxmind 扩展。
| 选项 | 必需 | 类型 | 描述 |
|---|---|---|---|
databases | 否 | database | 数据库配置。 |
database_refresh_interval | 否 | 持续时间 | 检查 MaxMind 更新的频率。可以是 15 分钟到 30 天之间的任何持续时间。默认值为 PT7D。 |
cache_count | 否 | 整数 | 缓存中最大项目计数，范围为 100-100,000。默认值为 4096。 |
database_destination | 否 | 字符串 | 存储下载数据库的目录名称。默认值为 {data-prepper.dir}/data/geoip。 |
aws | 否 | aws | 配置 AWS 凭证，用于从 Amazon Simple Storage Service (Amazon S3) 下载数据库。 |
insecure | 否 | 布尔型 | 当为 true 时，此选项允许您通过 HTTP 下载数据库文件。默认值为 false。 |
database
| 选项 | 必需 | 类型 | 描述 |
|---|---|---|---|
city | 否 | 字符串 | 数据库所在城市的 URL。可以是清单文件、MMDB 文件或 S3 URL 的 HTTP URL。 |
country | 否 | 字符串 | 数据库所在国家的 URL。可以是清单文件、MMDB 文件或 S3 URL 的 HTTP URL。 |
asn | 否 | 字符串 | 数据库所在的自治系统号 (ASN) 的 URL。可以是清单文件、MMDB 文件或 S3 URL 的 HTTP URL。 |
enterprise | 否 | 字符串 | 数据库所在企业的 URL。可以是清单文件、MMDB 文件或 S3 URL 的 HTTP URL。 |
aws
| 选项 | 必需 | 类型 | 描述 |
|---|---|---|---|
region | 否 | 字符串 | 用于凭证的 AWS 区域。默认值是 用于确定区域的标准 SDK 行为。 |
sts_role_arn | 否 | 字符串 | 用于向 Amazon S3 发出请求的 AWS 安全令牌服务 (AWS STS) 角色。默认值为 null，这将使用 用于凭证的标准 SDK 行为。 |
aws_sts_header_overrides | 否 | 映射 | 标头覆盖的映射，当从 Amazon S3 下载时，AWS 身份和访问管理 (IAM) 角色会承担这些标头覆盖。 |
sts_external_id | 否 | 字符串 | 当 Data Prepper 承担 STS 角色时使用的 STS 外部 ID。有关更多信息，请参阅 STS AssumeRole API 参考中的 ExternalID 文档。 |