文档Grafana Alloy参考组件发现discovery.kuma

发现：Kuma

discovery.kuma 从 Kuma 控制平面发现抓取目标。

使用方法

alloy 复制

discovery.kuma "LABEL" {
    server = SERVER
}

参数

以下参数被支持

以下之一最多可提供

• 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 时配置。

在 discovery.kuma 的定义中支持以下块

《>》符号表示更深的嵌套级别。例如，oauth2 > tls_config 指的是一个定义在 oauth2 块内部的 tls_config 块。

基本认证块

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

授权块

credentials 和 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)

导出字段

以下字段是导出的，可以作为其他组件的引用

以下元标签在目标上可用，并可用于 discovery.relabel 组件

• __meta_kuma_mesh：代理 Mesh 的名称
• __meta_kuma_dataplane：代理的名称
• __meta_kuma_service：与代理关联的服务名称
• __meta_kuma_label_<tagname>：代理的每个标签

组件健康

discovery.kuma只在给定无效配置时报告为不健康。在这些情况下，导出字段保留其最后健康的值。

调试信息

discovery.kuma不公开任何特定组件的调试信息。

调试度量

discovery.kuma不公开任何特定组件的调试度量。

示例

alloy 复制

discovery.kuma "example" {
    server     = "http://kuma-control-plane.kuma-system.svc:5676"
}
prometheus.scrape "demo" {
	targets    = discovery.kuma.example.targets
	forward_to = [prometheus.remote_write.demo.receiver]
}
prometheus.remote_write "demo" {
	endpoint {
		url = PROMETHEUS_REMOTE_WRITE_URL
		basic_auth {
			username = USERNAME
			password = PASSWORD
		}
	}
}

替换以下内容

• PROMETHEUS_REMOTE_WRITE_URL：将度量发送到 Prometheus remote_write 兼容服务器的 URL。
• USERNAME：用于远程_write API 认证的用户名。
• PASSWORD：用于远程_write API 认证的密码。

兼容组件

discovery.kuma有导出字段，可以被以下组件消费

• 消耗目标的组件