DNS 反向查找
编辑DNS 反向查找
编辑dns 处理器执行 DNS 查询。它根据响应中包含的生存时间 (TTL) 值缓存接收到的响应。它还会缓存查找过程中发生的错误。此处理器的每个实例都维护其自己的独立缓存。
处理器使用其自身的 DNS 解析器向名称服务器发送请求，而不使用操作系统的解析器。它不读取/etc/hosts中包含的任何值。
如果您的网络延迟很高或上游名称服务器速度很慢，则此处理器可能会显着降低管道吞吐量。缓存将有助于提高性能，但如果正在解析的地址具有高基数，则由于缓存未命中率较高，缓存带来的好处将减少。
例如，如果每个 DNS 查找需要 2 毫秒，则可以达到的最大吞吐量为每秒 500 个事件（1000 毫秒 / 2 毫秒）。如果您的缓存命中率很高，则吞吐量可能会更高。
处理器可以发送以下查询类型
-
A- IPv4 地址 -
AAAA- IPv6 地址 -
TXT- 任意人类可读的文本数据 -
PTR- 反向 IP 地址查找
除了PTR之外，所有查询类型的输出值都是字符串列表。对于PTR查询，输出值是一个字符串。
这是一个最小的配置示例，它解析两个字段中包含的 IP 地址。
processors:
- dns:
type: reverse
fields:
source.ip: source.domain
destination.ip: destination.domain
接下来是一个显示所有选项的配置示例。
processors:
- dns:
type: reverse
action: append
transport: tls
fields:
server.ip: server.domain
client.ip: client.domain
success_cache:
capacity.initial: 1000
capacity.max: 10000
min_ttl: 1m
failure_cache:
capacity.initial: 1000
capacity.max: 10000
ttl: 1m
nameservers: ['192.0.2.1', '203.0.113.1']
timeout: 500ms
tag_on_failure: [_dns_reverse_lookup_failed]
dns 处理器具有以下配置设置
-
类型 - 要执行的 DNS 查询类型。支持的类型为
A、AAAA、PTR（或reverse）和TXT。 -
操作 - 这定义了当事件中已存在目标字段时处理器的行为。选项为
append（默认值）和replace。 -
字段 - 这是源字段名到目标字段名的映射。源字段的值将用于 DNS 查询，结果将写入目标字段。
-
success_cache.capacity.initial - 成功缓存将分配用于保存的项目的初始数量。初始化时，处理器将为这些项目的数量分配内存。默认值为
1000。 -
success_cache.capacity.max - 成功缓存可以容纳的项目的最大数量。达到最大容量时，将逐出随机项。默认值为
10000。 -
success_cache.min_ttl - 成功 DNS 响应的最小备用缓存 TTL 的持续时间。确保可以缓存
TTL=0成功的反向 DNS 响应。有效的时间单位为“ns”、“us”（或“µs”）、“ms”、“s”、“m”、“h”。默认值为1m。 -
failure_cache.capacity.initial - 错误缓存将分配用于保存的项目的初始数量。初始化时，处理器将为这些项目的数量分配内存。默认值为
1000。 -
failure_cache.capacity.max - 错误缓存可以容纳的项目的最大数量。达到最大容量时，将逐出随机项。默认值为
10000。 -
failure_cache.ttl - 缓存错误的持续时间。有效的时间单位为“ns”、“us”（或“µs”）、“ms”、“s”、“m”、“h”。默认值为
1m。 -
名称服务器 - 要查询的名称服务器列表。如果有多个服务器，解析器会按列出的顺序查询它们。如果未指定任何服务器，则它将在初始化时读取
/etc/resolv.conf中列出的名称服务器。在 Windows 上，您必须始终至少提供一个名称服务器。 -
超时 - DNS 查询超时之前的持续时间。这是每个 DNS 请求的超时时间，因此如果您有两个名称服务器，则总超时时间将是该值的 2 倍。有效的时间单位为“ns”、“us”（或“µs”）、“ms”、“s”、“m”、“h”。默认值为
500ms。 -
tag_on_failure - 任何查找失败时要添加到事件的标签列表。即使多个查找失败，标签也只添加一次。默认情况下，失败时不会添加任何标签。
-
传输 - 应使用的传输连接类型可以是
tls（DNS over TLS）或udp。默认为udp。