文档 Grafana Alloy 参考 组件 otelcol otelcol.processor.probabilistic_sampler

otelcol.processor.probabilistic_sampler

otelcol.processor.probabilistic_sampler 接受来自其他 otelcol 组件的日志和跟踪数据，并根据配置选项应用概率抽样。

概率采样器处理器支持对跨度日志记录的多种采样模式。
采样基于每个请求进行，考虑单个项目无状态。对于整个跟踪采样，请参阅 otelcol.processor.tail_sampling。

对于跟踪跨度，此采样器支持基于配置的采样百分比对 TraceID 应用概率采样。此外，采样器识别 sampling.priority 注解，可以强制采样器应用 0% 或 100% 采样。

对于日志记录，此采样器可以配置为使用嵌入的 TraceID 并应用与跨度相同的逻辑。
当 TraceID 未定义时，采样器可以配置为对选定的日志记录属性应用哈希。
此采样器还支持采样优先级。

您可以通过提供不同的标签来指定多个 otelcol.processor.probabilistic_sampler 组件。

用法

alloy Copy

otelcol.processor.probabilistic_sampler "LABEL" {
  output {
    logs    = [...]
    traces  = [...]
  }
}

参数

otelcol.processor.probabilistic_sampler 支持以下参数

您可以将 mode 设置为 "proportional"、"equalizing" 或 "hash_seed"。默认为 "proportional"，除非已配置 hash_seed 或 attribute_source 设置为 record。有关模式的更多信息，请参阅上游 Collector 的 模式选择文档 部分。

hash_seed 确定用于计算哈希算法的整数。此参数可用于痕迹和日志。当用于日志时，它会计算日志记录的哈希值。要使哈希工作，给定层级的所有收集器（例如，位于同一负载均衡器后面）必须具有相同的 hash_seed。还可以在不同的收集器层使用不同的 hash_seed 来支持额外的采样要求。

sampling_percentage 确定采样痕迹或日志的百分比。如果将此参数设置为大于或等于 100 的值，则将采样所有痕迹或日志。

attribute_source（仅限日志）确定在 from_attribute 中查找属性的位置。允许的值是 traceID 或 record。

from_attribute（仅限日志）确定用于采样目的的日志记录属性名称，例如唯一的日志记录 ID。如果不存在痕迹 ID 或 attribute_source 设置为 record，则仅使用属性值。

sampling_priority（仅限日志）确定用于设置与 sampling_percentage 设置不同的采样优先级的日志记录属性名称。0 表示从不采样日志记录，而大于或等于 100 表示始终采样日志记录。

probabilistic_sampler 支持两种类型的痕迹采样

1. sampling.priority 如 OpenTracing 所定义的 语义约定。
2. 跟踪ID哈希。

语义约定 sampling.priority 优先于跟踪ID哈希。跟踪ID哈希根据由跟踪ID确定的哈希值进行采样。

probabilistic_sampler 支持根据跟踪ID或特定的日志记录属性进行采样日志。

sampling_precision 必须是介于1到14（包含）之间的值。

块

以下块在 otelcol.processor.probabilistic_sampler 定义内部受支持

debug_metrics 块

debug_metrics 块配置该组件生成的指标以监视其状态。

以下参数受支持

disable_high_cardinality_metrics 是 Grafana Alloy 与 OpenTelemetry Collector 中的 telemetry.disableHighCardinalityMetrics 功能门控的等价物。它移除了可能导致高基数指标的特性。例如，从关于 HTTP 和 gRPC 连接的指标中移除了包含 IP 地址和端口号的特性。

level 是与 OpenTelemetry Collector 中的 telemetry.metrics.level 功能门控的 Alloy 等价物。可能的值是 "none"、"basic"、"normal" 和 "detailed"。

导出字段

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

input 接受 otelcol.Consumer OTLP 格式的数据，用于以下类型的任何遥测信号

• logs
• traces

组件健康

otelcol.processor.probabilistic_sampler 只有在提供无效配置时才会报告为不健康。

调试信息

otelcol.processor.probabilistic_sampler 不公开任何特定于组件的调试信息。

示例

基本用法

alloy Copy

otelcol.processor.probabilistic_sampler "default" {
  hash_seed           = 123
  sampling_percentage = 15.3

  output {
    logs = [otelcol.exporter.otlp.default.input]
  }
}

采样15%的日志

alloy Copy

otelcol.processor.probabilistic_sampler "default" {
  sampling_percentage = 15

  output {
    logs = [otelcol.exporter.otlp.default.input]
  }
}

根据其“logID”属性采样日志

alloy Copy

otelcol.processor.probabilistic_sampler "default" {
  sampling_percentage = 15
  attribute_source    = "record"
  from_attribute      = "logID"

  output {
    logs = [otelcol.exporter.otlp.default.input]
  }
}

根据“priority”属性采样日志

alloy Copy

otelcol.processor.probabilistic_sampler "default" {
  sampling_percentage = 15
  sampling_priority   = "priority"

  output {
    logs = [otelcol.exporter.otlp.default.input]
  }
}

兼容组件

otelcol.processor.probabilistic_sampler 可以接受来自以下组件的参数

• 导出 OpenTelemetry otelcol.Consumer 的组件

otelcol.processor.probabilistic_sampler 的导出可以被以下组件消费

• 消费 OpenTelemetry otelcol.Consumer 的组件