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

发现.consulagent

discovery.consulagent 允许您从Consul的Agent API中检索抓取目标。只监控同一主机上运行的本地Agent注册的服务。这适用于非常庞大的Consul集群，在这些集群中使用目录API将太慢或资源消耗过大。

用法

alloy 复制

discovery.consulagent "LABEL" {
  server = CONSUL_SERVER
}

参数

以下参数被支持

块

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

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_consulagent_address：目标地址。
• __meta_consulagent_dc：目标的数据中心名称。
• __meta_consulagent_health：服务健康状况。
• __meta_consulagent_metadata_<key>：目标节点的每个元数据键值。
• __meta_consulagent_node：为目标定义的节点名称。
• __meta_consulagent_service：目标所属服务的名称。
• __meta_consulagent_service_address：目标的服务地址。
• __meta_consulagent_service_id：目标的服务 ID。
• __meta_consulagent_service_metadata_<key>：目标的每个服务元数据键值。
• __meta_consulagent_service_port：目标的服务端口。
• __meta_consulagent_tagged_address_<key>：目标节点的每个标记地址键值。
• __meta_consulagent_tags：目标标签的列表，由标签分隔符连接。

组件健康

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

调试信息

discovery.consulagent 不暴露任何特定于组件的调试信息。

调试度量

• discovery_consulagent_rpc_failures_total (Counter)：Consul Agent RPC 调用失败的次数。
• discovery_consulagent_rpc_duration_seconds (SummaryVec)：Consul Agent RPC 调用持续时间的秒数。

示例

此示例从 Consul Agent 发现指定服务列表中的目标

alloy 复制

discovery.consulagent "example" {
  server = "localhost:8500"
  services = [
    "service1",
    "service2",
  ]
}

prometheus.scrape "demo" {
  targets    = discovery.consul.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.consulagent 的导出内容可以被以下组件消费

• 消费 目标和 的组件