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

发现.linode

discovery.linode 允许您从 Linode 的 Linode APIv4 中检索抓取目标。此服务发现默认使用公网 IPv4 地址，但可以通过重命名来更改。

用法

alloy 复制

discovery.linode "LABEL" {
	bearer_token = LINODE_API_TOKEN
}

参数

以下是支持的参数

最多可以提供以下之一

• bearer_token 参数.
• bearer_token_file 参数.
• basic_auth 块.
• authorization 块.
• oauth2 块.

no_proxy 可以包含 IP 地址、CIDR 表示法和域名。IP 和域名可以包含端口号。《proxy_url》必须在配置 no_proxy 时配置。

proxy_from_environment 使用环境变量 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY（或其小写版本）。请求使用与它们的方案匹配的环境变量中的代理，除非被 NO_PROXY 排除。如果配置了 proxy_from_environment，则不得配置 proxy_url 和 no_proxy。

proxy_connect_header 仅当配置了 proxy_url 或 proxy_from_environment 时才应配置。

块

以下是定义 discovery.linode 时支持的块

符号“>”表示更深的嵌套级别。例如，oauth2 > tls_config指的是在oauth2块内定义的tls_config块。

基本身份验证块

password和password_file是相互排斥的，并且在basic_auth块中只能提供一个。

授权块

credential和credentials_file是相互排斥的，并且在authorization块中只能提供一个。

oauth2块

client_secret和client_secret_file是相互排斥的，并且在oauth2块中只能提供一个。

oauth2块还可以包含单独的tls_config子块。

no_proxy 可以包含 IP 地址、CIDR 表示法和域名。IP 和域名可以包含端口号。《proxy_url》必须在配置 no_proxy 时配置。

proxy_from_environment 使用环境变量 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY（或其小写版本）。请求使用与它们的方案匹配的环境变量中的代理，除非被 NO_PROXY 排除。如果配置了 proxy_from_environment，则不得配置 proxy_url 和 no_proxy。

proxy_connect_header 仅当配置了 proxy_url 或 proxy_from_environment 时才应配置。

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）

导出字段

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

以下元标签在目标上可用，并可以被discovery.relabel组件使用

• __meta_linode_instance_id：Linode实例的ID
• __meta_linode_instance_label：Linode实例的标签
• __meta_linode_image：Linode实例镜像的slug
• __meta_linode_private_ipv4：Linode实例的私有IPv4
• __meta_linode_public_ipv4：Linode实例的公共IPv4
• __meta_linode_public_ipv6：Linode实例的公共IPv6
• __meta_linode_region：Linode实例的区域
• __meta_linode_type：Linode实例的类型
• __meta_linode_status：Linode实例的状态
• __meta_linode_tags：使用标签分隔符连接的Linode实例标签列表
• __meta_linode_group：Linode实例所属的显示组
• __meta_linode_hypervisor：为Linode实例提供虚拟化的软件
• __meta_linode_backups：Linode实例的备份服务状态
• __meta_linode_specs_disk_bytes：Linode实例可访问的存储空间量
• __meta_linode_specs_memory_bytes：Linode实例可访问的RAM量
• __meta_linode_specs_vcpus：此Linode可访问的VCPUS数量
• __meta_linode_specs_transfer_bytes：Linode实例每月分配的网络传输量
• __meta_linode_extra_ips：用标签分隔符连接的所有分配给Linode实例的额外IPv4地址列表

组件健康状态

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

调试信息

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

调试指标

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

示例

alloy 复制

discovery.linode "example" {
    bearer_token = env("LINODE_TOKEN")
    port = 8876
}
prometheus.scrape "demo" {
	targets    = discovery.linode.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
		}
	}
}

替换以下

• PROMETHEUS_REMOTE_WRITE_URL：将指标发送到的Prometheus remote_write兼容服务器的URL。
• USERNAME：用于远程写入API认证的用户名。
• PASSWORD：用于远程写入API认证的密码。

使用私有IP地址

复制

discovery.linode "example" {
    bearer_token = env("LINODE_TOKEN")
    port = 8876
}
discovery.relabel "private_ips" {
	targets = discovery.linode.example.targets
	rule {
    	source_labels = ["__meta_linode_private_ipv4"]
    	replacement     = "[$1]:8876"
    	target_label  = "__address__"
  	}
}
prometheus.scrape "demo" {
	targets    = discovery.relabel.private_ips.targets
	forward_to = [prometheus.remote_write.demo.receiver]
}
prometheus.remote_write "demo" {
	endpoint {
		url = PROMETHEUS_REMOTE_WRITE_URL
		basic_auth {
			username = USERNAME
			password = PASSWORD
		}
	}
}

兼容组件

discovery.linode有导出，这些导出可以由以下组件消费

• 消耗目标的组件