Semantic conventionsv1.34.0
since v1.33.01 breaking126 notable90 editorial
From the upstream release notes
- all: Convert deprecated text to structured format.
- feature_flag: Move the evaluated value from the event body to attributes
- process: Require sensitive data sanitization for process.command_args and process.command_line
- docs: Document system-specific naming conventions (#608, #1494, #1708)
- gen-ai: Add gen_ai.conversation.id attribute
- all: Renames all resource.* groups to be entity.*
- aws: Added new AWS attributes for various services including SQS, SNS, Bedrock, Step Functions, Secrets Manager and Kineses
- cloud: Broaden cloud.region definition to explicitly cover both resource location and targeted destination.
- network: Stabilize network.transport enum value quic.
- db: Fix the db.system.name attribute value for MySQL which was incorrectly pointing to microsoft.sql_server.
Breaking1
Changes to definitions the project had already marked stable or release candidate.
- deprecatedattributeexception.escapedIt's no longer recommended to record exceptions that are handled and do not escape the scope of a span.
Notable126
- renamedattributecode.columnRenamed to
code.column.number. - renamedattributecode.filepathRenamed to
code.file.path. - renamedattributecode.linenoRenamed to
code.line.number. - renamedattributecontainer.cpu.stateRenamed to
cpu.mode. - renamedattributecontainer.labelsRenamed to
container.label. - renamedattributedb.cassandra.consistency_levelRenamed to
cassandra.consistency.level. - renamedattributedb.cassandra.coordinator.dcRenamed to
cassandra.coordinator.dc. - renamedattributedb.cassandra.coordinator.idRenamed to
cassandra.coordinator.id. - renamedattributedb.cassandra.idempotenceRenamed to
cassandra.query.idempotent. - renamedattributedb.cassandra.page_sizeRenamed to
cassandra.page.size. - renamedattributedb.cassandra.speculative_execution_countRenamed to
cassandra.speculative_execution.count. - renamedattributedb.cassandra.tableRenamed to
db.collection.name. - renamedmetricdb.client.connections.idle.maxRenamed to
db.client.connection.idle.max. - renamedmetricdb.client.connections.idle.minRenamed to
db.client.connection.idle.min. - renamedmetricdb.client.connections.maxRenamed to
db.client.connection.max. - renamedmetricdb.client.connections.pending_requestsRenamed to
db.client.connection.pending_requests. - renamedattributedb.client.connections.pool.nameRenamed to
db.client.connection.pool.name. - renamedattributedb.client.connections.stateRenamed to
db.client.connection.state. - renamedmetricdb.client.connections.timeoutsRenamed to
db.client.connection.timeouts. - renamedmetricdb.client.connections.usageRenamed to
db.client.connection.count. - renamedmetricdb.client.cosmosdb.active_instance.countRenamed to
azure.cosmosdb.client.active_instance.count. - renamedmetricdb.client.cosmosdb.operation.request_chargeRenamed to
azure.cosmosdb.client.operation.request_charge. - renamedattributedb.cosmosdb.client_idRenamed to
azure.client.id. - renamedattributedb.cosmosdb.connection_modeRenamed to
azure.cosmosdb.connection.mode. - renamedattributedb.cosmosdb.consistency_levelRenamed to
azure.cosmosdb.consistency.level. - renamedattributedb.cosmosdb.containerRenamed to
db.collection.name. - renamedattributedb.cosmosdb.regions_contactedRenamed to
azure.cosmosdb.operation.contacted_regions. - renamedattributedb.cosmosdb.request_chargeRenamed to
azure.cosmosdb.operation.request_charge. - renamedattributedb.cosmosdb.request_content_lengthRenamed to
azure.cosmosdb.request.body.size. - renamedattributedb.cosmosdb.status_codeRenamed to
db.response.status_code. - renamedattributedb.cosmosdb.sub_status_codeRenamed to
azure.cosmosdb.response.sub_status_code. - renamedattributedb.elasticsearch.cluster.nameRenamed to
db.namespace. - renamedattributedb.elasticsearch.node.nameRenamed to
elasticsearch.node.name. - renamedattributedb.elasticsearch.path_partsRenamed to
db.operation.parameter. - renamedattributedb.mongodb.collectionRenamed to
db.collection.name. - renamedattributedb.nameRenamed to
db.namespace. - renamedattributedb.operationRenamed to
db.operation.name. - renamedattributedb.redis.database_indexRenamed to
db.namespace. - renamedattributedb.statementRenamed to
db.query.text. - renamedattributedb.systemRenamed to
db.system.name. - renamedattributedeployment.environmentRenamed to
deployment.environment.name. - renamedattributefeature_flag.evaluation.error.messageRenamed to
error.message. - renamedattributefeature_flag.evaluation.reasonRenamed to
feature_flag.result.reason. - renamedattributefeature_flag.provider_nameRenamed to
feature_flag.provider.name. - renamedattributefeature_flag.variantRenamed to
feature_flag.result.variant. - renamedattributegen_ai.openai.request.response_formatRenamed to
gen_ai.output.type. - renamedattributegen_ai.openai.request.seedRenamed to
gen_ai.request.seed. - renamedattributegen_ai.usage.completion_tokensRenamed to
gen_ai.usage.output_tokens. - renamedattributegen_ai.usage.prompt_tokensRenamed to
gen_ai.usage.input_tokens. - renamedattributehttp.client_ipRenamed to
client.address. - renamedattributehttp.flavorRenamed to
network.protocol.name. - renamedattributehttp.methodRenamed to
http.request.method. - renamedattributehttp.request_content_length_uncompressedRenamed to
http.request.body.size. - renamedattributehttp.response_content_length_uncompressedRenamed to
http.response.body.size. - renamedattributehttp.schemeRenamed to
url.scheme. - renamedattributehttp.server_nameRenamed to
server.address. - renamedattributehttp.status_codeRenamed to
http.response.status_code. - renamedattributehttp.urlRenamed to
url.full. - renamedattributehttp.user_agentRenamed to
user_agent.original. - renamedmetricjvm.buffer.memory.usageRenamed to
jvm.buffer.memory.used. - renamedattributek8s.pod.labelsRenamed to
k8s.pod.label. - renamedmetrick8s.replication_controller.available_podsRenamed to
k8s.replicationcontroller.available_pods. - renamedmetrick8s.replication_controller.desired_podsRenamed to
k8s.replicationcontroller.desired_pods. - renamedattributemessage.compressed_sizeRenamed to
rpc.message.compressed_size. - renamedattributemessage.idRenamed to
rpc.message.id. - renamedattributemessage.typeRenamed to
rpc.message.type. - renamedattributemessage.uncompressed_sizeRenamed to
rpc.message.uncompressed_size. - renamedattributemessaging.client_idRenamed to
messaging.client.id. - renamedmetricmessaging.client.published.messagesRenamed to
messaging.client.sent.messages. - renamedattributemessaging.eventhubs.consumer.groupRenamed to
messaging.consumer.group.name. - renamedattributemessaging.kafka.consumer.groupRenamed to
messaging.consumer.group.name. - renamedattributemessaging.kafka.destination.partitionRenamed to
messaging.destination.partition.id. - renamedattributemessaging.kafka.message.offsetRenamed to
messaging.kafka.offset. - renamedattributemessaging.operationRenamed to
messaging.operation.type. - renamedmetricmessaging.process.messagesRenamed to
messaging.client.consumed.messages. - renamedmetricmessaging.publish.durationRenamed to
messaging.client.operation.duration. - renamedmetricmessaging.publish.messagesRenamed to
messaging.client.sent.messages. - renamedmetricmessaging.receive.durationRenamed to
messaging.client.operation.duration. - renamedmetricmessaging.receive.messagesRenamed to
messaging.client.consumed.messages. - renamedattributemessaging.servicebus.destination.subscription_nameRenamed to
messaging.destination.subscription.name. - renamedattributenet.host.ipRenamed to
network.local.address. - renamedattributenet.host.nameRenamed to
server.address. - renamedattributenet.host.portRenamed to
server.port. - renamedattributenet.peer.ipRenamed to
network.peer.address. - renamedattributenet.protocol.nameRenamed to
network.protocol.name. - renamedattributenet.protocol.versionRenamed to
network.protocol.version. - renamedattributenet.sock.host.addrRenamed to
network.local.address. - renamedattributenet.sock.host.portRenamed to
network.local.port. - renamedattributenet.sock.peer.addrRenamed to
network.peer.address. - renamedattributenet.sock.peer.portRenamed to
network.peer.port. - renamedattributenet.transportRenamed to
network.transport. - renamedattributeotel.library.nameRenamed to
otel.scope.name. - renamedattributeotel.library.versionRenamed to
otel.scope.version. - renamedmetricotel.sdk.exporter.span.exported.countRenamed to
otel.sdk.exporter.span.exported. - renamedmetricotel.sdk.exporter.span.inflight.countRenamed to
otel.sdk.exporter.span.inflight. - renamedmetricotel.sdk.processor.span.processed.countRenamed to
otel.sdk.processor.span.processed. - renamedmetricotel.sdk.span.ended.countRenamed to
otel.sdk.span.ended. - renamedmetricotel.sdk.span.live.countRenamed to
otel.sdk.span.live. - renamedattributepool.nameRenamed to
db.client.connection.pool.name. - renamedattributeprocess.cpu.stateRenamed to
cpu.mode. - renamedattributeprocess.executable.build_id.profilingRenamed to
process.executable.build_id.htlhash. - renamedattributestateRenamed to
db.client.connection.state. - renamedmetricsystem.cpu.frequencyRenamed to
cpu.frequency. - renamedattributesystem.cpu.stateRenamed to
cpu.mode. - renamedmetricsystem.cpu.timeRenamed to
cpu.time. - renamedmetricsystem.cpu.utilizationRenamed to
cpu.utilization. - renamedattributesystem.network.stateRenamed to
network.connection.state. - renamedattributesystem.processes.statusRenamed to
system.process.status. - renamedattributetls.client.server_nameRenamed to
server.address. - renamedattributevcs.repository.change.idRenamed to
vcs.change.id. - renamedattributevcs.repository.change.titleRenamed to
vcs.change.title. - renamedattributevcs.repository.ref.nameRenamed to
vcs.ref.head.name. - renamedattributevcs.repository.ref.revisionRenamed to
vcs.ref.head.revision. - renamedattributevcs.repository.ref.typeRenamed to
vcs.ref.head.type. - deprecatedattributedb.cosmosdb.operation_typeRemoved, no replacement at this time.
- deprecatedattributedb.instance.idRemoved, no general replacement at this time. For Elasticsearch, use
db.elasticsearch.node.nameinstead. - deprecatedattributedb.jdbc.driver_classnameRemoved, no replacement at this time.
- deprecatedattributedb.mssql.instance_nameRemoved, no replacement at this time.
- deprecatedattributedb.userRemoved, no replacement at this time.
- deprecatedattributeenduser.scopeRemoved, no replacement at this time.
- deprecatedattributegen_ai.completionRemoved, no replacement at this time.
- deprecatedattributegen_ai.promptRemoved, no replacement at this time.
- deprecatedattributehttp.targetSplit to
url.pathandurl.query. - deprecatedattributemessaging.destination_publish.anonymousRemoved. No replacement at this time.
- deprecatedattributemessaging.destination_publish.nameRemoved. No replacement at this time.
- deprecatedattributenet.sock.peer.nameRemoved. No replacement at this time.
Editorial90
- stabilitymetrichw.host.heating_marginStability label respelled from experimental to development.
- stabilitymetrichw.host.powerStability label respelled from experimental to development.
- stabilitymetricsystem.cpu.frequencyStability label respelled from experimental to development.
- stabilityattributesystem.cpu.logical_numberStability label respelled from experimental to development.
- stabilitymetricsystem.cpu.timeStability label respelled from experimental to development.
- stabilitymetricsystem.cpu.utilizationStability label respelled from experimental to development.
- addedattributeaws.bedrock.guardrail.idThe unique identifier of the AWS Bedrock Guardrail. A guardrail helps safeguard and pre...
- addedattributeaws.bedrock.knowledge_base.idThe unique identifier of the AWS Bedrock Knowledge base. A knowledge base is a bank...
- addedattributeaws.kinesis.stream_nameThe name of the AWS Kinesis stream the request refers to. Corresponds to the `--stream-name...
- addedattributeaws.lambda.resource_mapping.idThe UUID of the AWS Lambda EvenSource Mapping. An...
- addedattributeaws.secretsmanager.secret.arnThe ARN of the Secret stored in the Secrets Mangger
- addedattributeaws.sns.topic.arnThe ARN of the AWS SNS Topic. An Amazon SNS topic is a logical access point that acts as a c...
- addedattributeaws.sqs.queue.urlThe URL of the AWS SQS Queue. It's a unique identifier for a queue in Amazon Simple Queue Service (SQS) and is used to access the queue and perform actions on ...
- addedattributeaws.step_functions.activity.arnThe ARN of the AWS Step Functions Activity.
- addedattributeaws.step_functions.state_machine.arnThe ARN of the AWS Step Functions State Machine.
- addedsignalentity.androidThe Android platform on which the Android application is running.
- addedsignalentity.appAn app used directly by end users — like mobile, web, or desktop.
- addedsignalentity.aws.ecsEntities used by AWS Elastic Container Service (ECS).
- addedsignalentity.aws.eksEntities used by AWS Elastic Kubernetes Service (EKS).
- addedsignalentity.aws.logEntities specific to Amazon Web Services.
- addedsignalentity.browserThe web browser in which the application represented by the resource is running. The
browser.*attributes MUST be used only for resources that represent appl... - addedsignalentity.cicd.pipelineA pipeline is a series of automated steps that helps software teams deliver code.
- addedsignalentity.cicd.pipeline.runA pipeline run is a singular execution of a given pipeline's tasks.
- addedsignalentity.cicd.workerA CICD worker is a component of the CICD system that performs work (eg. running pipeline tasks or performing sync).
- addedsignalentity.cloudA cloud environment (e.g. GCP, Azure, AWS)
- addedsignalentity.cloudfoundry.appThe application which is monitored.
- addedsignalentity.cloudfoundry.orgThe organization of the application which is monitored.
- addedsignalentity.cloudfoundry.processThe process of the application which is monitored.
- addedsignalentity.cloudfoundry.spaceThe space of the application which is monitored.
- addedsignalentity.cloudfoundry.systemThe system component which is monitored.
- addedsignalentity.containerA container instance.
- addedsignalentity.deploymentThe software deployment.
- addedsignalentity.deviceThe device on which the process represented by this resource is running.
- addedsignalentity.faasA serverless instance.
- addedsignalentity.gcp.apphub.applicationAttributes denoting data from an Application in AppHub. See AppHub overview.
- addedsignalentity.gcp.apphub.serviceAttributes denoting data from a Service in AppHub. See AppHub overview.
- addedsignalentity.gcp.apphub.workloadAttributes denoting data from a Workload in AppHub. See AppHub overview.
- addedsignalentity.gcp.cloud_runResource used by Google Cloud Run.
- addedsignalentity.gcp.gceResources used by Google Compute Engine (GCE).
- addedsignalentity.herokuHeroku dyno metadata
- addedsignalentity.hostA host is defined as a computing instance. For example, physical servers, virtual machines, switches or disk array.
- addedsignalentity.host.cpuA host's CPU information
- addedsignalentity.k8s.clusterA Kubernetes Cluster.
- addedsignalentity.k8s.containerA container in a PodTemplate.
- addedsignalentity.k8s.cronjobA Kubernetes CronJob object.
- addedsignalentity.k8s.daemonsetA Kubernetes DaemonSet object.
- addedsignalentity.k8s.deploymentA Kubernetes Deployment object.
- addedsignalentity.k8s.hpaA Kubernetes HorizontalPodAutoscaler object.
- addedsignalentity.k8s.jobA Kubernetes Job object.
- addedsignalentity.k8s.namespaceA Kubernetes Namespace.
- addedsignalentity.k8s.nodeA Kubernetes Node object.
- addedsignalentity.k8s.podA Kubernetes Pod object.
- addedsignalentity.k8s.replicasetA Kubernetes ReplicaSet object.
- addedsignalentity.k8s.replicationcontrollerA Kubernetes ReplicationController object.
- addedsignalentity.k8s.resourcequotaA Kubernetes ResourceQuota object.
- addedsignalentity.k8s.statefulsetA Kubernetes StatefulSet object.
- addedsignalentity.osThe operating system (OS) on which the process represented by this resource is running.
- addedsignalentity.otel.scopeAttributes used by non-OTLP exporters to represent OpenTelemetry Scope's concepts.
- addedsignalentity.processAn operating system process.
- addedsignalentity.process.runtimeThe single (language) runtime instance which is monitored.
- addedsignalentity.serviceA service instance.
- addedsignalentity.telemetry.distroThe distribution of telemetry SDK used to capture data recorded by the instrumentation libraries.
- addedsignalentity.telemetry.sdkThe telemetry SDK used to capture data recorded by the instrumentation libraries.
- addedsignalentity.vcs.refA reference to a specific version in the Version Control System.
- addedsignalentity.vcs.repoA repository in the Version Control System.
- addedsignalentity.webengineResource describing the packaged software running the application code. Web engines are typically executed using process.runtime.
- addedattributefeature_flag.result.valueThe evaluated value of the feature flag.
- addedattributegen_ai.conversation.idThe unique identifier for a conversation (session, thread), used to store and correlate messages within this conversation.
- addedattributegen_ai.data_source.idThe data source identifier.
- addedsignalspan.aws.bedrock.clientDescribes an AWS Bedrock operation span.
- guidanceattributeandroid.stateGuidance note changed.
- guidanceattributedevice.idGuidance note changed.
- guidancemetrick8s.replication_controller.available_podsGuidance note changed.
- guidancemetrick8s.replication_controller.desired_podsGuidance note changed.
- guidancesignalspan.cicd.pipeline.run.serverGuidance note changed.
- guidancesignalspan.db.mysql.clientGuidance note changed.
- guidancesignalspan.http.clientGuidance note changed.
- wordingattributecloud.regionThe geographical region within a cloud provider. When associated with a resource, this attribute specifies the region where the resource operates. When calling...
- wordingattributedb.sql.tableDeprecated, use
db.collection.nameinstead. - wordingattributehttp.request_content_lengthDeprecated, use
http.request.header.content-lengthinstead. - wordingattributehttp.response_content_lengthDeprecated, use
http.response.header.content-lengthinstead. - wordingattributeios.state
- wordingmetricmessaging.publish.messagesDeprecated. Use
messaging.client.sent.messagesinstead. - wordingattributeprocess.command_argsAll the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporti...
- wordingattributeprocess.command_lineThe full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of
GetCommandLineW. Do not... - examplesattributehttp.request.headerExamples changed.
- examplesattributehttp.response.headerExamples changed.
- examplesattributerpc.connect_rpc.request.metadataExamples changed.
- examplesattributerpc.connect_rpc.response.metadataExamples changed.
- examplesattributerpc.grpc.request.metadataExamples changed.