feat(collector): promote operator.collector.usedefaulttelemetryshape gate to beta

[nikhilmantri0902]

Description: Promotes the operator.collector.usedefaulttelemetryshape feature gate from Alpha to Beta. Beta gates default ON, so the operator-injected Prometheus telemetry reader now uses collector
defaults — metric names from operator-managed collectors no longer carry type suffixes, units, or scope_info.

AddPrometheusMetricsEndpoint retains the gate check so users who need the pre-v0.152.0 metric name shape can opt out via --feature-gates=-operator.collector.usedefaulttelemetryshape, or pin
without_type_suffix/without_units/without_scope_info to false explicitly under spec.config.service.telemetry. The gate will be promoted to Stable and removed in a future release.

This is the next step in the SIG plan from 2026-05-05 tracked in #5075.

Link to tracking Issue(s): #5075

• Part of: Use the same default collector telemetry settings as upstream #5075

Testing:

• Updated internal/otelconfig/config_test.go:
  • Renamed the gate-toggle tests to TestAddPrometheusMetricsEndpointUsesCollectorDefaultsByDefault (no toggle, default behavior) and TestAddPrometheusMetricsEndpointPreservesShapeWhenGateDisabled
    (explicitly disables the gate via a new withTelemetryShapeGate helper).
  • Adjusted TestTelemetryLogsPreservedWithMetrics and TestTelemetryIncompleteConfigAppliesDefaults to expect the 3 fields to be absent under the new default.
• Updated internal/webhook/collector_webhook_test.go (TestCollectorDefaultingWebhook) and pkg/collector/upgrade/v0_122_0_test.go (TestUpgrade0_122_0/should_remove_address_field_from_metrics_config)
  to drop the 3 fields from their expected configs.
• Updated 14 e2e assert YAMLs (tests/e2e/*, tests/e2e-targetallocator*, tests/e2e-ta-collector-mtls, tests/e2e-openshift/must-gather) to drop the 3 without_*: false lines.
• Recomputed the 3 hash-suffixed ConfigMap names in tests/e2e/versioned-configmaps/{00,01}-assert.yaml and tests/e2e-openshift/must-gather/assert-install-target-allocator.yaml for the new rendered config
  bytes.

Verified locally: go test ./... (45 packages, 0 failures) and ./bin/chainsaw test --test-dir ./tests/e2e/versioned-configmaps → PASS.

Documentation: Added a changelog entry at .chloggen/feat_5075-promote-telemetry-shape-beta.yaml (enhancement, collector). The feature-gate's WithRegisterDescription and the comment on
AddPrometheusMetricsEndpoint have been updated to reflect the new default.

[codecov]

❌ 18 Tests Failed:

Tests completed	Failed	Passed	Skipped
101	18	83	2

View the top 3 failed test(s) by shortest run time

::instrumentation-nginx-multicontainer

Stack Traces | 378s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true

::instrumentation-python

Stack Traces | 386s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true

::instrumentation-python-oldest

Stack Traces | 389s run time

($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true

::instrumentation-apache-multicontainer

Stack Traces | 389s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true

::instrumentation-dotnet-multicontainer

Stack Traces | 397s run time

($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-dotnet

Stack Traces | 397s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-apache-httpd

Stack Traces | 407s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true

::instrumentation-nginx-contnr-secctx

Stack Traces | 410s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true

::instrumentation-nginx

Stack Traces | 411s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `0`): Invalid value: null: Expected value: true

::instrumentation-java-other-ns

Stack Traces | 426s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-python-musl

Stack Traces | 427s run time

($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-java

Stack Traces | 427s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-nodejs-multicontainer

Stack Traces | 427s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-java-multicontainer

Stack Traces | 427s run time

($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-nodejs

Stack Traces | 427s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-python-multicontainer

Stack Traces | 428s run time

($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-nodejs-volume

Stack Traces | 441s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true

::instrumentation-java-tls

Stack Traces | 450s run time

($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_exporter_sent_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_metric_points_total'].value | [0] > `1`): Invalid value: null: Expected value: true; ($metrics[?as_string(metric."__name__") == 'otelcol_receiver_accepted_spans_total'].value | [0] > `1`): Invalid value: null: Expected value: true

To view more test analytics, go to the Test Analytics Dashboard
_{📋 Got 3 mins? Take this short survey to help us improve Test Analytics.}

[nikhilmantri0902]

@swiatekm can you review this, its ready.

[swiatekm]

The code changes look good to me, left some comments about the documentation.

[swiatekm]

This is a breaking change.

[nikhilmantri0902]

addressed

[swiatekm]

From the users' perspective, this will take place in v0.154.0, so that's the version we should refer to. This comment applies to other bits of documentation in this PR too.

[nikhilmantri0902]

addressed