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

发现marathon

discovery.marathon 允许您从 Marathon的 服务 API 中检索抓取目标。

用法

alloy 复制

discovery.marathon "LABEL" {
  servers = [MARATHON_SERVER1, MARATHON_SERVER2...]
}

参数

支持以下参数

最多只能提供以下之一

• auth_token 参数.
• auth_token_file 参数.
• bearer_token_file 参数.
• bearer_token 参数.
• basic_auth 块.
• authorization 块.
• oauth2 块.

no_proxy 可以包含IP地址、CIDR表示法和域名。IP和域名可以包含端口号。《proxy_url》必须在配置了《no_proxy》时配置。

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.marathon》的定义内部使用

《>》符号表示更深层次的嵌套。例如，《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和域名可以包含端口号。《proxy_url》必须在配置了《no_proxy》时配置。

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)

导出字段

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

每个目标包括以下标签

• __meta_marathon_app：应用名称（斜杠被破折号替换）。
• __meta_marathon_image：使用的Docker镜像名称（如果可用）。
• __meta_marathon_task：Mesos任务的ID。
• __meta_marathon_app_label_<labelname>：附加到应用的任何Marathon标签。
• __meta_marathon_port_definition_label_<labelname>：端口定义标签。
• __meta_marathon_port_mapping_label_<labelname>：端口映射标签。
• __meta_marathon_port_index：端口索引号（例如，PORT1为1）。

组件健康

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

调试信息

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

调试指标

discovery.marathon不会公开任何特定组件的调试指标。

示例

此示例从Marathon服务器发现目标

alloy 复制

discovery.marathon "example" {
  servers = ["localhost:8500"]
}

prometheus.scrape "demo" {
  targets    = discovery.marathon.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远程写入兼容服务器的URL。
• USERNAME：用于远程写入API认证的用户名。
• PASSWORD：用于远程写入API认证的密码。

兼容组件

discovery.marathon导出的内容可以被以下组件消费

• 消费目标的组件