发现DigitalOcean
discovery.digitalocean
查找 DigitalOcean 弹性云服务器并将其作为目标暴露。
用法
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_header | map(list(secret)) | 指定在连接请求期间发送到代理的标头。 | 无 | |
follow_redirects | 布尔值 | 是否应遵循服务器返回的重定向。 | true | 无 |
enable_http2 | 布尔值 | 是否支持HTTP2请求。 | true | 无 |
数字海洋API使用携带令牌进行身份验证,有关更多信息,请参阅数字海洋API文档。
必须指定bearer_token
和bearer_token_file
参数中的一个,以对数字海洋进行身份验证。
no_proxy
可以包含IP地址、CIDR表示法和域名。IP地址和域名可以包含端口号。proxy_url
必须配置,如果配置了no_proxy
。
proxy_from_environment
使用环境变量HTTP_PROXY、HTTPS_PROXY和NO_PROXY(或其小写版本)。请求使用与其方案匹配的环境变量中的代理,除非被NO_PROXY排除。proxy_url
和no_proxy
不得配置,如果已配置proxy_from_environment
。
如果已配置proxy_url
或proxy_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
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》导出的可以由以下组件消费
- 消耗目标的组件
注意
连接某些组件可能不合理,或者组件可能需要进一步配置才能正确连接。有关更多详细信息,请参阅相关文档。