New

The executive guide to generative AI

Read more

Lumberjack 输出插件

编辑

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

获取帮助

编辑

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

描述

编辑

此输出使用 lumberjack 协议发送事件。

Lumberjack 输出配置选项

编辑

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

设置 输入类型 必填

flush_size

数字

hosts

数组

idle_flush_time

数字

port

数字

ssl_certificate

有效的文件系统路径

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

 

flush_size

编辑
  • 值类型为 数字
  • 默认值为 1024

为了有效地调用 lumberjack 输出,我们在本地缓冲事件。如果事件数量超过声明的 flush_size 数量,我们将把它们发送到 logstash 服务器。

hosts

编辑
  • 这是一个必填设置。
  • 值类型为 数组
  • 此设置没有默认值。

lumberjack 可以发送到的地址列表。当插件需要连接到远程对等方时,它会随机选择其中一个主机。

注册插件时,它会打开与其中一个主机的连接。如果插件检测到连接错误,它会从列表中选择另一个主机并打开新连接。

idle_flush_time

编辑
  • 值类型为 数字
  • 默认值为 1

自上次刷新以来强制刷新之前的时间量。

此设置有助于确保缓慢的事件速率不会在 Logstash 中停滞。例如,如果你的 flush_size 是 100,并且你已收到 10 个事件,并且自上次刷新以来已经超过 idle_flush_time 秒,Logstash 将自动刷新这 10 个事件。

这有助于保持快速和慢速日志流都以近乎实时的方式移动。

port

编辑
  • 这是一个必填设置。
  • 值类型为 数字
  • 此设置没有默认值。

要连接的端口

ssl_certificate

编辑
  • 这是一个必填设置。
  • 值类型为 路径
  • 此设置没有默认值。

要使用的 ssl 证书

通用选项

编辑

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

设置 输入类型 必填

codec

codec

enable_metric

布尔值

id

字符串

codec

编辑

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

enable_metric

编辑

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

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

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

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

id 字段中的变量替换仅支持环境变量,不支持使用 secret store 中的值。