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

发现.digitalocean

discovery.digitalocean discoveries and exposes DigitalOcean Droplets as targets.

用法

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

参数

支持以下参数

名称类型说明默认值必需
port数字要附加到每个 Droplet 的 __address__ 标签的端口号。80no
refresh_interval持续时间刷新 Droplet 列表频率。"1m"no
bearer_tokensecret用于认证的 bearer 令牌。no
bearer_token_file字符串包含用于认证的 bearer 令牌的文件。no
proxy_url字符串HTTP 代理要发送请求通过。no
no_proxy字符串逗号分隔的 IP 地址、CIDR 表示法和域名列表,排除代理。no
proxy_from_environment布尔值使用环境变量中指示的代理 URL。falseno
proxy_connect_headermap(list(secret))指定在 CONNECT 请求期间发送到代理的标头。no
follow_redirects布尔值是否应遵循服务器返回的重定向。trueno
enable_http2布尔值是否支持请求的 HTTP2。trueno

更详细的说明请参阅DigitalOcean API 文档

必须指定 bearer_tokenbearer_token_file 参数之一以实现对 DigitalOcean 的认证。

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

proxy_from_environment 使用环境变量 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY(或它们的 lowercase 版本)。请求使用与其 scheme 匹配的环境变量中的代理,除非由 NO_PROXY 排除。如果配置了 proxy_from_environment,则不应配置 proxy_urlno_proxy

只有当配置了 proxy_urlproxy_from_environment 时,才应配置 proxy_connect_header

代码块

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

导出的字段

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

名称类型说明
targetslist(map(string))从 DigitalOcean API 中发现的目标集合。

每个目标包含以下标签

  • __meta_digitalocean_droplet_id:Droplet 的 ID。
  • __meta_digitalocean_droplet_name:Droplet 的名称。
  • __meta_digitalocean_image:用于创建 Droplet 的镜像的 slug(唯一的文本标识符)。
  • __meta_digitalocean_image_name:用于创建 Droplet 的镜像名称。
  • __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 remote_write 兼容服务器的 URL。
  • <USERNAME>:用于远程_write API 认证的用户名。
  • <PASSWORD>:用于远程_write API 认证的密码。

兼容组件

discovery.digitalocean 的导出可以被以下组件消费

注意

连接某些组件可能不合理,或者组件可能需要其他配置才能正确连接。请参阅链接的文档以获取更多详细信息。