发现.digitalocean
discovery.digitalocean
discoveries and exposes DigitalOcean Droplets as targets.
用法
discovery.digitalocean "LABEL" {
// Use one of:
// bearer_token = BEARER_TOKEN
// bearer_token_file = PATH_TO_BEARER_TOKEN_FILE
}
参数
支持以下参数
名称 | 类型 | 说明 | 默认值 | 必需 |
---|---|---|---|---|
port | 数字 | 要附加到每个 Droplet 的 __address__ 标签的端口号。 | 80 | no |
refresh_interval | 持续时间 | 刷新 Droplet 列表频率。 | "1m" | no |
bearer_token | secret | 用于认证的 bearer 令牌。 | no | |
bearer_token_file | 字符串 | 包含用于认证的 bearer 令牌的文件。 | no | |
proxy_url | 字符串 | HTTP 代理要发送请求通过。 | no | |
no_proxy | 字符串 | 逗号分隔的 IP 地址、CIDR 表示法和域名列表,排除代理。 | no | |
proxy_from_environment | 布尔值 | 使用环境变量中指示的代理 URL。 | false | no |
proxy_connect_header | map(list(secret)) | 指定在 CONNECT 请求期间发送到代理的标头。 | no | |
follow_redirects | 布尔值 | 是否应遵循服务器返回的重定向。 | true | no |
enable_http2 | 布尔值 | 是否支持请求的 HTTP2。 | true | no |
更详细的说明请参阅DigitalOcean API 文档。
必须指定 bearer_token
或 bearer_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_url
和 no_proxy
。
只有当配置了 proxy_url
或 proxy_from_environment
时,才应配置 proxy_connect_header
。
代码块
discovery.digitalocean
组件不支持任何块,完全通过参数进行配置。
导出的字段
以下字段会被导出,并可由其他组件引用
名称 | 类型 | 说明 |
---|---|---|
targets | list(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
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
的导出可以被以下组件消费
- 消费 Targets 的组件
注意
连接某些组件可能不合理,或者组件可能需要其他配置才能正确连接。请参阅链接的文档以获取更多详细信息。