文档 Grafana Alloy 参考 组件 pyroscope pyroscope.relabel

pyroscope.relabel

公开预览：这是一个公开预览组件。公开预览组件可能会发生破坏性变更，并可能被覆盖相同用例的等效功能替代。必须将 stability.level 标志设置为 public-preview 或更低才能使用此组件。

pyroscope.relabel 组件通过应用一个或多个 Relabeling 规则来重写传递给其接收器的每个性能剖析的标签集，并将结果转发给接收器列表。

如果没有定义规则或某些性能剖析不适用任何规则，则这些性能剖析将原封不动地转发给组件参数中传递的每个接收器。如果在应用 Relabeling 规则后没有标签残留，则该性能剖析将被丢弃。

pyroscope.relabel 最常见的用途是过滤性能剖析或标准化传递给一个或多个下游接收器的标签集。rule 块按照它们在配置文件中出现的顺序应用于每个性能剖析的标签集。

用法

alloy 复制

pyroscope.relabel "<LABEL>" {
    forward_to = <RECEIVER_LIST>

    rule {
        ...
    }

    ...
}

参数

您可以对 pyroscope.relabel 使用以下参数

块

您可以对 pyroscope.relabel 使用以下块

rule

rule 块包含可以应用于输入指标的 Relabeling 规则的定义。如果定义了多个 rule 块，则转换按从上到下的顺序应用。

可以使用以下参数配置 rule。所有参数都是可选的。省略的字段采用其默认值。

您可以使用以下操作

• drop - 丢弃 regex 匹配使用 source_labels 和 separator 提取的字符串的指标。
• dropequal - 丢弃连接的 source_labels 与 target_label 匹配的目标。
• hashmod - 对连接的标签进行哈希处理，计算其模 modulus，并将结果写入 target_label。
• keep - 保留 regex 匹配使用 source_labels 和 separator 提取的字符串的指标。
• keepequal - 丢弃连接的 source_labels 与 target_label 不匹配的目标。
• labeldrop - 将 regex 与所有标签名称匹配。任何匹配的标签都将从指标的标签集中删除。
• labelkeep - 将 regex 与所有标签名称匹配。任何不匹配的标签都将从指标的标签集中删除。
• labelmap - 将 regex 与所有标签名称匹配。任何匹配的标签将根据 replacement 字段的内容进行重命名。
• lowercase - 将 target_label 设置为连接的 source_labels 的小写形式。
• replace - 将 regex 与连接的标签匹配。如果匹配，则使用 replacement 字段的内容替换 target_label 的内容。
• uppercase - 将 target_label 设置为连接的 source_labels 的大写形式。

导出的字段

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

组件健康状况

如果配置无效，则 pyroscope.relabel 会被报告为不健康。

调试指标

• pyroscope_relabel_cache_hits (counter): 缓存命中总数。
• pyroscope_relabel_cache_misses (counter): 缓存未命中总数。
• pyroscope_relabel_cache_size (gauge): Relabel 缓存的总大小。
• pyroscope_relabel_profiles_dropped (counter): 因 Relabeling 规则丢弃的性能剖析总数。
• pyroscope_relabel_profiles_processed (counter): 已处理的性能剖析总数。
• pyroscope_relabel_profiles_written (counter): 已转发的性能剖析总数。

示例

alloy 复制

pyroscope.receive_http "default" {
    forward_to = [pyroscope.relabel.filter_profiles.receiver]

    http {
        listen_address = "0.0.0.0"
        listen_port = 9999
    }
}

pyroscope.relabel "filter_profiles" {
    forward_to = [pyroscope.write.staging.receiver]

    // This creates a consistent hash value (0 or 1) for each unique combination of labels
    // Using multiple source labels provides better sampling distribution across your profiles
    rule {
        source_labels = ["env"]
        target_label = "__tmp_hash"
        action = "hashmod"
        modulus = 2
    }

    // This effectively samples ~50% of profile series
    // The same combination of source label values will always hash to the same number,
    // ensuring consistent sampling
    rule {
        source_labels = ["__tmp_hash"]
        action       = "drop"
        regex        = "^1$"
    }
}

pyroscope.write "staging" {
  endpoint {
    url = "http://pyroscope-staging:4040"
  }
}

兼容组件

pyroscope.relabel 可以接受来自以下组件的参数

• 导出 Pyroscope ProfilesReceiver 的组件

pyroscope.relabel 具有可以被以下组件使用的导出

• 使用 Pyroscope ProfilesReceiver 的组件