otelcol.processor.memory_limiter

otelcol.processor.memory_limiter 用于通过定期检查内存使用情况来防止遥测管道中出现内存不足的情况。如果使用量超过定义的限制，则会丢弃数据并触发垃圾回收以减少内存使用量。

memory_limiter 组件使用软限制和硬限制，其中硬限制始终等于或大于软限制。当内存使用量超过软限制时，处理器组件会丢弃数据并向管道中的前置组件返回错误。当使用量超过硬限制时，处理器会强制执行垃圾回收，以尝试释放内存。当使用量低于软限制时，不会丢弃数据，也不会执行强制垃圾回收。

注意：otelcol.processor.memory_limiter 是对上游 OpenTelemetry Collector memorylimiter 处理器的封装。错误报告或功能请求将被重定向到上游存储库（如有必要）。

可以通过为多个 otelcol.processor.memory_limiter 组件指定不同的标签。

用法

otelcol.processor.memory_limiter "LABEL" {
  check_interval = "1s"

  limit = "50MiB" // alternatively, set `limit_percentage` and `spike_limit_percentage`

  output {
    metrics = [...]
    logs    = [...]
    traces  = [...]
  }
}

参数

otelcol.processor.memory_limiter 支持以下参数

名称	类型	描述	默认值	必需
`check_interval`	`duration`	检查内存使用情况的频率。		是
`limit`	`string`	进程堆分配的目标最大内存量。	`"0MiB"`	否
`spike_limit`	`string`	内存使用量测量之间预期的最大峰值。	`limit` 的 20%	否
`limit_percentage`	`int`	进程堆分配的目标可用总内存的最大量。	`0`	否
`spike_limit_percentage`	`int`	内存使用量测量之间预期的最大峰值。	`0`	否

参数必须定义 limit 或 limit_percentage, spike_limit_percentage 对，但不能同时定义两者。

配置选项 limit 和 limit_percentage 定义了硬限制。软限制随后计算为硬限制减去 spike_limit 或 spike_limit_percentage 值。建议的峰值限制值约为相应硬限制的 20%。

建议的 check_interval 值为 1 秒。如果组件的流量本质上是峰值性质的，则建议减少间隔或增加峰值限制，以避免超过硬限制。

limit 和 spike_limit 值必须大于 1 MiB。

块

在 otelcol.processor.memory_limiter 的定义中支持以下块

层次结构	块	描述	必需
output	output	配置将接收到的遥测数据发送到何处。	是
debug_metrics	debug_metrics	配置此组件生成的用于监控其状态的指标。	否

output 块

output 块配置一组组件，以将生成的遥测数据转发到这些组件。

支持以下参数

名称	类型	描述	默认值	必需
`logs`	`list(otelcol.Consumer)`	要将日志发送到的消费者列表。	`[]`	否
`metrics`	`list(otelcol.Consumer)`	要将指标发送到的消费者列表。	`[]`	否
`traces`	`list(otelcol.Consumer)`	要将追踪发送到的消费者列表。	`[]`	否

您必须指定 output 块，但其所有参数都是可选的。默认情况下，遥测数据将被丢弃。相应地配置 metrics、logs 和 traces 参数以将遥测数据发送到其他组件。

debug_metrics 块

debug_metrics 块配置此组件生成的用于监控其状态的指标。

支持以下参数

名称	类型	描述	默认值	必需
`disable_high_cardinality_metrics`	`boolean`	是否禁用某些高基数指标。	`true`	否
`level`	`string`	控制包装的收集器发出的指标的详细程度。	`"detailed"`	否

disable_high_cardinality_metrics 是 Grafana Alloy 等效于 OpenTelemetry Collector 中的 telemetry.disableHighCardinalityMetrics 功能标志。它会删除可能导致高基数指标的属性。例如，有关 HTTP 和 gRPC 连接的指标中包含 IP 地址和端口号的属性将被删除。