Semantic conventionsv1.35.0

30 Jun 2025since v1.34.0

0 breaking23 notable130 editorial

From the upstream release notes

azure: Align azure events, attributes, and enum members with general naming guidelines. (#608, #1708, #1698)
system: Revert the change that moved system.cpu.* to cpu.*. The 3 affected metrics are back in system.cpu.*.
system: Changes system.network.connections to system.network.connection.count
k8s: Change instrument type for .limit/.request container metrics from gauge to updowncounter
os: Deprecate os.type='z_os' and replace with os.type='zos'
mainframe, zos: Add initial semantic conventions for mainframes
dotnet: Define .NET-specific network spans for DNS resolution, TLS handshake, and socket connections, along with HTTP-level spans to (optionally) record relationships between HTTP requests and connections.
k8s: Add k8s.node.allocatable.cpu, k8s.node.allocatable.ephemeral_storage, k8s.node.allocatable.memory, k8s.node.allocatable.pods metrics
k8s: Add k8s.container.restart.count metric
k8s: Add K8s container resource related metrics

Read the full release notes

Notable23

removedsignalspan.gen_ai.az.ai.inference.clientRemoved from the registry (was development).
renamedattributeaz.namespaceRenamed to azure.resource_provider.namespace.
renamedattributeaz.service_request_idRenamed to azure.service.request.id.
renamedmetriccpu.frequencyRenamed to system.cpu.frequency.
renamedmetriccpu.timeRenamed to system.cpu.time.
renamedmetriccpu.utilizationRenamed to system.cpu.utilization.
renamedsignalevent.az.resource.logRenamed to azure.resource.log.
renamedmetricsystem.network.connectionsRenamed to system.network.connection.count.
deprecatedsignalentity.otel.scopeDeprecated (obsoleted).
unitmetriccpu.frequencyUnit changed from Hz to {Hz}.
unitmetricsystem.cpu.frequencyUnit changed from {Hz} to Hz.
stabilitysignalevent.feature_flag.evaluationPromoted to release_candidate.
stabilityattributefeature_flag.context.idPromoted to release_candidate.
stabilityattributefeature_flag.keyPromoted to release_candidate.
stabilityattributefeature_flag.provider.namePromoted to release_candidate.
stabilityattributefeature_flag.result.reasonPromoted to release_candidate.
stabilityattributefeature_flag.result.valuePromoted to release_candidate.
stabilityattributefeature_flag.result.variantPromoted to release_candidate.
stabilityattributefeature_flag.set.idPromoted to release_candidate.
stabilityattributefeature_flag.versionPromoted to release_candidate.
un-deprecatedmetricsystem.cpu.frequencyNo longer marked deprecated.
un-deprecatedmetricsystem.cpu.timeNo longer marked deprecated.
un-deprecatedmetricsystem.cpu.utilizationNo longer marked deprecated.

Editorial130

enumattributecloud.platformEnum members changed (30 to 37).
enumattributegen_ai.systemEnum members changed (17 to 19).
enumattributeos.typeEnum members changed (11 to 12).
enumattributeotel.component.typeEnum members changed (14 to 16).
addedattributeazure.resource_provider.namespaceAzure Resource Provider Namespace as recognized by the...
addedattributeazure.service.request.idThe unique identifier of the service request. It's generated by the Azure service and returned with the response.
addedattributedns.answersThe list of IPv4 or IPv6 addresses resolved during DNS lookup.
addedsignalevent.azure.resource.logDescribes Azure Resource Log event, see [Azure Resource Log Top-level Schema](https://learn.microsoft.com/azure/azure-monitor/essentials/resource-logs-schema#t...
addedmetrick8s.container.cpu.limitMaximum CPU resource limit set for the container
addedmetrick8s.container.cpu.requestCPU resource requested for the container
addedmetrick8s.container.ephemeral_storage.limitMaximum ephemeral storage resource limit set for the container
addedmetrick8s.container.ephemeral_storage.requestEphemeral storage resource requested for the container
addedmetrick8s.container.memory.limitMaximum memory resource limit set for the container
addedmetrick8s.container.memory.requestMemory resource requested for the container
addedmetrick8s.container.readyIndicates whether the container is currently marked as ready to accept traffic, based on its readiness probe (1 = ready, 0 = not ready)
addedmetrick8s.container.restart.countDescribes how many times the container has restarted (since the last counter reset)
addedattributek8s.container.status.reasonThe reason for the container state. Corresponds to the reason field of the: [K8s ContainerStateWaiting](https://kubernetes.io/docs/reference/generated/kubern...
addedmetrick8s.container.status.reasonDescribes the number of K8s containers that are currently in a state for a given reason
addedattributek8s.container.status.stateThe state of the container. K8s ContainerState
addedmetrick8s.container.status.stateDescribes the number of K8s containers that are currently in a given state
addedmetrick8s.container.storage.limitMaximum storage resource limit set for the container
addedmetrick8s.container.storage.requestStorage resource requested for the container
addedmetrick8s.hpa.metric.target.cpu.average_utilizationTarget average utilization, in percentage, for CPU resource in HPA config.
addedmetrick8s.hpa.metric.target.cpu.average_valueTarget average value for CPU resource in HPA config.
addedmetrick8s.hpa.metric.target.cpu.valueTarget value for CPU resource in HPA config.
addedattributek8s.hpa.metric.typeThe type of metric source for the horizontal pod autoscaler.
addedattributek8s.hpa.scaletargetref.api_versionThe API version of the target resource to scale for the HorizontalPodAutoscaler.
addedattributek8s.hpa.scaletargetref.kindThe kind of the target resource to scale for the HorizontalPodAutoscaler.
addedattributek8s.hpa.scaletargetref.nameThe name of the target resource to scale for the HorizontalPodAutoscaler.
addedattributek8s.hugepage.sizeThe size (identifier) of the K8s huge page.
addedmetrick8s.node.allocatable.cpuAmount of cpu allocatable on the node
addedmetrick8s.node.allocatable.ephemeral_storageAmount of ephemeral-storage allocatable on the node
addedmetrick8s.node.allocatable.memoryAmount of memory allocatable on the node
addedmetrick8s.node.allocatable.podsAmount of pods allocatable on the node
addedattributek8s.node.condition.statusThe status of the condition, one of True, False, Unknown.
addedmetrick8s.node.condition.statusDescribes the condition of a particular Node.
addedattributek8s.node.condition.typeThe condition type of a K8s Node.
addedmetrick8s.resourcequota.cpu.limit.hardThe CPU limits in a specific namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.cpu.limit.usedThe CPU limits in a specific namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.cpu.request.hardThe CPU requests in a specific namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.cpu.request.usedThe CPU requests in a specific namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.ephemeral_storage.limit.hardThe sum of local ephemeral storage limits in the namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.ephemeral_storage.limit.usedThe sum of local ephemeral storage limits in the namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.ephemeral_storage.request.hardThe sum of local ephemeral storage requests in the namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.ephemeral_storage.request.usedThe sum of local ephemeral storage requests in the namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.hugepage_count.request.hardThe huge page requests in a specific namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.hugepage_count.request.usedThe huge page requests in a specific namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.memory.limit.hardThe memory limits in a specific namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.memory.limit.usedThe memory limits in a specific namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.memory.request.hardThe memory requests in a specific namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.memory.request.usedThe memory requests in a specific namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.object_count.hardThe object count limits in a specific namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.object_count.usedThe object count limits in a specific namespace. The value represents the current observed total usage of the resource in the namespace.
addedmetrick8s.resourcequota.persistentvolumeclaim_count.hardThe total number of PersistentVolumeClaims that can exist in the namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.persistentvolumeclaim_count.usedThe total number of PersistentVolumeClaims that can exist in the namespace. The value represents the current observed total usage of the resource in the namesp...
addedattributek8s.resourcequota.resource_nameThe name of the K8s resource a resource quota defines.
addedmetrick8s.resourcequota.storage.request.hardThe storage requests in a specific namespace. The value represents the configured quota limit of the resource in the namespace.
addedmetrick8s.resourcequota.storage.request.usedThe storage requests in a specific namespace. The value represents the current observed total usage of the resource in the namespace.
addedattributek8s.storageclass.nameThe name of K8s StorageClass object.
addedattributemainframe.lpar.nameName of the logical partition that hosts a systems with a mainframe operating system.
addedsignalspan.dotnet.dns.lookup.internalThe span describes DNS lookup or reverse lookup performed with one of the methods on System.Net.Dns cl...
addedsignalspan.dotnet.http.connection_setup.internalThe span describes the establishment of the HTTP connection. It includes the time it takes to resolve the DNS, establish the socket connection, and perform the...
addedsignalspan.dotnet.http.request.wait_for_connection.internalThe span describes the time it takes for the HTTP request to obtain a connection from the connection pool.
addedsignalspan.dotnet.socket.connect.internalThe span describes the establishment of the socket connection.
addedsignalspan.dotnet.tls.handshake.internalThe span describes TLS client or server handshake performed with [System.Net.Security.SslStream](https://learn.microsoft.com/dotnet/api/system.net.security.ssl...
addedsignalspan.gen_ai.azure.ai.inference.clientSemantic Conventions for Azure AI Inference client spans extend and over...
addedmetricsystem.network.connection.countAdded as development.
addedattributezos.smf.idThe System Management Facility (SMF) Identifier uniquely identified a z/OS system within a SYSPLEX or mainframe environment and is used for system and performa...
addedattributezos.sysplex.nameThe name of the SYSPLEX to which the z/OS system belongs too.
guidanceattributecloud.resource_idGuidance note changed.
guidancemetrick8s.cronjob.active_jobsGuidance note changed.
guidanceattributek8s.daemonset.annotationGuidance note changed.
guidancemetrick8s.daemonset.current_scheduled_nodesGuidance note changed.
guidancemetrick8s.daemonset.desired_scheduled_nodesGuidance note changed.
guidanceattributek8s.daemonset.labelGuidance note changed.
guidancemetrick8s.daemonset.misscheduled_nodesGuidance note changed.
guidancemetrick8s.daemonset.ready_nodesGuidance note changed.
guidanceattributek8s.deployment.annotationGuidance note changed.
guidancemetrick8s.deployment.available_podsGuidance note changed.
guidancemetrick8s.deployment.desired_podsGuidance note changed.
guidanceattributek8s.deployment.labelGuidance note changed.
guidancemetrick8s.hpa.current_podsGuidance note changed.
guidancemetrick8s.hpa.desired_podsGuidance note changed.
guidancemetrick8s.hpa.max_podsGuidance note changed.
guidancemetrick8s.hpa.min_podsGuidance note changed.
guidancemetrick8s.job.active_podsGuidance note changed.
guidanceattributek8s.job.annotationGuidance note changed.
guidancemetrick8s.job.desired_successful_podsGuidance note changed.
guidancemetrick8s.job.failed_podsGuidance note changed.
guidanceattributek8s.job.labelGuidance note changed.
guidancemetrick8s.job.max_parallel_podsGuidance note changed.
guidancemetrick8s.job.successful_podsGuidance note changed.
guidanceattributek8s.namespace.annotationGuidance note changed.
guidanceattributek8s.namespace.labelGuidance note changed.
guidancemetrick8s.namespace.phaseGuidance note changed.
guidanceattributek8s.replicaset.annotationGuidance note changed.
guidancemetrick8s.replicaset.available_podsGuidance note changed.
guidancemetrick8s.replicaset.desired_podsGuidance note changed.
guidanceattributek8s.replicaset.labelGuidance note changed.
guidancemetrick8s.replicationcontroller.available_podsGuidance note changed.
guidancemetrick8s.replicationcontroller.desired_podsGuidance note changed.
guidanceattributek8s.statefulset.annotationGuidance note changed.
guidancemetrick8s.statefulset.current_podsGuidance note changed.
guidancemetrick8s.statefulset.desired_podsGuidance note changed.
guidanceattributek8s.statefulset.labelGuidance note changed.
guidancemetrick8s.statefulset.ready_podsGuidance note changed.
guidancemetrick8s.statefulset.updated_podsGuidance note changed.
wordingattributeaz.namespaceDeprecated, use azure.resource_provider.namespace instead.
wordingattributeaz.service_request_idDeprecated, use azure.service.request.id instead.
wordingmetriccpu.frequencyDeprecated. Use system.cpu.frequency instead.
wordingmetriccpu.timeDeprecated. Use system.cpu.time instead.
wordingmetriccpu.utilizationDeprecated. Use system.cpu.utilization instead.
wordingsignalevent.az.resource.logDeprecated. Use azure.resource.log instead.
wordingattributeprocess.environment_variableProcess environment variables, <key> being the environment variable name, the value being the environment variable value.
wordingmetricsystem.cpu.frequencyOperating frequency of the logical CPU in Hertz.
wordingmetricsystem.cpu.timeSeconds each logical CPU spent on each mode
wordingmetricsystem.cpu.utilizationFor each logical CPU, the utilization is calculated as the change in cumulative CPU time (cpu.time) over a measurement interval, divided by the elapsed time.
wordingmetricsystem.network.connectionsDeprecated, use system.network.connection.count instead
examplesattributek8s.daemonset.annotationExamples changed.
examplesattributek8s.daemonset.labelExamples changed.
examplesattributek8s.deployment.annotationExamples changed.
examplesattributek8s.deployment.labelExamples changed.
examplesattributek8s.job.annotationExamples changed.
examplesattributek8s.job.labelExamples changed.
examplesattributek8s.namespace.annotationExamples changed.
examplesattributek8s.namespace.labelExamples changed.
examplesattributek8s.replicaset.annotationExamples changed.
examplesattributek8s.replicaset.labelExamples changed.
examplesattributek8s.statefulset.annotationExamples changed.
examplesattributek8s.statefulset.labelExamples changed.