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

otelcol.processor.probabilistic_sampler

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

概率采样器处理器支持针对 Span 和日志记录的几种采样模式。
采样是按请求进行的，无状态地考虑单个项目。对于整个追踪的采样，请参阅 otelcol.processor.tail_sampling。

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

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

您可以通过赋予它们不同的标签来指定多个 otelcol.processor.probabilistic_sampler 组件。

用法

alloy 复制

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 确定用于计算哈希算法的整数。此参数可用于追踪和日志。当用于日志时，它计算日志记录的哈希。为了使哈希工作，给定层级的所有 Collector（例如，在同一负载均衡器后面）必须具有相同的 hash_seed。也可以在不同的 Collector 层级利用不同的 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. 由 OpenTracing 定义的 sampling.priority 语义约定。
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 地址和端口号属性会被移除。

输出字段

以下字段会被输出，并可供其他组件引用

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

• 日志
• 追踪

组件健康状态

otelcol.processor.probabilistic_sampler 仅在配置无效时报告为不健康。

调试信息

otelcol.processor.probabilistic_sampler 不暴露任何组件特定的调试信息。

示例

基本用法

alloy 复制

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

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

采样 15% 的日志

alloy 复制

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

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

根据日志的“logID”属性进行采样

alloy 复制

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

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

根据“priority”属性对日志进行采样

alloy 复制

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 的组件