diff --git a/.chloggen/cpu_usage_fg_stable.yaml b/.chloggen/cpu_usage_fg_stable.yaml new file mode 100644 index 0000000000000..a9f189496fdcd --- /dev/null +++ b/.chloggen/cpu_usage_fg_stable.yaml @@ -0,0 +1,27 @@ +# Use this changelog template to create an entry for release notes. + +# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix' +change_type: breaking + +# The name of the component, or a single word describing the area of concern, (e.g. filelogreceiver) +component: kubeletstats + +# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`). +note: Move receiver.kubeletstats.enableCPUUsageMetrics feature gate to stable + +# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists. +issues: [39650] + +# (Optional) One or more lines of additional information to render under the primary note. +# These lines will be padded with 2 spaces and then inserted directly into the document. +# Use pipe (|) for multiline entries. +subtext: + +# If your change doesn't affect end users or the exported elements of any package, +# you should instead start your pull request title with [chore] or use the "Skip Changelog" label. +# Optional: The change log or logs in which this entry should be included. +# e.g. '[user]' or '[user, api]' +# Include 'user' if the change is relevant to end users. +# Include 'api' if there is a change to a library API. +# Default: '[user]' +change_logs: [] diff --git a/receiver/kubeletstatsreceiver/README.md b/receiver/kubeletstatsreceiver/README.md index 820e3b36b7318..05888e4cefd86 100644 --- a/receiver/kubeletstatsreceiver/README.md +++ b/receiver/kubeletstatsreceiver/README.md @@ -18,7 +18,8 @@ The Kubelet Stats Receiver pulls node, pod, container, and volume metrics from t and sends it down the metric pipeline for further processing. > [!WARNING] -> The `receiver.kubeletstats.enableCPUUsageMetrics` feature gate was moved to stage `Beta` what results in a breaking change in metrics names. +> The `receiver.kubeletstats.enableCPUUsageMetrics` feature gate was moved to stage `Stable`. +> Deprecated metrics cannot be used anymore. > For more information which metrics are affected see [here](#metrics-deprecation). ## Metrics @@ -343,8 +344,6 @@ The following metrics were deprecated and renamed from version `v0.125.0`: The above metrics show usage counted in CPUs and it's not a percentage of used resources. These metrics were previously incorrectly named using the utilization term. -You can enable the usage of the deprecated metrics by disabling the `receiver.kubeletstats.enableCPUUsageMetrics` feature gate. - #### `receiver.kubeletstats.enableCPUUsageMetrics` feature gate - alpha: when enabled it makes the `.cpu.usage` metrics enabled by default, disabling the `.cpu.utilization` metrics diff --git a/receiver/kubeletstatsreceiver/factory.go b/receiver/kubeletstatsreceiver/factory.go index 52c6cf3f3eb8a..840fa3b23c62f 100644 --- a/receiver/kubeletstatsreceiver/factory.go +++ b/receiver/kubeletstatsreceiver/factory.go @@ -27,9 +27,10 @@ const ( var EnableCPUUsageMetrics = featuregate.GlobalRegistry().MustRegister( enableCPUUsageMetricsFeatureFlag, - featuregate.StageBeta, + featuregate.StageStable, featuregate.WithRegisterDescription("When enabled the container.cpu.utilization, k8s.pod.cpu.utilization and k8s.node.cpu.utilization metrics will be replaced by the container.cpu.usage, k8s.pod.cpu.usage and k8s.node.cpu.usage"), featuregate.WithRegisterFromVersion("v0.110.0"), + featuregate.WithRegisterToVersion("v0.131.0"), featuregate.WithRegisterReferenceURL("https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/27885"), )