otelcol.processor.memory_limiter

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

`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`	否

`disable_high_cardinality_metrics` 是 Grafana Alloy 中相当于 OpenTelemetry Collector 中的 `telemetry.disableHighCardinalityMetrics` 功能门。它会移除可能导致高基数指标的属性。例如，HTTP 和 gRPC 连接指标中包含 IP 地址和端口号的属性会被移除。