Udp 输入插件
编辑Udp 输入插件编辑
- 插件版本: v3.5.0
- 发布日期: 2021-08-04
- 变更日志
有关其他版本,请参阅 版本化插件文档。
获取帮助编辑
有关插件的问题,请在 讨论 论坛中发布主题。对于错误或功能请求,请在 Github 中打开问题。有关 Elastic 支持的插件列表,请参阅 Elastic 支持矩阵。
描述编辑
通过 udp 在网络上以事件的形式读取消息。唯一必需的配置项是 port
,它指定 logstash 将监听事件流的 udp 端口。
事件元数据和 Elastic Common Schema (ECS)编辑
此插件添加一个包含 UDP 数据包源 IP 地址的字段。默认情况下,IP 地址存储在 host 字段中。当 Elastic Common Schema (ECS) 启用(在 ecs_compatibility
中)时,源 IP 地址存储在 [host][ip] 字段中。
您可以使用 source_ip_fieldname
自定义字段名称。有关更多信息,请参阅 ecs_compatibility
。
Udp 输入配置选项编辑
此插件支持以下配置选项以及后面描述的 通用选项。
设置 | 输入类型 | 必需 |
---|---|---|
否 |
||
否 |
||
否 |
||
是 |
||
否 |
||
否 |
||
否 |
||
否 |
另请参阅 通用选项,了解所有输入插件支持的选项列表。
ecs_compatibility
编辑
- 值类型为 字符串
-
支持的值为
-
disabled
: 在根级别添加非结构化连接元数据 -
v1
: 在符合 ECS 的命名空间下添加结构化连接元数据
-
-
默认值取决于运行的 Logstash 版本
- 当 Logstash 提供
pipeline.ecs_compatibility
设置时,其值将用作默认值 - 否则,默认值为
disabled
。
- 当 Logstash 提供
控制此插件与 Elastic Common Schema (ECS) 的兼容性。
此设置的值会影响 TCP 连接元数据在事件上的放置位置。
表 1. ecs_compatibility
值的元数据位置
`disabled` | `v1` | 可用性 | 描述 |
---|---|---|---|
主机 |
[host][ip] |
始终 |
UDP 数据包的源 IP |
receive_buffer_bytes
编辑
- 值类型为 数字
- 此设置没有默认值。
套接字接收缓冲区大小(以字节为单位)。如果未设置选项,则使用操作系统默认值。如果 receive_buffer_bytes 大于允许值,则操作系统将使用最大允许值。如果您需要增加此最大允许值,请咨询您的操作系统文档。
source_ip_fieldname
编辑
- 值类型为 字符串
- 默认值可能是
"host"
或[host][ip]
,具体取决于ecs_compatibility
的值
将存储源 IP 地址的字段的名称。有关 ECS 兼容性设置如何影响这些默认值,请参阅 事件元数据和 Elastic Common Schema (ECS)。
示例
input { udp { source_ip_fieldname => "[appliance][monitoring][ip]" } }
通用选项编辑
以下配置选项由所有输入插件支持