Semantic conventionsv1.40.0

19 Feb 2026since v1.39.0

0 breaking31 notable115 editorial

From the upstream release notes

db: Oracle's db.namespace updated to represent only the database’s
error, feature-flags: Deprecate error.message in favor of using domain-specific codes such as feature_flag.error.message.
rpc: Remove network.protocol.name, network.protocol.version, and network.transport attributes from RPC spans and metrics.
system: Rename system.memory.shared to system.memory.linux.shared
exceptions: Update exception recording guidelines to not use span events.
rpc: Deprecate experimental rpc.server.request.size, rpc.server.response.size, rpc.client.request.size, and rpc.client.response.size metrics due to ambiguous definitions and inconsistent implementation.
rpc: Deprecate the rpc.message event and its attributes (#3266, #3283)
cloud: Add oracle_cloud.realm vendor-specific attribute for Oracle Cloud Infrastructure (OCI) realm identifier.
db: Mark the Oracle Database client span as Release Candidate.
db: Modify area to oracledb from oracle

Read the full release notes

Notable31

renamedattributefeature_flag.evaluation.error.messageRenamed to feature_flag.error.message.
renamedmetricsystem.memory.sharedRenamed to system.memory.linux.shared.
deprecatedattributeerror.messageUse domain-specific error message attribute. For example, use feature_flag.error.message for feature flag errors.
deprecatedsignalevent.rpc.messageDeprecated, no replacement at this time.
deprecatedattributemessage.compressed_sizeDeprecated, no replacement at this time.
deprecatedattributemessage.idDeprecated, no replacement at this time.
deprecatedattributemessage.typeDeprecated, no replacement at this time.
deprecatedattributemessage.uncompressed_sizeDeprecated, no replacement at this time.
deprecatedmetricrpc.client.request.sizeRemoved, no replacement at this time.
deprecatedmetricrpc.client.response.sizeRemoved, no replacement at this time.
deprecatedattributerpc.message.compressed_sizeDeprecated, no replacement at this time.
deprecatedattributerpc.message.idDeprecated, no replacement at this time.
deprecatedattributerpc.message.typeDeprecated, no replacement at this time.
deprecatedattributerpc.message.uncompressed_sizeDeprecated, no replacement at this time.
deprecatedmetricrpc.server.request.sizeRemoved, no replacement at this time.
deprecatedmetricrpc.server.response.sizeRemoved, no replacement at this time.
stabilitysignalentity.service.instancePromoted to stable.
stabilitysignalentity.service.namespacePromoted to stable.
stabilitymetricrpc.client.call.durationPromoted to release_candidate.
stabilityattributerpc.methodPromoted to release_candidate.
stabilityattributerpc.method_originalPromoted to release_candidate.
stabilityattributerpc.response.status_codePromoted to release_candidate.
stabilitymetricrpc.server.call.durationPromoted to release_candidate.
stabilityattributerpc.system.namePromoted to release_candidate.
stabilityattributeservice.instance.idPromoted to stable.
stabilityattributeservice.namespacePromoted to stable.
stabilitysignalspan.db.oracledb.clientPromoted to release_candidate.
stabilitysignalspan.rpc.call.clientPromoted to release_candidate.
stabilitysignalspan.rpc.call.serverPromoted to release_candidate.
stabilitysignalspan.rpc.grpc.call.clientPromoted to release_candidate.
stabilitysignalspan.rpc.grpc.call.serverPromoted to release_candidate.

Editorial115

stabilityattributecontainer.idStability label respelled from alpha to beta.
stabilityattributecontainer.image.nameStability label respelled from alpha to beta.
stabilityattributecontainer.image.repo_digestsStability label respelled from alpha to beta.
stabilityattributecontainer.image.tagsStability label respelled from alpha to beta.
stabilityattributek8s.cluster.nameStability label respelled from alpha to beta.
stabilityattributek8s.cluster.uidStability label respelled from alpha to beta.
stabilityattributek8s.container.nameStability label respelled from alpha to beta.
stabilityattributek8s.container.restart_countStability label respelled from alpha to beta.
stabilityattributek8s.cronjob.annotationStability label respelled from alpha to beta.
stabilityattributek8s.cronjob.labelStability label respelled from alpha to beta.
stabilityattributek8s.cronjob.nameStability label respelled from alpha to beta.
stabilityattributek8s.cronjob.uidStability label respelled from alpha to beta.
stabilityattributek8s.daemonset.annotationStability label respelled from alpha to beta.
stabilityattributek8s.daemonset.labelStability label respelled from alpha to beta.
stabilityattributek8s.daemonset.nameStability label respelled from alpha to beta.
stabilityattributek8s.daemonset.uidStability label respelled from alpha to beta.
stabilityattributek8s.deployment.annotationStability label respelled from alpha to beta.
stabilityattributek8s.deployment.labelStability label respelled from alpha to beta.
stabilityattributek8s.deployment.nameStability label respelled from alpha to beta.
stabilityattributek8s.deployment.uidStability label respelled from alpha to beta.
stabilityattributek8s.job.annotationStability label respelled from alpha to beta.
stabilityattributek8s.job.labelStability label respelled from alpha to beta.
stabilityattributek8s.job.nameStability label respelled from alpha to beta.
stabilityattributek8s.job.uidStability label respelled from alpha to beta.
stabilityattributek8s.namespace.annotationStability label respelled from alpha to beta.
stabilityattributek8s.namespace.labelStability label respelled from alpha to beta.
stabilityattributek8s.namespace.nameStability label respelled from alpha to beta.
stabilityattributek8s.node.annotationStability label respelled from alpha to beta.
stabilityattributek8s.node.labelStability label respelled from alpha to beta.
stabilityattributek8s.node.nameStability label respelled from alpha to beta.
stabilityattributek8s.node.uidStability label respelled from alpha to beta.
stabilityattributek8s.pod.annotationStability label respelled from alpha to beta.
stabilityattributek8s.pod.hostnameStability label respelled from alpha to beta.
stabilityattributek8s.pod.ipStability label respelled from alpha to beta.
stabilityattributek8s.pod.labelStability label respelled from alpha to beta.
stabilityattributek8s.pod.nameStability label respelled from alpha to beta.
stabilityattributek8s.pod.start_timeStability label respelled from alpha to beta.
stabilityattributek8s.pod.uidStability label respelled from alpha to beta.
stabilityattributek8s.replicaset.annotationStability label respelled from alpha to beta.
stabilityattributek8s.replicaset.labelStability label respelled from alpha to beta.
stabilityattributek8s.replicaset.nameStability label respelled from alpha to beta.
stabilityattributek8s.replicaset.uidStability label respelled from alpha to beta.
stabilityattributek8s.statefulset.annotationStability label respelled from alpha to beta.
stabilityattributek8s.statefulset.labelStability label respelled from alpha to beta.
stabilityattributek8s.statefulset.nameStability label respelled from alpha to beta.
stabilityattributek8s.statefulset.uidStability label respelled from alpha to beta.
enumattributegen_ai.operation.nameEnum members changed (7 to 8).
addedsignalentity.gcp.gce.instance_group_managerA GCE instance group manager.
addedsignalentity.k8s.serviceA Kubernetes Service object.
addedsignalevent.db.client.operation.exceptionThis event represents an exception that occurred during a database client operation, such as connection failures, query errors, timeouts, or other errors that ...
addedsignalevent.http.client.request.exceptionThis event represents an exception that occurred during an HTTP client request, such as network failures, timeouts, or other errors that prevent the request fr...
addedsignalevent.http.server.request.exceptionThis event represents an exception that occurred during HTTP server request processing, such as application errors, internal failures, or other exceptions that...
addedsignalevent.rpc.client.call.exceptionThis event represents an exception that occurred during an outgoing RPC call, such as network failures, timeouts, serialization errors, or other errors that pr...
addedsignalevent.rpc.server.call.exceptionThis event represents an exception that occurred during incoming RPC call processing, such as application errors, internal failures, or other exceptions that p...
addedattributefeature_flag.error.messageA message providing more detail about an error that occurred during feature flag evaluation in human-readable form.
addedattributegcp.gce.instance_group_manager.nameThe name of the Instance Group Manager (IGM) that manages this VM, if any.
addedattributegcp.gce.instance_group_manager.regionThe region of a **regional** Instance Group Manager (e.g., us-central1). Set this **only** when the IGM is regional.
addedattributegcp.gce.instance_group_manager.zoneThe zone of a **zonal** Instance Group Manager (e.g., us-central1-a). Set this **only** when the IGM is zonal.
addedattributegen_ai.agent.versionThe version of the GenAI agent.
addedattributegen_ai.retrieval.documentsThe documents retrieved.
addedattributegen_ai.retrieval.query.textThe query text used for retrieval.
addedattributegen_ai.usage.cache_creation.input_tokensThe number of input tokens written to a provider-managed cache.
addedattributegen_ai.usage.cache_read.input_tokensThe number of input tokens served from a provider-managed cache.
addedmetricjvm.file_descriptor.limitMeasure of max open file descriptors as reported by the JVM.
addedattributek8s.service.annotationThe annotation placed on the Service, the <key> being the annotation name, the value being the annotation value, even if the value is empty.
addedattributek8s.service.endpoint.address_typeThe address type of the service endpoint.
addedattributek8s.service.endpoint.conditionThe condition of the service endpoint.
addedmetrick8s.service.endpoint.countNumber of endpoints for a service by condition and address type.
addedattributek8s.service.endpoint.zoneThe zone of the service endpoint.
addedattributek8s.service.labelThe label placed on the Service, the <key> being the label name, the value being the label value, even if the value is empty.
addedmetrick8s.service.load_balancer.ingress.countNumber of load balancer ingress points (external IPs/hostnames) assigned to the service.
addedattributek8s.service.nameThe name of the Service.
addedattributek8s.service.publish_not_ready_addressesWhether the Service publishes not-ready endpoints.
addedattributek8s.service.selectorThe selector key-value pair placed on the Service, the <key> being the selector key, the value being the selector value.
addedattributek8s.service.traffic_distributionThe traffic distribution policy for the Service.
addedattributek8s.service.typeThe type of the Kubernetes Service.
addedattributek8s.service.uidThe UID of the Service.
addedattributeopenai.api.typeThe type of OpenAI API being used.
addedattributeoracle_cloud.realmThe OCI realm identifier that indicates the isolated partition in which the tenancy and its resources reside.
addedattributeoracle.db.domainThe database domain associated with the connection.
addedattributeoracle.db.instance.nameThe instance name associated with the connection in an Oracle Real Application Clusters environment.
addedattributeoracle.db.nameThe database name associated with the connection.
addedattributeoracle.db.pdbThe pluggable database (PDB) name associated with the connection.
addedattributeoracle.db.serviceThe service name currently associated with the database connection.
addedattributepprof.scope.default_sample_typeRecords the pprof's default_sample_type in the original profile. Not set if the default sample type was missing.
addedattributepprof.scope.sample_type_orderRecords the indexes of the sample types in the original profile.
addedattributeservice.criticalityThe operational criticality of the service.
addedsignalspan.anthropic.inference.clientSemantic Conventions for Anthropic client spans extend and override the semantic conventions for Gen AI Spans.
addedsignalspan.gen_ai.retrieval.clientDescribes GenAI retrieval span - a request to a Generative AI service or framework that retrieves relevant information or context from a vector database or sea...
addedsignalspan.rpc.dubbo.call.clientThis span represents an outgoing Remote Procedure Call (RPC).
addedsignalspan.rpc.dubbo.call.serverThis span represents an incoming Remote Procedure Call (RPC).
addedmetricsystem.memory.linux.sharedShared memory used (mostly by tmpfs).
guidanceattributedb.query.summaryGuidance note changed.
guidanceattributeexception.messageGuidance note changed.
guidanceattributegen_ai.usage.input_tokensGuidance note changed.
guidanceattributehttp.request.methodGuidance note changed.
guidancesignalspan.rpc.call.clientGuidance note changed.
guidancesignalspan.rpc.call.serverGuidance note changed.
guidancesignalspan.rpc.connect_rpc.call.clientGuidance note changed.
guidancesignalspan.rpc.connect_rpc.call.serverGuidance note changed.
guidancesignalspan.rpc.grpc.call.clientGuidance note changed.
guidancesignalspan.rpc.grpc.call.serverGuidance note changed.
guidancesignalspan.rpc.jsonrpc.call.clientGuidance note changed.
guidancesignalspan.rpc.jsonrpc.call.serverGuidance note changed.
guidancemetricsystem.memory.sharedGuidance note changed.
guidanceattributeurl.fullGuidance note changed.
guidanceattributeurl.queryGuidance note changed.
wordingattributefeature_flag.evaluation.error.messageDeprecated, use feature_flag.error.message instead.
wordingattributemessage.compressed_sizeDeprecated, no replacement at this time.
wordingattributemessage.idDeprecated, no replacement at this time.
wordingattributemessage.typeDeprecated, no replacement at this time.
wordingattributemessage.uncompressed_sizeDeprecated, no replacement at this time.
wordingmetricrpc.client.call.durationMeasures the duration of an outgoing Remote Procedure Call (RPC).
wordingattributerpc.jsonrpc.error_messageDeprecated, use the span status description when reporting JSON-RPC spans.
wordingmetricrpc.server.call.durationMeasures the duration of an incoming Remote Procedure Call (RPC).