OpenTelemetry Kubernetes Attributes Processor Reaches v1.0.0 Stability

Kubernetes Attributes Processor Achieves Stability

OpenTelemetry has promoted its Kubernetes Attributes Processor to v1.0.0. This release signifies that the component now meets OpenTelemetry's stability requirements for testing, benchmarking, documentation, and telemetry. It also provides API stability for organizations integrating the processor into their own Collector distributions.

Functionality and Importance

The Kubernetes Attributes Processor is a critical component in many OpenTelemetry deployments. It discovers Kubernetes resources and associates telemetry data, such as logs, metrics, and traces, with metadata like pods, namespaces, nodes, and workloads. This enrichment transforms generic telemetry into queryable and correlatable data within a Kubernetes context. While stable for logs, metrics, and traces, profile support remains under development.

Semantic Convention Changes and Migration

The v1.0.0 release is not fully backward compatible, as it adopts the newer OpenTelemetry Kubernetes semantic conventions, which reached stable status in Semantic Conventions v1.42.0 in June 2026. This required coordination between the Collector and Kubernetes Semantic Conventions SIGs to ensure consistency.

Several attribute names have changed; for example, 'container.image.tag' is now 'container.image.tags', and Kubernetes label and annotation attributes moved from plural forms like 'k8s.pod.labels' to singular forms like 'k8s.pod.label'. These changes also apply to node and namespace labels and annotations.

Impact on Observability Teams

The attribute name changes mean that observability teams will need to update dashboards, alerts, recording rules, queries, data pipelines, and downstream integrations that reference the older attribute names. OpenTelemetry provides feature gates to allow both old and new conventions to be emitted during a migration period, facilitating a gradual transition before users rely solely on the stable schema.

Part of Broader Stability Initiative

The graduation of this processor is part of OpenTelemetry's wider "Stable by Default" initiative. The Collector SIG began focusing on the stability of heavily used components in late 2025, driven by community feedback and Collector usage data.