菜单
文档breadcrumb arrow Grafana Alloybreadcrumb arrow 参考breadcrumb arrow 组件breadcrumb arrow discoverybreadcrumb arrow discovery.digitalocean
开源

发现DigitalOcean

discovery.digitalocean 查找 DigitalOcean 弹性云服务器并将其作为目标暴露。

用法

alloy
discovery.digitalocean "LABEL" {
    // Use one of:
    // bearer_token      = BEARER_TOKEN
    // bearer_token_file = PATH_TO_BEARER_TOKEN_FILE
}

参数

以下参数受支持

名称类型描述默认值必需
port数字将附加到每个弹珠的 __address__ 标签的端口。80
refresh_interval持续时间刷新弹珠列表的频率。"1m"
bearer_token秘密用于身份验证的Bearer令牌。
bearer_token_file字符串包含用于身份验证的Bearer令牌的文件。
proxy_url字符串通过其发送请求的HTTP代理。
no_proxy字符串逗号分隔的IP地址、CIDR表示法和域名列表,不包括在内代理。
proxy_from_environment布尔值使用环境变量中指示的代理URL。false
proxy_connect_headermap(list(secret))指定在连接请求期间发送到代理的标头。
follow_redirects布尔值是否应遵循服务器返回的重定向。true
enable_http2布尔值是否支持HTTP2请求。true

数字海洋API使用携带令牌进行身份验证,有关更多信息,请参阅数字海洋API文档

必须指定bearer_tokenbearer_token_file参数中的一个,以对数字海洋进行身份验证。

no_proxy可以包含IP地址、CIDR表示法和域名。IP地址和域名可以包含端口号。proxy_url必须配置,如果配置了no_proxy

proxy_from_environment使用环境变量HTTP_PROXY、HTTPS_PROXY和NO_PROXY(或其小写版本)。请求使用与其方案匹配的环境变量中的代理,除非被NO_PROXY排除。proxy_urlno_proxy不得配置,如果已配置proxy_from_environment

如果已配置proxy_urlproxy_from_environment,则应仅配置proxy_connect_header

《discovery.digitalocean》组件不支持任何块,完全通过参数进行配置。

导出字段

以下字段被导出,并且可以被其他组件引用

名称类型描述
目标list(map(string))从数字海洋API发现的集合。

每个目标都包含以下标签

  • __meta_digitalocean_droplet_id:Droplet的ID。
  • __meta_digitalocean_droplet_name:Droplet的名称。
  • __meta_digitalocean_image:用于创建Droplet的image slug(唯一的文本标识符)。
  • __meta_digitalocean_image_name:用于创建Droplet的image名称。
  • __meta_digitalocean_private_ipv4:Droplet的私有IPv4地址。
  • __meta_digitalocean_public_ipv4:Droplet的公共IPv4地址。
  • __meta_digitalocean_public_ipv6:Droplet的公共IPv6地址。
  • __meta_digitalocean_region:Droplet运行的地区。
  • __meta_digitalocean_size:Droplet的大小。
  • __meta_digitalocean_status:Droplet的当前状态。
  • __meta_digitalocean_features:为Droplet配置的可选属性,例如IPV6网络、私有网络或备份。
  • __meta_digitalocean_tags:分配给Droplet的标签。
  • __meta_digitalocean_vpc:Droplet所在的VPC的ID。

每个发现的Droplet映射到一个目标。

组件健康

只有当给定无效配置时,《discovery.digitalocean》才报告为不健康。在这些情况下,导出字段保留其最后健康值。

调试信息

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

调试指标

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

示例

这会导致具有类似__address__标签的目标:192.0.2.1:8080

alloy
discovery.digitalocean "example" {
  port             = 8080
  refresh_interval = "5m"
  bearer_token     = "my-secret-bearer-token"
}

prometheus.scrape "demo" {
  targets    = discovery.digitalocean.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.digitalocean》导出的可以由以下组件消费

注意

连接某些组件可能不合理,或者组件可能需要进一步配置才能正确连接。有关更多详细信息,请参阅相关文档。