文档 Grafana Alloy 参考 组件 discovery discovery.openstack

发现OpenStack

discovery.openstack 发现 OpenStack Nova 实例并将它们作为目标暴露。

用法

alloy 复制

discovery.openstack "LABEL" {
  role   = "hypervisor"
  region = "us-east-1"
}

参数

以下参数受支持

role 必须是 hypervisor 或 instance 之一。

使用 Identity V2 API 时需要 username。在 Identity V3 中，需要 userid 或 username 和 domain_id 或 domain_name 的组合。

project_id 和 project_name 字段对于 Identity V2 API 是可选的。某些提供者允许您指定 project_name 而不是 project_id。某些提供者则要求两者都提供。

如果使用应用程序凭证进行身份验证，则需要 application_credential_id 或 application_credential_name 字段。某些提供者允许您创建应用程序凭证进行身份验证，而不是密码。

如果使用应用程序凭证进行身份验证，则需要 application_credential_secret 字段。

all_tenants 仅与 instance 角色相关，通常需要管理员权限。

availability 必须是 public、admin 或 internal 之一。

块

以下块在 discovery.openstack 定义内部受支持。

tls_config 块

以下参数对是互斥的，不能同时设置

• ca_pem 和 ca_file
• cert_pem 和 cert_file
• key_pem 和 key_file

配置客户端身份验证时，必须提供客户端证书（使用 cert_pem 或 cert_file）和客户端密钥（使用 key_pem 或 key_file）。

如果没有提供 min_version，则可接受的最小 TLS 版本继承自 Go 的默认最小版本，TLS 1.2。如果提供了 min_version，则必须将其设置为以下字符串之一

• "TLS10"（TLS 1.0）
• "TLS11"（TLS 1.1）
• "TLS12"（TLS 1.2）
• "TLS13"（TLS 1.3）

导出字段

以下字段是导出的，可以被其他组件引用

hypervisor

hypervisor 角色在每个 Nova 虚拟节点上发现一个目标。目标地址默认为虚拟节点的 host_ip 属性。

• __meta_openstack_hypervisor_host_ip：虚拟节点 IP 地址。
• __meta_openstack_hypervisor_hostname：虚拟节点名称。
• __meta_openstack_hypervisor_id：虚拟节点 ID。
• __meta_openstack_hypervisor_state：虚拟节点状态。
• __meta_openstack_hypervisor_status：虚拟节点状态。
• __meta_openstack_hypervisor_type：虚拟节点类型。

instance

instance 角色在每个 Nova 实例的网络接口上发现一个目标。目标地址默认为网络接口的私有 IP 地址。

• __meta_openstack_address_pool：私有 IP 地址池。
• __meta_openstack_instance_flavor：OpenStack实例的类型。
• __meta_openstack_instance_id：OpenStack实例的ID。
• __meta_openstack_instance_image：OpenStack实例使用的镜像ID。
• __meta_openstack_instance_name：OpenStack实例的名称。
• __meta_openstack_instance_status：OpenStack实例的状态。
• __meta_openstack_private_ip：OpenStack实例的私有IP。
• __meta_openstack_project_id：拥有此实例的项目（租户）。
• __meta_openstack_public_ip：OpenStack实例的公网IP。
• __meta_openstack_tag_<tagkey>：实例的每个标签值。
• __meta_openstack_user_id：拥有租户的用户账户。

组件健康状态

discovery.openstack仅在配置无效时报告为不健康。在这些情况下，导出的字段保留其最后的健康值。

调试信息

discovery.openstack不公开任何特定组件的调试信息。

调试指标

discovery.openstack不公开任何特定组件的调试指标。

示例

alloy 复制

discovery.openstack "example" {
  role   = OPENSTACK_ROLE
  region = OPENSTACK_REGION
}

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

替换以下内容

• OPENSTACK_ROLE：您的OpenStack角色。
• OPENSTACK_REGION：您的OpenStack区域。
• PROMETHEUS_REMOTE_WRITE_URL：要发送指标的目标Prometheus remote_write兼容服务器的URL。
• USERNAME：用于远程_write API认证的用户名。
• PASSWORD：用于远程_write API认证的密码。

兼容组件

discovery.openstack导出可以被以下组件消费的数据

• 消费目标的组件