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

loki.source.podlogs

loki.source.podlogs 在 Kubernetes 中发现 PodLogs 资源。这些资源提供了在您的集群中要发现的 Kubernetes Pods 的规则。

loki.source.podlogs 使用 Kubernetes API 来跟踪已发现 Kubernetes Pods 的日志。

loki.source.podlogs 与 loki.source.kubernetes 类似，但它使用自定义资源而不是从另一个组件接收目标。

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

用法

alloy 复制

loki.source.podlogs "LABEL" {
  forward_to = RECEIVER_LIST
}

参数

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

loki.source.podlogs 支持以下参数

loki.source.podlogs 在 Kubernetes 中搜索 PodLogs 资源。每个 PodLogs 资源描述了一组要跟踪日志的 Pod。

PodLogs 自定义资源

PodLogs 资源描述了一组要收集日志的 Pod。

PodLogsSpec

PodLogsSpec 描述了一组要收集日志的 Pod。

如果 selector 留为默认值，则发现所有 Pod。如果 namespaceSelector 留为默认值，则使用所有命名空间进行 Pod 发现。

可以使用 relabelings 字段修改发现的 Pod 的标签。以下元标签可用于重命名：

• __meta_kubernetes_namespace：Pod 的命名空间。
• __meta_kubernetes_pod_name：Pod 的名称。
• __meta_kubernetes_pod_ip：Pod 的 Pod IP。
• __meta_kubernetes_pod_label_<labelname>：Pod 的每个标签。
• __meta_kubernetes_pod_labelpresent_<labelname>：Pod 的每个标签为 true。
• __meta_kubernetes_pod_annotation_<annotationname>：Pod 的每个注释。
• __meta_kubernetes_pod_annotationpresent_<annotationname>：Pod 的每个注释为 true。
• __meta_kubernetes_pod_container_init：如果容器是 InitContainer，则为 true。
• __meta_kubernetes_pod_container_name：容器的名称。
• __meta_kubernetes_pod_container_image：容器使用的镜像。
• __meta_kubernetes_pod_ready：Pod 的就绪状态设置为 true 或 false。
• __meta_kubernetes_pod_phase：在生命周期中设置为 Pending、Running、Succeeded、Failed 或 Unknown。
• __meta_kubernetes_pod_node_name：Pod 调度到的节点的名称。
• __meta_kubernetes_pod_host_ip：Pod 对象的当前主机 IP。
• __meta_kubernetes_pod_uid：Pod 的 UID。
• __meta_kubernetes_pod_controller_kind：Pod 控制器的对象类型。
• __meta_kubernetes_pod_controller_name：Pod 控制器的名称。

除了元标签之外，以下标签被暴露出来，以告诉 loki.source.podlogs 要跟踪哪个容器

• __pod_namespace__：Pod 的命名空间。
• __pod_name__：Pod 的名称。
• __pod_container_name__：Pod 内的容器名称。
• __pod_uid__：Pod 的 UID。

块

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

> 符号表示嵌套的更深层级。例如，客户端 > 基本认证 指的是在 客户端 块内定义的 基本认证 块。

客户端块

客户端 块配置用于从容器中跟踪日志的Kubernetes客户端。如果没有提供 客户端 块，则使用默认的集群配置，即运行中的Alloy pod的服务账户。

支持以下参数

以下参数中最多只能提供以下参数之一

• bearer_token 参数.
• bearer_token_file 参数.
• basic_auth 块.
• authorization 块.
• 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 时进行配置。

基本认证块

password 和 password_file 是互斥的，并且在 basic_auth 块内只能提供其中一个。

授权块

credential 和 credentials_file 是互斥的，并且在 authorization 块内只能提供其中一个。

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)

selector 块

selector 块描述了用于 PodLogs 或命名空间发现的Kubernetes标签选择器。

支持以下参数

当 match_labels 参数为空时，将匹配所有资源。

match_expression 块

match_expression 块描述了用于 PodLogs 或命名空间发现的Kubernetes标签匹配表达式。

支持以下参数

operator 参数必须是以下字符串之一

• "In"
• "NotIn"
• "Exists"
• "DoesNotExist"

既可以使用 selector，也可以使用 namespace_selector，它们都可以使用多个 match_expression 内部块，这些块被视为AND子句。

clustering 块

当Alloy使用集群，并且 enabled 设置为true时，则此 loki.source.podlogs 组件实例选择加入集群以参与集群，以便在所有集群节点之间分配日志收集的负载。

如果Alloy不是以集群模式运行，则该块不执行任何操作，并且 loki.source.podlogs 根据发现的每个 PodLogs 资源收集日志。

集群仅查看以下标签以确定分片键

• __pod_namespace__
• __pod_name__
• __pod_container_name__
• __pod_uid__
• __meta_kubernetes_namespace
• __meta_kubernetes_pod_name
• __meta_kubernetes_pod_container_name
• __meta_kubernetes_pod_uid
• container
• pod
• job
• namespace

导出字段

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

组件健康

loki.source.podlogs 仅在提供无效配置时报告为不健康。

调试信息

loki.source.podlogs 暴露了每个目标级别的部分调试信息

• 与目标关联的标签。
• 在服务发现期间找到的完整标签集。
• 读取并转发到管道中下一个组件的最新日志行的时间。
• 如果有，则来自尾部跟踪的最新错误。

调试度量

loki.source.podlogs 不暴露任何特定于组件的调试度量。

示例

此示例发现所有 PodLogs 资源并将收集到的日志转发到 loki.write 组件，以便将它们写入Loki。

alloy 复制

loki.source.podlogs "default" {
  forward_to = [loki.write.local.receiver]
}

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

兼容组件

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

• 导出 Loki LogsReceiver 的组件