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

discovery.openstack

discovery.openstack 发现 OpenStack Nova 实例，并将它们公开为 targets。

用法

alloy 复制

discovery.openstack "<LABEL>" {
  role   = "<OPENSTACK_ROLE>"
  region = "<OPENSTACK_REGION>"
}

参数

您可以将以下参数与 discovery.openstack 一起使用

role 必须是 hypervisor 或 instance 之一。

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

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

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

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

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

如果使用 Identity V2 API，则 username 是必需的。在 Identity V3 中，需要 userid 或 username 和 domain_id 或 domain_name 的组合。

块

您可以将以下块与 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 hypervisor 节点发现一个 target。target 地址默认为 hypervisor 的 host_ip 属性。

• __meta_openstack_hypervisor_host_ip: hypervisor 节点的 IP 地址。
• __meta_openstack_hypervisor_hostname: hypervisor 节点的名称。
• __meta_openstack_hypervisor_id: hypervisor 节点的 ID。
• __meta_openstack_hypervisor_state: hypervisor 节点的状态。
• __meta_openstack_hypervisor_status: hypervisor 节点的状态。
• __meta_openstack_hypervisor_type: hypervisor 节点的类型。

instance 角色

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

• __meta_openstack_address_pool: 私有 IP 的池。
• __meta_openstack_instance_flavor: OpenStack 实例的 flavor。
• __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>: 用于向 remote_write API 进行身份验证的用户名。
• <PASSWORD>: 用于向 remote_write API 进行身份验证的密码。

兼容组件

discovery.openstack 具有以下组件可以使用的导出

• 使用 Targets 的组件