Skip to main content

​
Cgroupruntime Extension

Status Available in: contrib Maintainers: @mx-psi, @rogercoll Source: opentelemetry-collector-contrib

​
Overview

​
Overview

The OpenTelemetry Cgroup Auto-Config Extension is designed to optimize Go runtime performance in containerized environments by automatically configuring GOMAXPROCS and GOMEMLIMIT based on the Linux cgroup filesystem. This extension leverages automaxprocs or gomaxecs for AWS ECS Tasks and automemlimit packages to dynamically adjust Go runtime variables, ensuring efficient resource usage aligned with container limits.

​
Configuration

The following settings can be configured:
  • gomaxprocs: Configures the behavior of setting GOMAXPROCS, the maximum number of CPUs for Go runtime. Options:
    • enabled: A boolean value to enable or disable automatic configuration of GOMAXPROCS based on the system’s cgroup settings (default: true).
  • gomemlimit: Configures the behavior of setting GOMEMLIMIT, the maximum memory limit for Go runtime. Options:
    • enabled: A boolean value to enable or disable automatic configuration of GOMEMLIMIT (default: true).
    • ratio: A floating-point value between 0 and 1 that represents the fraction of the detected memory limit to allocate for the Go runtime (default: 0.9).

​
Examples

extensions:
  # processor name: cgroupruntime
  cgroup_runtime:
    gomaxprocs:
      enabled: true
    gomemlimit:
      enabled: true
      ratio: 0.8

​
Contributing

See CONTRIBUTING.md for information on how to contribute to this extension.

​
Configuration

​
Example Configuration

cgroup_runtime:
cgroup_runtime/invalid_ratio:
  gomemlimit:
    ratio: 1.1
cgroup_runtime/invalid_ratio_disabled:
  gomemlimit:
    ratio: 0
cgroup_runtime/invalid_ratio_negative:
  gomemlimit:
    ratio: -12.5
cgroup_runtime/invalid_ratio_type:
  gomemlimit:
    ratio: "not_valid"
Last generated: 2026-04-13