文档 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 组件。

用法

合金 复制

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

参数

otelcol.processor.probabilistic_sampler 支持以下参数

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

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 是 OpenTelemetry Collector 中 telemetry.disableHighCardinalityMetrics 功能开关的 Grafana Alloy 等效项。它会删除可能导致高基数度量的属性。例如，它会删除有关 HTTP 和 gRPC 连接的度量中的包含 IP 地址和端口号的属性。

level 是 OpenTelemetry Collector 中 telemetry.metrics.level 功能开关的 Alloy 等效项。可能的值为 "none"、"basic"、"normal" 和 "detailed"。

导出的字段

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

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

• 日志
• 跟踪

组件运行状况

仅当给出无效配置时，otelcol.processor.probabilistic_sampler 才被报告为不健康。

调试信息

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

示例

基本用法

合金 复制

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

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

采样 15% 的日志

合金 复制

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

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

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

合金 复制

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

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

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

合金 复制

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