文档 Grafana Alloy 参考 组件 loki loki.source.syslog

loki源.syslog

loki.source.syslog 监听通过 TCP 或 UDP 连接传递的系统日志消息并将它们转发到其他 loki.* 组件。这些消息必须符合 RFC5424 格式。

该组件为每个给定的 config 块启动一个新的系统日志监听器并将传入的条目广播到 forward_to 中的接收者列表。

可以通过不同的标签指定多个 loki.source.syslog 组件。

用法

alloy 复制

loki.source.syslog "LABEL" {
  listener {
    address = "LISTEN_ADDRESS"
  }
  ...

  forward_to = RECEIVER_LIST
}

参数

loki.source.syslog 支持以下参数

“relabel_rules”字段可以使用一个 loki.relabel 组件的“rules”导出值来应用一个或多个重标记规则，在将其转发到 forward_to 中的接收者列表之前。

块

以下块支持在 loki.source.syslog 定义中

“>”符号表示更深的嵌套级别。例如，“config > tls_config”表示在“config”块中定义的“tls_config”块。

listener block

“listener”块定义监听地址和协议，监听器期望将系统日志消息发送到，以及接收消息时的行为。

可以使用以下参数配置“listener”。仅“address”字段是必需的，任何省略的字段都使用它们的默认值。

默认情况下，组件将日志条目的时间戳分配为处理时的时间。

将该labels映射应用于组件读取的每个消息。

将解析的RFC5424消息的所有头部字段作为内部标签引入，前缀为__syslog_。

如果设置了，则syslog头部的结构化数据也将转换为内部标签，格式为__syslog_message_sd_<ID>_<KEY>。例如，结构化数据条目[example@99999 test="yes"]变为标签__syslog_message_sd_example_99999_test，其值为"yes"。

tls_config块

以下参数对相互排斥，不能同时设置

• ca_pem和ca_file
• cert_pem和cert_file
• key_pem和key_file

在配置客户端认证时，必须同时提供客户端证书（使用cert_pem或cert_file）和客户端密钥（使用key_pem或key_file）。

如果没有提供min_version，则最低可接受的TLS版本继承自Go的默认最低版本，TLS 1.2。如果提供了min_version，则必须将其设置为以下字符串之一

• "TLS10"（TLS 1.0）
• "TLS11"（TLS 1.1）
• "TLS12"（TLS 1.2）
• "TLS13"（TLS 1.3）

导出的字段

loki.source.syslog不导出任何字段。

组件健康

当给定无效配置时，loki.source.syslog才被报告为不健康。

调试信息

loki.source.syslog根据syslog监听器公开一些调试信息

• 监听器是否当前正在运行。
• 监听地址。
• 监听器应用于传入日志条目的标签。

调试指标

• loki_source_syslog_entries_total（计数器）：成功发送到syslog组件的条目总数。
• loki_source_syslog_parsing_errors_total（计数器）：接收syslog消息时的解析错误总数。
• loki_source_syslog_empty_messages_total（计数器）：从syslog组件接收到的空消息总数。

示例

此示例在指定的端口上监听有效RFC5424格式的Syslog消息，并将它们转发到loki.write组件。

alloy 复制

loki.source.syslog "local" {
  listener {
    address  = "127.0.0.1:51893"
    labels   = { component = "loki.source.syslog", protocol = "tcp" }
  }

  listener {
    address  = "127.0.0.1:51898"
    protocol = "udp"
    labels   = { component = "loki.source.syslog", protocol = "udp"}
  }

  forward_to = [loki.write.local.receiver]
}

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

兼容组件

loki.source.syslog可以接受以下组件的参数

• 导出Loki LogsReceiver的组件