菜单
开源

发现GCE

discovery.gce 允许从 Google Compute Engine (GCE) 实例检索抓取目标。默认情况下使用私有 IP 地址,但可以通过重命名更改为公网 IP 地址。

通过 Google Cloud SDK 默认客户端查找以下位置以发现凭证,优先找到第一个位置

  1. GOOGLE_APPLICATION_CREDENTIALS 环境变量指定的 JSON 文件。
  2. 已知路径 $HOME/.config/gcloud/application_default_credentials.json 中的 JSON 文件。
  3. 从 GCE 元数据服务器获取。

如果 Alloy 在 GCE 中运行,运行实例的关联服务帐户应至少具有只读权限到计算资源。如果不在 GCE 中运行,请确保创建适当的服务帐户并将凭证文件放置在预期位置之一。

用法

alloy
discovery.gce "LABEL" {
  project = PROJECT_NAME
  zone    = ZONE_NAME
}

参数

以下参数受支持

名称类型描述默认必需
project字符串谷歌云项目。
zone字符串抓取目标的区域。
filter字符串可以使用过滤器可选地通过其他标准过滤实例列表。
refresh_interval持续时间刷新间隔重新读取实例列表。"60s"
port整数从其抓取指标的目标端口。使用公网 IP 地址时,必须在此重新命名规则中指定此值。80
tag_separator字符串标签分隔符用于在连接时分隔标签。","

有关 filter 参数语法的更多信息,请参阅 Google 的 Method: instances.listfilter 文档。

导出字段

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

名称类型描述
targetslist(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不暴露任何特定于组件的调试指标。

示例

alloy
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有导出可以被以下组件消费

注意

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