菜单
开源

Loki GELF 源

loki.source.gelf 从 UDP 监听器读取 Graylog 扩展长格式 (GELF) 日志 并将其转发到其他 loki.* 组件。

可以通过为多个 loki.source.gelf 组件提供不同的标签和端口来指定它们。

用法

alloy
loki.source.gelf "LABEL" {
  forward_to    = RECEIVER_LIST
}

参数

该组件启动一个新的 UDP 监听器,并将日志条目扇出到 forward_to 中传递的接收器列表。

loki.source.gelf 支持以下参数

名称类型描述默认值是否必填
listen_address字符串用于监听 Graylog 消息的 UDP 地址和端口。0.0.0.0:12201
use_incoming_timestamp布尔值当为 false 时,在处理日志时为其分配当前时间戳false
relabel_rulesRelabelRules应用于日志条目的重命名规则。“{}”

**注意**:GELF 日志可以未压缩或使用 GZIP 或 ZLIB 压缩发送。将添加一个 job 标签,其中包含组件 loki.source.gelf.LABEL 的完整名称。

relabel_rules 参数可以利用 loki.relabel 组件的 rules 导出功能,在将日志条目转发到 forward_to 中指定的接收器列表之前,对日志条目应用一个或多个重命名规则。

传入消息具有以下可用的内部标签

  • __gelf_message_level:GELF 级别(字符串)。
  • __gelf_message_host:发送 GELF 消息的主机。
  • __gelf_message_host:客户端发送的 GELF 级别消息版本。
  • __gelf_message_facility:GELF 设施。

转发日志条目之前,将删除所有以 __ 开头的标签。要保留这些标签,请使用 loki.relabel 组件对其进行重命名,并将它的 rules 导出传递到 relabel_rules 参数。

组件健康状况

仅当 loki.source.gelf 给定无效配置时,才会报告其不健康。

调试指标

  • gelf_target_entries_total(计数器):发送到 GELF 目标的成功条目总数。
  • gelf_target_parsing_errors_total(计数器):接收 GELF 消息时解析错误的总数。

示例

alloy
loki.relabel "gelf" {
  rule {
    source_labels = ["__gelf_message_host"]
    target_label  = "host"
  }
}

loki.source.gelf "listen"  {
  forward_to    = [loki.write.endpoint.receiver]
  relabel_rules = loki.relabel.gelf.rules
}

loki.write "endpoint" {
  endpoint {
    url ="loki:3100/api/v1/push"
  }
}

兼容组件

loki.source.gelf 可以接受来自以下组件的参数

注意

连接某些组件可能没有意义,或者组件可能需要进一步配置才能使连接正常工作。有关更多详细信息,请参阅链接的文档。