发现GCE
discovery.gce
允许从 Google Compute Engine (GCE) 实例检索抓取目标。默认情况下使用私有 IP 地址,但可以通过重命名更改为公网 IP 地址。
通过 Google Cloud SDK 默认客户端查找以下位置以发现凭证,优先找到第一个位置
GOOGLE_APPLICATION_CREDENTIALS
环境变量指定的 JSON 文件。- 已知路径
$HOME/.config/gcloud/application_default_credentials.json
中的 JSON 文件。 - 从 GCE 元数据服务器获取。
如果 Alloy 在 GCE 中运行,运行实例的关联服务帐户应至少具有只读权限到计算资源。如果不在 GCE 中运行,请确保创建适当的服务帐户并将凭证文件放置在预期位置之一。
用法
discovery.gce "LABEL" {
project = PROJECT_NAME
zone = ZONE_NAME
}
参数
以下参数受支持
名称 | 类型 | 描述 | 默认 | 必需 |
---|---|---|---|---|
project | 字符串 | 谷歌云项目。 | 是 | |
zone | 字符串 | 抓取目标的区域。 | 是 | |
filter | 字符串 | 可以使用过滤器可选地通过其他标准过滤实例列表。 | 否 | |
refresh_interval | 持续时间 | 刷新间隔重新读取实例列表。 | "60s" | 否 |
port | 整数 | 从其抓取指标的目标端口。使用公网 IP 地址时,必须在此重新命名规则中指定此值。 | 80 | 否 |
tag_separator | 字符串 | 标签分隔符用于在连接时分隔标签。 | "," | 否 |
有关 filter
参数语法的更多信息,请参阅 Google 的 Method: instances.list 的 filter
文档。
导出字段
以下字段被导出并可以由其他组件引用
名称 | 类型 | 描述 |
---|---|---|
targets | list(map(string)) | 发现的 GCE 目标集合。 |
每个目标包括以下标签
__meta_gce_instance_id
:实例的数字 ID__meta_gce_instance_name
:实例名称__meta_gce_label_LABEL_NAME
:实例的每个GCE标签__meta_gce_machine_type
:实例机器类型的完整或部分URL__meta_gce_metadata_NAME
:实例的每个元数据项目__meta_gce_network
:实例的网络URL__meta_gce_private_ip
:实例的私有IP地址__meta_gce_interface_ipv4_NAME
:每个命名接口的IPv4地址__meta_gce_project
:实例正在运行的GCP项目__meta_gce_public_ip
:如果存在,则显示实例的公共IP地址__meta_gce_subnetwork
:实例的子网络URL__meta_gce_tags
:以逗号分隔的实例标签列表__meta_gce_zone
:实例正在运行的GCE区域URL
组件健康
discovery.gce
仅在提供无效配置时报告为不健康。在这些情况下,导出的字段保留其最后一个健康值。
调试信息
discovery.gce
不暴露任何特定于组件的调试信息。
调试指标
discovery.gce
不暴露任何特定于组件的调试指标。
示例
discovery.gce "gce" {
project = "alloy"
zone = "us-east1-a"
}
prometheus.scrape "demo" {
targets = discovery.gce.gce.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.gce
有导出可以被以下组件消费
- 消费目标的组件
注意
连接某些组件可能不合理或组件可能需要进行进一步配置以便正确连接。有关更多详细信息,请参阅链接文档。