Gelf 输出插件编辑

  • 插件版本:v3.1.7
  • 发布日期:2018-04-06
  • 变更日志

有关其他版本,请参阅 版本化插件文档

安装编辑

对于默认情况下未捆绑的插件,可以通过运行 bin/logstash-plugin install logstash-output-gelf 轻松安装。有关更多详细信息,请参阅 使用插件

获取帮助编辑

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

描述编辑

此输出以 GELF 格式生成消息。如果您想使用 Logstash 将事件输出到 Graylog2,这将非常有用。

有关更多信息,请访问 Graylog2 GELF 规范页面

Gelf 输出配置选项编辑

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

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

 

chunksize编辑

  • 值类型为 数字
  • 默认值为 1420

块大小。通常您不需要更改此设置。

custom_fields编辑

  • 值类型为 哈希
  • 默认值为 {}

GELF 自定义字段映射。GELF 支持任意属性作为自定义字段。这会公开这些属性。排除字段名称中的 _ 部分,例如 custom_fields => ['foo_field', 'some_value'] 设置 _foo_field = some_value

full_message编辑

  • 值类型为 字符串
  • 默认值为 "%{message}"

GELF 全部消息。此处允许使用动态值,例如 %{foo}

host编辑

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

Graylog2 服务器 IP 地址或主机名。

ignore_metadata编辑

  • 值类型为 数组
  • 默认值为 ["@timestamp", "@version", "severity", "host", "source_host", "source_path", "short_message"]

ship_metadata 设置为 true 时,忽略这些字段。通常,这列出了用于 GELF 字段动态值的字段。

level编辑

  • 值类型为 数组
  • 默认值为 ["%{severity}", "INFO"]

GELF 消息级别。此处允许使用动态值,例如 %{level};如果您想从事件中解析日志级别并将其用作 GELF 级别/严重性,这将非常有用。

此处的值可以是整数 [0..7](含)或任何“debug”、“info”、“warn”、“error”、“fatal”(不区分大小写)。这些值的单字符版本也有效,“d”、“i”、“w”、“e”、“f”、“u”。以下来自 Logstash 的 syslog_pri 过滤器的附加 severity_labels 也被接受:“emergency”、“alert”、“critical”、“warning”、“notice”和“informational”。

port编辑

  • 值类型为 数字
  • 默认值为 12201

Graylog2 服务器端口号。

protocol编辑

默认情况下,此插件通过 UDP 传输协议输出,但可以配置为使用 TCP。

此处的值可以是“TCP”或“UDP”。

sender编辑

  • 值类型为 字符串
  • 默认值为 "%{host}"

允许覆盖 GELF sender 字段。如果您想使用除事件源主机以外的其他内容作为事件的“发送者”,这将非常有用。这种情况的一个常见用例是使用应用程序名称而不是主机名。

ship_metadata编辑

Logstash 应该在事件对象中发送元数据吗?这将导致 Logstash 在 GELF 消息中发送事件中的任何字段(例如由 grok 创建的字段)。这些将作为带下划线的“附加字段”发送。

ship_tags编辑

在事件中发送标签。这将导致 Logstash 将事件的标签作为字段 \_tags 发送。

short_message编辑

  • 值类型为 字符串
  • 默认值为 "short_message"

GELF 短消息字段名称。如果字段不存在或为空,则使用事件消息。

通用选项编辑

以下配置选项由所有输出插件支持

设置 输入类型 必需

codec

codec

enable_metric

布尔值

id

字符串

codec编辑

  • 值类型为 codec
  • 默认值为 "plain"

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

enable_metric编辑

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

id编辑

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

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

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

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