› › ›

UDP 输入

使用 udp 输入通过 UDP 读取事件。

示例配置

filebeat.inputs:
- type: udp
  max_message_size: 10KiB
  host: "localhost:8080"

配置选项

编辑

udp 输入支持以下配置选项，以及稍后描述的常见选项。

`max_message_size`

编辑

通过 UDP 接收的消息的最大大小。默认为 10KiB。

`host`

编辑

要监听事件流的主机和 UDP 端口。

`network`

编辑

网络类型。可接受的值为：“udp”（默认）、“udp4”、“udp6”。

`read_buffer`

编辑

UDP 套接字上的读取缓冲区大小。如果未指定，将使用操作系统中的默认值。

`timeout`

编辑

套接字操作的读取和写入超时。默认为 5m。

指标

编辑

此输入在 HTTP 监控端点下公开指标。这些指标在 /inputs 路径下公开。它们可用于观察输入的活动。

指标	描述
`device`	UDP 流的主机/端口。
`udp_read_buffer_length_gauge`	UDP 套接字缓冲区长度的大小（以字节为单位）（仪表盘）。
`received_events_total`	已接收的数据包（事件）总数。
`received_bytes_total`	接收的总字节数。
`receive_queue_length`	系统接收队列的聚合大小（IPv4 和 IPv6）（仅限 Linux）（仪表盘）。
`system_packet_drops`	系统数据包丢弃的聚合数量（IPv4 和 IPv6）（仅限 Linux）（仪表盘）。
`arrival_period`	连续数据包之间的时间（以纳秒为单位）的直方图。
`processing_time`	处理数据包所需时间的直方图（以纳秒为单位）。

常见选项

编辑

所有输入都支持以下配置选项。

`enabled`

编辑

使用 enabled 选项启用和禁用输入。默认情况下，enabled 设置为 true。

`tags`

编辑

Filebeat 包含在每个发布事件的 tags 字段中的一组标签。标签使您能够轻松地在 Kibana 中选择特定事件，或在 Logstash 中应用条件过滤。这些标签将附加到在常规配置中指定的标签列表中。

示例

filebeat.inputs:
- type: udp
  . . .
  tags: ["json"]

`fields`

编辑

您可以指定的可选字段，以向输出添加其他信息。例如，您可以添加可用于过滤日志数据的字段。字段可以是标量值、数组、字典或这些值的任何嵌套组合。默认情况下，您在此处指定的字段将在输出文档中的 fields 子字典下分组。要将自定义字段存储为顶级字段，请将 fields_under_root 选项设置为 true。如果在常规配置中声明了重复字段，则其值将被此处声明的值覆盖。

filebeat.inputs:
- type: udp
  . . .
  fields:
    app_id: query_engine_12

`fields_under_root`

编辑

如果将此选项设置为 true，则自定义 fields 将存储为输出文档中的顶级字段，而不是在 fields 子字典下分组。如果自定义字段名称与 Filebeat 添加的其他字段名称冲突，则自定义字段将覆盖其他字段。

`processors`

编辑

要应用于输入数据的处理器列表。

请参阅 处理器，了解有关在配置中指定处理器的详细信息。

`pipeline`

编辑

为此输入生成的事件设置的摄取管道 ID。

管道 ID 也可以在 Elasticsearch 输出中配置，但此选项通常会导致更简单的配置文件。如果在输入和输出中都配置了管道，则使用输入中的选项。

`keep_null`

编辑

如果将此选项设置为 true，则输出文档中将发布具有 null 值的字段。默认情况下，keep_null 设置为 false。

`index`

编辑

如果存在，此格式化字符串将覆盖此输入事件的索引（对于 elasticsearch 输出），或设置事件元数据的 raw_index 字段（对于其他输出）。此字符串只能引用代理名称和版本以及事件时间戳；要访问动态字段，请使用 output.elasticsearch.index 或处理器。

示例值："%{[agent.name]}-myindex-%{+yyyy.MM.dd}" 可能会扩展为 "filebeat-myindex-2019.11.01"。

`publisher_pipeline.disable_host`

编辑

默认情况下，所有事件都包含 host.name。此选项可以设置为 true 以禁用将此字段添加到所有事件中。默认值为 false。

« TCP 输入 Unix 输入 »