UDP 输出插件

编辑
  • 插件版本: v3.2.0
  • 发布日期: 2021-07-14
  • 更新日志

对于其他版本,请参阅版本化的插件文档

获取帮助

编辑

有关插件的问题,请在Discuss论坛中打开一个主题。对于错误或功能请求,请在Github中打开一个 issue。 有关 Elastic 支持的插件列表,请查阅Elastic 支持矩阵

描述

编辑

通过 UDP 发送事件

请记住,UDP 不提供交付或重复保护保证。即使此插件成功写入 UDP 套接字,也不能保证接收者将准确接收到事件的一个副本。

当此插件无法写入 UDP 套接字时,默认情况下,事件将被丢弃并记录错误消息。 retry_count 选项与 retry_backoff_ms 选项结合使用,可以在丢弃事件之前重试失败的写入操作多次。

UDP 输出配置选项

编辑

此插件支持以下配置选项以及稍后描述的通用选项

设置 输入类型 必需

host

字符串

port

字符串

retry_count

数字

retry_backoff_ms

数字

另请参阅通用选项,了解所有输出插件支持的选项列表。

 

host

编辑
  • 这是一个必需的设置。
  • 值类型是字符串
  • 此设置没有默认值。

要将消息发送到的地址

port

编辑
  • 这是一个必需的设置。
  • 值类型是字符串
  • 此设置没有默认值。

发送消息的端口。这可以使用 %{[target][port]} 语法动态指定。

retry_count

编辑
  • 值类型是数字
  • 默认值是 0

重试失败的 UPD 套接字写入的次数

retry_backoff_ms

编辑
  • 值类型是数字
  • 默认值是 10

尝试重试失败的 UPD 套接字写入操作之前等待的时间(以毫秒为单位)

通用选项

编辑

所有输出插件都支持这些配置选项

设置 输入类型 必需

codec

codec

enable_metric

布尔值

id

字符串

codec

编辑

用于输出数据的编解码器。输出编解码器是一种方便的方法,可以在数据离开输出之前对其进行编码,而无需在 Logstash 管道中使用单独的过滤器。

enable_metric

编辑

禁用或启用此特定插件实例的指标日志记录。默认情况下,我们会记录所有可以记录的指标,但您可以禁用特定插件的指标收集。

  • 值类型是 字符串
  • 此设置没有默认值。

向插件配置添加唯一的 ID。 如果未指定 ID,Logstash 将生成一个。强烈建议在配置中设置此 ID。当您有两个或多个相同类型的插件时,这尤其有用。例如,如果您有 2 个 udp 输出。在这种情况下添加命名 ID 将有助于在使用监控 API 时监控 Logstash。

output {
  udp {
    id => "my_plugin_id"
  }
}

id 字段中的变量替换仅支持环境变量,不支持使用来自秘密存储的值。