Semantic conventionsv1.33.0

2 May 2025since v1.32.0

2 breaking33 notable139 editorial

From the upstream release notes

db: Add db.query.parameter, replace relevant usages of db.operation.parameter
db: Make db.response.returned_rows opt-in on release_candidate spans
db: Use | as the separator when db.namespace is a concatenation of multiple components.
feature_flag: Rename feature_flag.provider_name to feature_flag.provider.name
feature_flag: Use generic error.message in feature flag evaluation event
gen-ai: Refine the values for gen_ai.system related to Google's AI endpoints.
k8s: Make k8s Node and Pod labels optional
otel: Rename span health metrics to remove the .count suffixes
db: Adding semantic conventions for oracledb instrumentations.
browser: Add browser web vitals event.

Read the full release notes

Breaking2

Changes to definitions the project had already marked stable or release candidate.

stabilityattributedb.operation.parameterStability lowered to development.
stabilityattributedb.systemStability lowered to development.

Notable33

removedsignalspan.db.mssql.clientRemoved from the registry (was development).
removedsignalspan.gen_ai.clientRemoved from the registry (was development).
removedsignalspan.gen_ai.openai.clientRemoved from the registry (was development).
deprecatedattributefeature_flag.evaluation.error.messageReplaced by error.message.
deprecatedattributefeature_flag.provider_nameReplaced by feature_flag.provider.name.
deprecatedmetricotel.sdk.exporter.span.exported.countRenamed to otel.sdk.exporter.span.exported.
deprecatedmetricotel.sdk.exporter.span.inflight.countRenamed to otel.sdk.exporter.span.inflight.
deprecatedmetricotel.sdk.processor.span.processed.countRenamed to otel.sdk.processor.span.processed.
deprecatedmetricotel.sdk.span.ended.countRenamed to otel.sdk.span.ended.
deprecatedmetricotel.sdk.span.live.countRenamed to otel.sdk.span.live.
instrumentmetricotel.sdk.exporter.span.exported.countInstrument changed from counter to updowncounter.
instrumentmetricotel.sdk.processor.span.processed.countInstrument changed from counter to updowncounter.
stabilityattributecode.column.numberPromoted to stable.
stabilityattributecode.file.pathPromoted to stable.
stabilityattributecode.function.namePromoted to stable.
stabilityattributecode.line.numberPromoted to stable.
stabilityattributecode.stacktracePromoted to stable.
stabilitymetricdb.client.operation.durationPromoted to stable.
stabilityattributedb.collection.namePromoted to stable.
stabilityattributedb.namespacePromoted to stable.
stabilityattributedb.operation.batch.sizePromoted to stable.
stabilityattributedb.operation.namePromoted to stable.
stabilityattributedb.query.summaryPromoted to stable.
stabilityattributedb.query.textPromoted to stable.
stabilityattributedb.response.status_codePromoted to stable.
stabilityattributedb.stored_procedure.namePromoted to stable.
stabilityattributedb.system.namePromoted to stable.
stabilitysignalspan.db.clientPromoted to stable.
stabilitysignalspan.db.mariadb.clientPromoted to stable.
stabilitysignalspan.db.mysql.clientPromoted to stable.
stabilitysignalspan.db.postgresql.clientPromoted to stable.
stabilitysignalspan.db.sql.clientPromoted to stable.
un-deprecatedattributedb.query.parameterNo longer marked deprecated.

Editorial139

enumattributegen_ai.operation.nameEnum members changed (5 to 7).
enumattributegen_ai.systemEnum members changed (14 to 17).
enumattributeotel.component.typeEnum members changed (10 to 14).
enumattributevcs.provider.nameEnum members changed (4 to 5).
addedattributeapp.screen.coordinate.xThe x (horizontal) coordinate of a screen coordinate, in screen pixels.
addedattributeapp.screen.coordinate.yThe y (vertical) component of a screen coordinate, in screen pixels.
addedattributeapp.widget.idAn identifier that uniquely differentiates this widget from other widgets in the same application.
addedattributeapp.widget.nameThe name of an application widget.
addedattributecicd.pipeline.action.nameThe kind of action a pipeline run is performing.
addedattributecicd.pipeline.task.run.resultThe result of a task run.
addedattributecicd.worker.idThe unique identifier of a worker within a CICD system.
addedattributecicd.worker.nameThe name of a worker within a CICD system.
addedattributecicd.worker.url.fullThe URL of the worker, providing the complete address in order to locate and identify the worker.
addedsignalevent.app.screen.clickThis event represents an instantaneous click on the screen of an application.
addedsignalevent.app.widget.clickThis event indicates that an application widget has been clicked.
addedsignalevent.browser.web_vitalThis event describes the website performance metrics introduced by Google, See web vitals.
addedattributefeature_flag.provider.nameIdentifies the feature flag provider.
addedattributegen_ai.tool.descriptionThe tool description.
addedmetricjvm.file_descriptor.countNumber of open file descriptors as reported by the JVM.
addedattributejvm.gc.causeName of the garbage collector cause.
addedattributek8s.cronjob.annotationThe cronjob annotation placed on the CronJob, the <key> being the annotation name, the value being the annotation value.
addedattributek8s.cronjob.labelThe label placed on the CronJob, the <key> being the label name, the value being the label value.
addedattributek8s.daemonset.annotationThe annotation key-value pairs placed on the DaemonSet.
addedattributek8s.daemonset.labelThe label key-value pairs placed on the DaemonSet.
addedattributek8s.deployment.annotationThe annotation key-value pairs placed on the Deployment.
addedattributek8s.deployment.labelThe label key-value pairs placed on the Deployment.
addedattributek8s.job.annotationThe annotation key-value pairs placed on the Job.
addedattributek8s.job.labelThe label key-value pairs placed on the Job.
addedattributek8s.namespace.annotationThe annotation key-value pairs placed on the Namespace.
addedattributek8s.namespace.labelThe label key-value pairs placed on the Namespace.
addedattributek8s.node.annotationThe annotation placed on the Node, the <key> being the annotation name, the value being the annotation value, even if the value is empty.
addedattributek8s.node.labelThe label placed on the Node, the <key> being the label name, the value being the label value, even if the value is empty.
addedattributek8s.replicaset.annotationThe annotation key-value pairs placed on the ReplicaSet.
addedattributek8s.replicaset.labelThe label key-value pairs placed on the ReplicaSet.
addedattributek8s.statefulset.annotationThe annotation key-value pairs placed on the StatefulSet.
addedattributek8s.statefulset.labelThe label key-value pairs placed on the StatefulSet.
addedmetricotel.sdk.exporter.metric_data_point.exportedThe number of metric data points for which the export has finished, either successful or failed
addedmetricotel.sdk.exporter.metric_data_point.inflightThe number of metric data points which were passed to the exporter, but that have not been exported yet (neither successful, nor failed)
addedmetricotel.sdk.exporter.operation.durationThe duration of exporting a batch of telemetry records.
addedmetricotel.sdk.exporter.span.exportedThe number of spans for which the export has finished, either successful or failed
addedmetricotel.sdk.exporter.span.inflightThe number of spans which were passed to the exporter, but that have not been exported yet (neither successful, nor failed)
addedmetricotel.sdk.metric_reader.collection.durationThe duration of the collect operation of the metric reader.
addedmetricotel.sdk.processor.span.processedThe number of spans for which the processing has finished, either successful or failed
addedmetricotel.sdk.span.endedThe number of created spans for which the end operation was called
addedmetricotel.sdk.span.liveThe number of created spans for which the end operation has not been called yet
addedattributeprocess.environment_variableProcess environment variables, <key> being the environment variable name, the value being the environment variable value.
addedsignalspan.aws.clientThis span describes an AWS SDK client call.
addedsignalspan.aws.s3.clientSemantic Conventions for AWS S3 client spans extend the general AWS SDK Semantic Conventions
addedsignalspan.cicd.pipeline.run.serverThis span describes a CICD pipeline run.
addedsignalspan.cicd.pipeline.task.internalThis span describes task execution in a pipeline run.
addedsignalspan.db.oracledb.clientSpans representing calls to a Oracle SQL Database adhere to the general Semantic Conventions for Database Client Spans.
addedsignalspan.db.sql_server.clientSpans representing calls to Microsoft SQL Server adhere to the general Semantic Conventions for Database Client Spans.
addedsignalspan.dynamodb.batchgetitem.clientThis span represents a DynamoDB.BatchGetItem call.
addedsignalspan.dynamodb.batchwriteitem.clientThis span represents a DynamoDB.BatchWriteItem call.
addedsignalspan.dynamodb.createtable.clientThis span represents a DynamoDB.CreateTable call.
addedsignalspan.dynamodb.deleteitem.clientThis span represents a DynamoDB.DeleteItem call.
addedsignalspan.dynamodb.deletetable.clientThis span represents a DynamoDB.DeleteTable call.
addedsignalspan.dynamodb.describetable.clientThis span represents a DynamoDB.DescribeTable call.
addedsignalspan.dynamodb.getitem.clientThis span represents a DynamoDB.GetItem call.
addedsignalspan.dynamodb.listtables.clientThis span represents a DynamoDB.ListTables call.
addedsignalspan.dynamodb.putitem.clientThis span represents a DynamoDB.PutItem call.
addedsignalspan.dynamodb.query.clientThis span represents a DynamoDB.Query call.
addedsignalspan.dynamodb.scan.clientThis span represents a DynamoDB.Scan call.
addedsignalspan.dynamodb.updateitem.clientThis span represents a DynamoDB.UpdateItem call.
addedsignalspan.dynamodb.updatetable.clientThis span represents a DynamoDB.UpdateTable call.
addedsignalspan.gen_ai.embeddings.clientDescribes GenAI embeddings span - a request to a Generative AI model or service that generates an embeddings based on the input. The gen_ai.operation.name SH...
addedsignalspan.gen_ai.inference.clientThis span represents a client call to Generative AI model or service that generates a response or requests a tool call based on the input prompt.
addedsignalspan.gen_ai.invoke_agent.clientDescribes GenAI agent invocation and is usually applicable when working with remote agent services.
addedsignalspan.gen_ai.openai.inference.clientSemantic Conventions for OpenAI client spans extend and override the semantic conventions for Gen AI Spans.
guidanceattributecontainer.labelGuidance note changed.
guidanceattributedb.collection.nameGuidance note changed.
guidanceattributedb.namespaceGuidance note changed.
guidanceattributedb.operation.nameGuidance note changed.
guidanceattributedb.operation.parameterGuidance note changed.
guidanceattributedb.query.parameterGuidance note changed.
guidanceattributedb.query.summaryGuidance note changed.
guidanceattributedb.query.textGuidance note changed.
guidanceattributehttp.request.headerGuidance note changed.
guidanceattributehttp.response.headerGuidance note changed.
guidanceattributek8s.pod.annotationGuidance note changed.
guidanceattributek8s.pod.labelGuidance note changed.
guidancemetricotel.sdk.exporter.log.exportedGuidance note changed.
guidancemetricotel.sdk.exporter.log.inflightGuidance note changed.
guidancemetricotel.sdk.exporter.span.exported.countGuidance note changed.
guidancemetricotel.sdk.exporter.span.inflight.countGuidance note changed.
guidancemetricotel.sdk.processor.log.processedGuidance note changed.
guidancemetricotel.sdk.processor.span.processed.countGuidance note changed.
guidancemetricotel.sdk.span.ended.countGuidance note changed.
guidancemetricotel.sdk.span.live.countGuidance note changed.
guidanceattributerpc.connect_rpc.request.metadataGuidance note changed.
guidanceattributerpc.connect_rpc.response.metadataGuidance note changed.
guidanceattributerpc.grpc.request.metadataGuidance note changed.
guidanceattributerpc.grpc.response.metadataGuidance note changed.
guidancesignalspan.aws.lambda.serverGuidance note changed.
guidancesignalspan.azure.cosmosdb.clientGuidance note changed.
guidancesignalspan.cli.clientGuidance note changed.
guidancesignalspan.cli.internalGuidance note changed.
guidancesignalspan.db.cassandra.clientGuidance note changed.
guidancesignalspan.db.clientGuidance note changed.
guidancesignalspan.db.couchdb.clientGuidance note changed.
guidancesignalspan.db.elasticsearch.clientGuidance note changed.
guidancesignalspan.db.hbase.clientGuidance note changed.
guidancesignalspan.db.mariadb.clientGuidance note changed.
guidancesignalspan.db.mongodb.clientGuidance note changed.
guidancesignalspan.db.mysql.clientGuidance note changed.
guidancesignalspan.db.postgresql.clientGuidance note changed.
guidancesignalspan.db.redis.clientGuidance note changed.
guidancesignalspan.db.sql.clientGuidance note changed.
guidancesignalspan.faas.clientGuidance note changed.
guidancesignalspan.gen_ai.az.ai.inference.clientGuidance note changed.
guidancesignalspan.gen_ai.create_agent.clientGuidance note changed.
guidancesignalspan.gen_ai.execute_tool.internalGuidance note changed.
guidancesignalspan.http.clientGuidance note changed.
guidancesignalspan.http.serverGuidance note changed.
guidancesignalspan.rpc.clientGuidance note changed.
guidancesignalspan.rpc.serverGuidance note changed.
wordingattributecode.column.numberThe column number in code.file.path best representing the operation. It SHOULD point within the code unit named in code.function.name. This attribute MUST ...
wordingattributecode.file.pathThe source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). This attribute MUST NOT be used on the Prof...
wordingattributecode.function.nameThe method or function fully-qualified name without arguments. The value should fit the natural representation of the language runtime, which is also likely th...
wordingattributecode.line.numberThe line number in code.file.path best representing the operation. It SHOULD point within the code unit named in code.function.name. This attribute MUST NO...
wordingattributecode.stacktraceA stacktrace as a string in the natural representation for the language runtime. The representation is identical to [exception.stacktrace](/docs/exceptions/e...
wordingattributefeature_flag.evaluation.error.messageDeprecated, use error.message instead.
wordingattributefeature_flag.provider_nameDeprecated, use feature_flag.provider.name instead.
wordingsignalspan.faas.datasource.serverThis span represents server side if the FaaS invocations triggered in response response to some data source operation such as a database or filesystem read/wri...
wordingsignalspan.faas.serverThis span represents server (incoming) side of the FaaS invocation.
wordingsignalspan.faas.timer.serverThis span represents server side if the FaaS invocations triggered by a timer.
examplesattributecontainer.labelExamples changed.
examplesattributecontainer.labelsExamples changed.
examplesattributedb.elasticsearch.path_partsExamples changed.
examplesattributehttp.request.headerExamples changed.
examplesattributehttp.response.headerExamples changed.
examplesattributek8s.pod.annotationExamples changed.
examplesattributek8s.pod.labelExamples changed.
examplesattributek8s.pod.labelsExamples changed.
examplesattributerpc.connect_rpc.request.metadataExamples changed.
examplesattributerpc.connect_rpc.response.metadataExamples changed.
examplesattributerpc.grpc.request.metadataExamples changed.
examplesattributerpc.grpc.response.metadataExamples changed.
examplesattributevcs.provider.nameExamples changed.