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

loki.source.kubernetes

loki.source.kubernetes 使用 Kubernetes API 从 Kubernetes 容器中尾随日志。

此组件相比 loki.source.file 具有以下优势：

• 它无需特权容器即可工作。
• 它无需 root 用户即可工作。
• 它无需访问 Kubernetes 节点的文件系统即可工作。
• 它不需要 DaemonSet 来收集日志，因此一个 Alloy 实例可以收集整个集群的日志。

您可以通过为多个 loki.source.kubernetes 组件指定不同的标签来使用它们。

用法

alloy 复制

loki.source.kubernetes "<LABEL>" {
  targets    = <TARGET_LIST>
  forward_to = <RECEIVER_LIST>
}

参数

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

您可以配合 loki.source.kubernetes 使用以下参数：

targets 中的每个目标必须包含以下标签：

• __meta_kubernetes_namespace 或 __pod_namespace__ 用于指定要尾随日志的 Pod 的命名空间。
• __meta_kubernetes_pod_container_name 或 __pod_container_name__ 用于指定要尾随日志的 Pod 中的容器。
• __meta_kubernetes_pod_name 或 __pod_name__ 用于指定要尾随日志的 Pod 的名称。
• __meta_kubernetes_pod_uid 或 __pod_uid__ 用于指定要尾随日志的 Pod 的 UID。

默认情况下，当使用 discovery.kubernetes 输出时，所有这些标签都存在。

对于 targets 中的每个唯一目标，都会启动一个日志尾随器。如果日志流在容器永久终止之前返回，日志尾随器会以指数退避方式重新连接到 Kubernetes。

块

您可以配合 loki.source.kubernetes 使用以下块：

The > symbol indicates deeper levels of nesting. For example, client > basic_auth refers to a basic_auth block defined inside a client block.

client

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

The client block configures the Kubernetes client used to tail logs from containers. If the client block isn’t provided, the default in-cluster configuration with the service account of the running Alloy Pod is used.

Whether redirects returned by the server should be followed.

• 是否应遵循服务器返回的重定向。
• http_headers
• http_headers
• map(list(secret))
• map(list(secret))

Custom HTTP headers to be sent along with each request. The map key is the header name.

要随每个请求发送的自定义 HTTP 头。映射键是头名称。

kubeconfig_file

kubeconfig_file

proxy_connect_header

proxy_connect_header

false

false

oauth2 block

oauth2 块

Custom HTTP headers to be sent along with each request. The map key is the header name.

要随每个请求发送的自定义 HTTP 头。映射键是头名称。

kubeconfig_file

no_proxy can contain IPs, CIDR notations, and domain names. IP and domain names can contain port numbers. proxy_url must be configured if no_proxy is configured.

认证类型，例如，“Bearer”。

• credential and credentials_file are mutually exclusive, and only one can be provided inside an authorization block.
• credential 和 credentials_file 相互排斥，且在 authorization 块内只能提供其中一个。
• basic_auth

basic_auth

password_file

• password_file
• File containing the basic auth password.
• 包含基本认证密码的文件。
• password

clustering

基本认证密码。

username

username

• Basic auth username.
• 基本认证用户名。
• password and password_file are mutually exclusive, and only one can be provided inside a basic_auth block.
• password 和 password_file 相互排斥，且在 basic_auth 块内只能提供其中一个。
• oauth2
• oauth2
• client_id
• client_id
• OAuth2 client ID.
• OAuth2 客户端 ID。
• client_secret_file
• client_secret_file

File containing the OAuth2 client secret.

包含 OAuth2 客户端 Secret 的文件。

client_secret

client_secret

OAuth2 client secret.

OAuth2 客户端 Secret。

• endpoint_params
• endpoint_params
• map(string)
• map(string)

Optional parameters to append to the token URL.

要添加到令牌 URL 的可选参数。

scopes

scopes

alloy 复制

discovery.kubernetes "pods" {
  role = "pod"
}

loki.source.kubernetes "pods" {
  targets    = discovery.kubernetes.pods.targets
  forward_to = [loki.write.local.receiver]
}

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

兼容组件

list(string)

• list(string)
• List of scopes to authenticate with.