文档 Grafana Alloy 参考 组件 discovery discovery.hetzner

发现Hetzner

discovery.hetzner 允许从 Hetzner Cloud API 和 Robot API 获取抓取目标。此服务发现默认使用公网IPv4地址，但可以通过重命名修改。

用法

alloy 复制

discovery.hetzner "LABEL" {
  role = HETZNER_ROLE
}

参数

以下参数被支持

role必须是robot或hcloud之一。

以下之一最多只能提供一项

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

块

以下块在discovery.hetzner定义内部受支持。

>符号表示嵌套的更深层级。例如，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_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)

导出字段

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

每个目标包含以下标签

• __meta_hetzner_server_id：服务器的ID
• __meta_hetzner_server_name：服务器的名称
• __meta_hetzner_server_status：服务器的状态
• __meta_hetzner_public_ipv4：服务器的公网IPv4地址
• __meta_hetzner_public_ipv6_network：服务器的公网IPv6网络（/64）
• __meta_hetzner_datacenter：服务器的数据中心

hcloud

以下标签仅适用于role设置为hcloud的目标

• __meta_hetzner_hcloud_image_name：服务器的镜像名称
• __meta_hetzner_hcloud_image_description：服务器镜像的描述
• __meta_hetzner_hcloud_image_os_flavor：服务器镜像的操作系统类型
• __meta_hetzner_hcloud_image_os_version：服务器镜像的操作系统版本
• __meta_hetzner_hcloud_datacenter_location：服务器的位置
• __meta_hetzner_hcloud_datacenter_location_network_zone：服务器的网络区域
• __meta_hetzner_hcloud_server_type：服务器的类型
• __meta_hetzner_hcloud_cpu_cores：服务器的CPU核心数
• __meta_hetzner_hcloud_cpu_type：服务器的CPU类型（共享或专用）
• __meta_hetzner_hcloud_memory_size_gb：服务器的内存大小（以GB为单位）
• __meta_hetzner_hcloud_disk_size_gb：服务器的磁盘大小（以GB为单位）
• __meta_hetzner_hcloud_private_ipv4_<networkname>：服务器在给定网络中的私有IPv4地址
• __meta_hetzner_hcloud_label_<labelname>：服务器的每个标签
• __meta_hetzner_hcloud_labelpresent_<labelname>：每个标签为true

robot

以下标签仅适用于role设置为robot的目标

• __meta_hetzner_robot_product：服务器的产品
• __meta_hetzner_robot_cancelled：服务器的取消状态

组件健康

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

调试信息

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

调试指标

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

示例

此示例从Hetzner发现目标

alloy 复制

discovery.hetzner "example" {
  role = HETZNER_ROLE
}

prometheus.scrape "demo" {
  targets    = discovery.hetzner.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
    }
  }
}

替换以下内容

• HETZNER_ROLE：应发现实体的角色。
• PROMETHEUS_REMOTE_WRITE_URL：发送指标到Prometheus远程写入兼容服务器的URL。
• USERNAME：用于远程写入API认证的用户名。
• PASSWORD：用于远程写入API认证的密码。

兼容组件

discovery.hetzner有导出可以被以下组件使用

• 消费目标的组件