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

loki.source.kubernetes_events

loki.source.kubernetes_events 从 Kubernetes API 追踪事件，并将其转换为日志行，以便转发到其他 loki 组件。

您可以通过为每个 loki.source.kubernetes_events 组件分配不同的标签来指定多个此类组件。

用法

alloy 复制

loki.source.kubernetes_events "<LABEL>" {
  forward_to = <RECEIVER_LIST>
}

参数

该组件为每个给定的 targets 启动一个新的读取器，并将日志条目分发到 forward_to 中传递的接收器列表。

您可以将以下参数与 loki.source.kubernetes_events 一起使用

默认情况下，loki.source.kubernetes_events 监听所有命名空间中的事件。可以在 namespaces 参数中提供要监听的明确命名空间列表。

默认情况下，生成的日志行采用 logfmt 格式。使用 log_format 参数将其更改为 json。这些格式也是 LogQL 解析器的名称，可用于处理日志。

loki.source.kubernetes_events 生成的日志行具有以下标签

• namespace: 参与事件的 Kubernetes 对象的命名空间。
• job: 由 job_name 参数指定的值。
• instance: 与组件 ID 匹配的值。

如果 job_name 参数为空字符串，组件将无法加载。要移除 job 标签，请将 loki.source.kubernetes_events 的输出转发到 一个 loki.relabel 组件。

为了与静态模式下的 eventhandler 集成兼容，job_name 可以设置为 "integrations/kubernetes/eventhandler"。

块

您可以将以下块与 loki.source.kubernetes_events 一起使用

> 符号表示更深的嵌套层级。例如，client > basic_auth 指的是在 client 块内部定义的 basic_auth 块。

client

client 块配置用于从容器追踪日志的 Kubernetes 客户端。如果未提供 client 块，则使用运行 Alloy Pod 的服务帐户的默认集群内配置。

支持以下参数

最多可提供以下之一

• authorization 块
• basic_auth 块
• bearer_token_file 参数
• bearer_token 参数
• oauth2 块

no_proxy 可以包含 IP、CIDR 表示法和域名。IP 和域名可以包含端口号。如果配置了 no_proxy，则必须配置 proxy_url。

proxy_from_environment 使用环境变量 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY（或其小写版本）。请求使用与其方案匹配的环境变量中的代理，除非被 NO_PROXY 排除。如果配置了 proxy_from_environment，则不得配置 proxy_url 和 no_proxy。

proxy_connect_header 仅应在配置了 proxy_url 或 proxy_from_environment 时配置。

authorization

credential 和 credentials_file 是互斥的，在 authorization 块中只能提供其中之一。

basic_auth

password 和 password_file 是互斥的，在 basic_auth 块中只能提供其中之一。

oauth2

client_secret 和 client_secret_file 是互斥的，在 oauth2 块中只能提供其中之一。

oauth2 块还可以包含一个单独的 tls_config 子块。

no_proxy 可以包含 IP、CIDR 表示法和域名。IP 和域名可以包含端口号。如果配置了 no_proxy，则必须配置 proxy_url。

proxy_from_environment 使用环境变量 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY（或其小写版本）。请求使用与其方案匹配的环境变量中的代理，除非被 NO_PROXY 排除。如果配置了 proxy_from_environment，则不得配置 proxy_url 和 no_proxy。

proxy_connect_header 仅应在配置了 proxy_url 或 proxy_from_environment 时配置。

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.kubernetes_events 不导出任何字段。

组件健康状况

loki.source.kubernetes_events 仅在给定无效配置时报告为不健康。

调试信息

loki.source.kubernetes_events 公开每个被监听命名空间中事件的最新读取时间戳。

调试指标

loki.source.kubernetes_events 不公开任何组件特定的调试指标。

组件行为

该组件使用其数据路径（一个以域名的完全限定名称命名的目录）来存储其 positions file。positions file 用于存储读取偏移量，以便如果组件或 Alloy 重启，loki.source.kubernetes_events 可以从同一位置继续追踪。

数据路径位于由 --storage.path 命令行参数配置的目录内。

示例

此示例收集 kube-system 命名空间中的事件，并将其转发到 loki.write 组件，以便将其写入 Loki。

alloy 复制

loki.source.kubernetes_events "example" {
  // Only watch for events in the kube-system namespace.
  namespaces = ["kube-system"]

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

loki.write "local" {
  endpoint {
    url = sys.env("LOKI_URL")
  }
}

兼容组件

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

• 导出 Loki LogsReceiver 的组件