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 中的值。