文档 Grafana Alloy 参考 配置块 remotecfg

remotecfg 块

remotecfg 是一个可选配置块，它使 Alloy 能够从远程端点获取并加载配置。remotecfg 指定时没有标签，每个配置文件中只能提供一次。

用于管理和获取 remotecfg 块所用配置的API 定义在 Apache 2.0 许可证下可用。

示例

alloy 复制

remotecfg {
    url = "SERVICE_URL"
    basic_auth {
        username      = "USERNAME"
        password_file = "PASSWORD_FILE"
    }

    id             = constants.hostname
    attributes     = {"cluster" = "dev", "namespace" = "otlp-dev"}
    poll_frequency = "5m"
}

参数

支持以下参数

如果未设置 url，则该服务块为空操作。

如果未设置，Alloy 使用的自报告 id 是一个随机生成的匿名唯一 ID (UUID)，存储在 Alloy 存储路径的 alloy_seed.json 文件中，以便在重启后保持不变。您可以使用 name 字段为特定的 Alloy 实例设置另一个用户友好的标识符。

id 和 attributes 字段用于发送到远程端点的定期请求中，以便 API 可以决定提供哪些配置。

attribute map 的键可以包含任何自定义值，但保留前缀 collector. 除外。保留的标签前缀用于自动系统属性。您不能覆盖此此缀。

• collector.os：Alloy 运行的操作系统。
• collector.version：Alloy 的版本。

poll_frequency 必须至少设置为 "10s"。

最多可提供以下参数之一：

• 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_url 或 proxy_from_environment 时，才应配置 proxy_connect_header。

块

在 remotecfg 定义中支持以下块

符号 > 表示更深层次的嵌套。例如，oauth2 > tls_config 指的是在 oauth2 块内定义的 tls_config 块。

basic_auth 块

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

authorization 块

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_url 或 proxy_from_environment 时，才应配置 proxy_connect_header。

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)