UDP 输入插件
编辑UDP 输入插件
编辑- 插件版本:v3.5.0
- 发布日期:2021-08-04
- 更新日志
其他版本,请参见 版本化插件文档。
获取帮助
编辑如有任何关于插件的问题,请在 Discuss 论坛中发帖。如发现错误或有功能请求,请在 Github 中提交问题。如需查看 Elastic 支持的插件列表,请参阅 Elastic 支持矩阵。
描述
编辑通过 UDP 读取网络上的消息作为事件。唯一必需的配置项是 port
,它指定 Logstash 将监听事件流的 UDP 端口。
事件元数据和 Elastic 通用架构 (ECS)
编辑此插件添加一个字段,其中包含 UDP 数据包的源 IP 地址。默认情况下,IP 地址存储在 host 字段中。启用 Elastic 通用架构 (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 通用架构 (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 通用架构 (ECS)。
示例
input { udp { source_ip_fieldname => "[appliance][monitoring][ip]" } }