菜单
正式发布 (GA) 开源

discovery.ovhcloud

`discovery.ovhcloud` 组件使用 OVHcloud API 发现 OVHcloud 专用服务器和 VPS 的抓取目标。Alloy 会定期检查 REST 端点,并为每个发现的服务器创建一个目标。默认使用公共 IPv4 地址。如果没有 IPv4 地址,则使用 IPv6 地址。这可以通过 `discovery.relabel` 进行重新标记来更改。对于 OVHcloud 公有云实例,您可以使用 `discovery.openstack`。

用法

alloy
discovery.ovhcloud "<LABEL>" {
    application_key    = "<APPLICATION_KEY>"
    application_secret = "<APPLICATION_SECRET>"
    consumer_key       = "<CONSUMER_KEY>"
    service            = "<SERVICE>"
}

参数

您可以将以下参数与 `discovery.ovhcloud` 组件一起使用

名称类型描述默认值必需
application_keystringAPI 应用密钥。
application_secretsecretAPI 应用密钥密文。
consumer_keysecretAPI 消费者密钥。
servicestring要检索的目标的服务类型。
endpointstringAPI 端点。“ovh-eu”
refresh_intervalduration重新读取资源列表的刷新间隔。“60s”

`service` 必须是 `vps` 或 `dedicated_server`。

`endpoint` 必须是受支持的 API 端点之一。

`discovery.ovhcloud` 组件不支持任何块。您可以使用参数配置此组件。

导出字段

以下字段已导出,可供其他组件引用

名称类型描述
targetslist(map(string))从 OVHcloud API 发现的目标集。

`targets` 上有多个元标签可用,并且可以由 `discovery.relabel` 组件使用。

VPS 元标签

  • `__meta_ovhcloud_vps_cluster`:服务器的集群。
  • `__meta_ovhcloud_vps_datacenter`:服务器的数据中心。
  • `__meta_ovhcloud_vps_disk`:服务器的磁盘。
  • `__meta_ovhcloud_vps_display_name`:服务器的显示名称。
  • `__meta_ovhcloud_vps_ipv4`:服务器的 IPv4 地址。
  • `__meta_ovhcloud_vps_ipv6`:服务器的 IPv6 地址。
  • `__meta_ovhcloud_vps_keymap`:服务器的 KVM 键盘布局。
  • `__meta_ovhcloud_vps_maximum_additional_ip`:服务器的最大附加 IP 地址数。
  • `__meta_ovhcloud_vps_memory_limit`:服务器的内存限制。
  • `__meta_ovhcloud_vps_memory`:服务器的内存。
  • `__meta_ovhcloud_vps_monitoring_ip_blocks`:服务器的监控 IP 地址块。
  • `__meta_ovhcloud_vps_name`:服务器的名称。
  • `__meta_ovhcloud_vps_netboot_mode`:服务器的网络启动模式。
  • `__meta_ovhcloud_vps_offer_type`:服务器的套餐类型。
  • `__meta_ovhcloud_vps_offer`:服务器的套餐。
  • `__meta_ovhcloud_vps_state`:服务器的状态。
  • `__meta_ovhcloud_vps_vcore`:服务器的虚拟核心数。
  • `__meta_ovhcloud_vps_version`:服务器的版本。
  • `__meta_ovhcloud_vps_zone`:服务器的区域。

专用服务器元标签

  • `__meta_ovhcloud_dedicated_server_commercial_range`:服务器的商业范围。
  • `__meta_ovhcloud_dedicated_server_datacenter`:服务器的数据中心。
  • `__meta_ovhcloud_dedicated_server_ipv4`:服务器的 IPv4 地址。
  • `__meta_ovhcloud_dedicated_server_ipv6`:服务器的 IPv6 地址。
  • `__meta_ovhcloud_dedicated_server_link_speed`:服务器的链路速度。
  • `__meta_ovhcloud_dedicated_server_name`:服务器的名称。
  • `__meta_ovhcloud_dedicated_server_no_intervention`:服务器是否禁用数据中心干预。
  • `__meta_ovhcloud_dedicated_server_os`:服务器的操作系统。
  • `__meta_ovhcloud_dedicated_server_rack`:服务器的机架。
  • `__meta_ovhcloud_dedicated_server_reverse`:服务器的反向 DNS 名称。
  • `__meta_ovhcloud_dedicated_server_server_id`:服务器的 ID。
  • `__meta_ovhcloud_dedicated_server_state`:服务器的状态。
  • `__meta_ovhcloud_dedicated_server_support_level`:服务器的支持级别。

组件健康状况

只有在配置无效时,`discovery.ovhcloud` 才会报告为不健康。在这种情况下,导出字段会保留其最后一次健康的值。

调试信息

`discovery.ovhcloud` 不会暴露任何特定于组件的调试信息。

调试指标

`discovery.ovhcloud` 不会暴露任何特定于组件的调试指标。

示例

alloy
discovery.ovhcloud "example" {
    application_key    = "<APPLICATION_KEY>"
    application_secret = "<APPLICATION_SECRET>"
    consumer_key       = "<CONSUMER_KEY>"
    service            = "<SERVICE>"
}

prometheus.scrape "demo" {
    targets    = discovery.ovhcloud.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>"
        }
    }
}

替换以下内容

  • ``:OVHcloud API 应用密钥。
  • ``:OVHcloud API 应用密钥密文。
  • ``:OVHcloud API 消费者密钥。
  • ``:要检索的目标的 OVHcloud 服务类型。
  • ``:用于将指标发送到的 Prometheus remote_write 兼容服务器的 URL。
  • ``:用于对 `remote_write` API 进行身份验证的用户名。
  • ``:用于对 `remote_write` API 进行身份验证的密码。

兼容组件

`discovery.ovhcloud` 具有可由以下组件使用的导出项

  • 使用目标的组件

注意

连接某些组件可能不合理,或组件可能需要进一步配置才能使连接正常工作。有关更多详细信息,请参阅链接的文档。